"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/
Preview Mechanism Progress
Last updated: 2026-04-23 UTC
This document records the current state of the cross-harness preview mechanism work on the dedicated preview branch.
Workspace
- Repo:
/root/CLI-Anything-preview - Branch:
feat/preview-protocol - Current checkpoint commit:
81dbe58
This checkpoint contains the first end-to-end version of the preview stack, including live preview sessions, bundle protocol, generic viewing tools, and FreeCAD motion-backed showcase rendering.
Mechanism Summary
The current mechanism is built as five layers:
Preview Bundle- A stable on-disk contract for preview outputs.
- Defined in
docs/PREVIEW_PROTOCOL.md. - Implemented by
cli-anything-plugin/preview_bundle.pyand vendored harness helpers.
Harness Preview Commands- Normalized command surface:
preview recipespreview capturepreview latestpreview diffwhere relevant
- Each harness is responsible for generating truthful preview artifacts with the real backend, not by screen scraping.
- Normalized command surface:
Live Session- A long-lived directory that tracks:
- mutable
session.json - append-only
trajectory.json - current bundle head
- mutable
- Supports both:
- explicit push
- poll-first automatic refresh based on source-state fingerprints
- A long-lived directory that tracks:
Generic Viewer- Implemented in
cli-hub. - Supports:
cli-hub previews inspectcli-hub previews htmlcli-hub previews watchcli-hub previews open
- Lets agents and humans consume the same preview state through different surfaces.
- Implemented in
Final Motion Showcase- Separate from preview.
- Used for end-of-work demonstrations where static preview is not enough.
- Currently implemented for FreeCAD via real frame-by-frame motion renders.
What Is Implemented
Protocol / Platform
docs/PREVIEW_PROTOCOL.mdcli-anything-plugin/preview_bundle.pycli-anything-plugin/HARNESS.mdpreview requirementscli-hub/cli_hub/preview.pycli-hubpreviews CLI integration
Harnesses with preview support
shotcut- quick preview capture
- live session
- poll-mode auto refresh
- black-preview regression fixed
openscreen- quick preview capture
- bundle emission
- append-only
trajectory.jsonbeside stable preview roots
blender- preview capture
- live session
- poll-mode auto refresh
preview live status --jsonreturnstrajectory_summary- real Gyro Observatory demo script with stage-by-stage preview checkpoints
freecad- quick preview capture
- live session
- poll-mode auto refresh
preview live status --jsonreturnstrajectory_summary- richer preview/export macro reconstruction
- motion CLI for true frame rendering
renderdoc- preview capture
- preview diff
- replay-oriented bundle generation
- append-only
trajectory.jsonfor capture/diff history
Canonical Command Split
Use this wording consistently:
- software harnesses publish previews through
cli-anything-<software> preview ... cli-hub previews ...only inspects, renders, opens, or watches existing bundles and live sessions
There are no cli-hub preview, cli-hub review, or cli-hub open-preview
aliases in the current command surface.
FreeCAD-Specific Preview Mechanism Progress
FreeCAD is currently the deepest preview integration on this branch.
Implemented:
- preview capture and live preview
- poll-first live refresh
part boundspart align- better preview/export macro reconstruction for:
- additive/subtractive primitives
- pattern features
- mirrored parts
- motion CLI surface:
motion newmotion listmotion getmotion deletemotion keyframemotion samplemotion render-framesmotion render-video
This makes FreeCAD the main proof point for the full mechanism:
- real CLI trajectory
- real preview bundles
- real live session updates
- real final motion render
- programmatic split-screen video composition
Video / Showcase State
Current reference artifacts are recorded in:
docs/FREECAD_VIDEO_REFERENCE.md
Important completed pieces:
- split-screen agent-manipulation visualization video
- redesigned left-side
Agent Command Stream - true FreeCAD motion endings
- drive
- turntable spin
- combo: one full rotation, then forward travel
Known Gaps
The mechanism is working, but it is not feature-complete.
Current limits:
- live preview is near-real-time, not continuous viewport streaming
- some harnesses are only first-pass preview integrations
- FreeCAD motion is currently part-placement driven, not Assembly-joint driven
- RenderDoc preview is limited by machine graphics/runtime constraints when generating fresh captures locally
- Blender now has live preview parity at the protocol/session level, but its showcase/demo tooling is still shallower than FreeCAD's motion/video stack
Recommended Next Work
- Expand Blender demo tooling beyond the first Gyro Observatory proof point.
- Restack this preview branch onto a clean
origin/mainbase before the PR stack grows larger. - Split this large checkpoint into a reviewable commit stack later:
- protocol + cli-hub
- shotcut / openscreen
- blender
- freecad
- renderdoc
- demo/video tooling
Related Docs
docs/PREVIEW_PROTOCOL.mddocs/PREVIEW_PROGRESS.mddocs/FREECAD_VIDEO_REFERENCE.mddocs/FREECAD_DEMO_PROPOSALS.md