memory-viewers

memory-viewers is the top-level repository for the user-facing viewer tools and the nested toolchain they depend on.

Direct child READMEs:

• memory-api/README.md for the rule, spec, ticket, and audit automation surfaces.
• viewer-api/README.md for viewer-ctl, the shared viewer runtime, and the frontend scaffold.

Installable content in or directly behind this repository includes the spec-viewer and ticket-viewer binaries plus the viewer-ctl, rule, spec, ticket, and audit command surfaces documented in those child READMEs.

Tool Surface

Tool	What it exposes	Direct docs
ticket‑viewer	Ticket board and graph views	memory-api/README.md for the ticket backends and viewer-api/README.md for the shared viewer runtime.
spec‑viewer	Spec browsing UI	memory-api/README.md for the spec backends and viewer-api/README.md for the shared viewer runtime.
memory‑api	CLI, MCP, HTTP, and VS Code tooling	memory-api/README.md
viewer‑api	Shared viewer-facing APIs	viewer-api/README.md

Tool Screenshots

Dependency Graph

flowchart LR
    User((User)) --> TicketViewer[ticket-viewer]
    User --> SpecViewer[spec-viewer]
    TicketViewer --> TicketTools[memory-api ticket surfaces]
    SpecViewer --> SpecTools[memory-api spec surfaces]
    TicketTools --> ViewerAPI[viewer-api]
    SpecTools --> ViewerAPI
    Docs[generated README targets] --> MemoryTools[memory-api rule surfaces]

Loading

Tool Use Examples

Install the shared tools first

From the parent context-engine checkout, install the viewer lifecycle tooling and authoring CLIs in one step:

bash ./install-tools.sh

That installs viewer-ctl, trunk, spec-viewer, ticket-viewer, and the rule, spec, ticket, and audit CLIs onto Cargo's bin path. If you are working from a standalone memory-viewers checkout, follow the direct install commands in memory-api/README.md and viewer-api/README.md.

Start the viewers and regenerate docs

viewer-ctl start ticket-viewer
viewer-ctl start spec-viewer
rule sync-targets --config memory-viewers/rule-targets.yaml

• viewer-ctl start ... follows the lifecycle workflow documented in viewer-api/viewer-ctl/README.md.
• rule sync-targets --config memory-viewers/rule-targets.yaml is documented in memory-api/tools/cli/rule-cli/README.md.
• Continue from memory-api/README.md for rule, spec, ticket, and audit command surfaces and from viewer-api/README.md for shared viewer runtime details.