Skip to main content
ComponentsVisualization

Component · Visualization

Checkpoint Timeline

Rewindable session history — browse/preview (draft preserved), restore/rewind with safe confirm and boundary warnings.

Kind
widget
Input
interactive
Canvas
120×40

Live preview

Loading terminal preview.

Static terminal poster. Choose Run live to start the Rust demo.

Ghosttycheckpoint-timeline/basic
Loading terminal poster…
○ loading posterNo input — rendered state only
Checkpoint Timeline · exact mounted Rust story

01 · Purpose

What it is for

Rewindable session history — browse/preview (draft preserved), restore/rewind with safe confirm and boundary warnings.

Best fit: Visualization · visualization · widget

02 · Behavior

What the mounted story proves

  1. 01

    CheckpointTimeline

    Representative 120×40 terminal state.

  2. 02

    Passive paint

    No keyboard or pointer action is claimed by this representative story.

  3. 03

    Evidence stays explicit

    0 covered · 9 partial · 5 missing axes.

03 · Implement

Install, then start from exact code

Install

cargo add termrock --git https://github.com/tailrocks/termrock.git --rev 5283c2acf9154d0cfcd37b1ffe821c00faf90ea2

Add TermRock once. Keep domain effects in the host application.

Minimal implementation

Exact Rust setup used by checkpoint-timeline/basic.

Open to load code.

04 · Adapt

Variants and composition

Variants

Use the preview Variant menu when alternate registered stories exist. Each selection mounts a fresh configuration.

Composition

Visualization · visualization · widget

05 · Reference

API, tokens, accessibility

API

CheckpointTimelineOpen source ↗

Tokens

DesignSystemInspect exact story code for roles and capability projection.

Accessibility

Input contract mountedNo input claim in the representative story.

Contract

Evidence in progress0/23 axes covered

06 · Go deeper

Advanced guidance

Authored implementation guidance

Session checkpoint browser. Outcomes are requests only; host owns persistence and restore I/O. Never clears PromptComposer draft.

When to use / when not

Use CheckpointTimelinePrefer
Agent session restore / rewind—
General deploy/CI chronologyTimeline
Field value historyHistoryPicker (if present)
Patch compareDiffReview via CompareRequested

Modes

ModeMutates session?
BrowseNo
PreviewNo (draft preserved)
ConfirmRequest only — host executes

Confirm defaults focus to Cancel.

Boundaries

Soft · Dirty workspace · External effects · Irreversible (blocked)

Keys

j/k · Enter preview · r restore · w rewind · c compare · Esc · confirm ←/→ Enter

Ownership boundary

TermRock owns reusable terminal rendering and interaction state. The host owns domain data, policy, persistence, authorization, and side effects.

Evidence status

0 covered, 9 partial, and 5 missing contract axes. Missing evidence is not a behavior claim.