Observe and verify Alembic runs and environment without leaving the terminal or browser.
@alembic/web serves a self-contained dashboard that lists runs, streams events.jsonl via SSE, and lets you approve parked T4 tasks. @alembic/tui draws the same information as ASCII swimlanes in the terminal.
alembic doctor probes the local environment: Node, pnpm, git, Higgsfield CLI, data directory, and the LLM gateway. It reports OK / WARN / FAIL for each check.
Think of it like… the flight deck of an airplane: instruments tell you speed, altitude, and warnings; you decide whether to continue.
The web cockpit polls append-only JSONL files and uses server-sent events for live updates. The TUI uses pure render functions so it is testable without a terminal. doctor uses which and version commands for binaries, fs.access for the data directory, and an HTTP probe for the gateway.
# check environment alembic doctor --json # watch a run in the terminal alembic tui <run-id> # stream recent events alembic tail <run-id> --follow
alembic tail reads events.jsonl and prints swimlane-formatted lines. With --follow it polls every 500 ms. The TUI uses raw terminal mode so single keystrokes like q exit immediately.
Run a short Forge-scope command, then run alembic tui <run-id> and alembic tail <run-id> in separate terminals.