Step 15 · End-to-end · End-to-end · CLI commands and end-to-end flows ENPT
Alembic Complete Visual Course

CLI commands and end-to-end flows

Putting all the packages together through the human-facing command surface.

Read the plain version, or open the technical layer on any section.
1

The command surface

The alembic CLI groups commands by purpose:

  • Plan & scope: plan, forge
  • Data: ingest, distill, marketing
  • Execute: run, runs, propose, approve, reject, replay
  • Observe: status, serve, cockpit, tui, tail, doctor
  • Publish: docs, Forge publish gate

Most commands accept --offline, --data-dir, and --json.

Think of it like… the control panel of a factory: every button maps to a subsystem, but the same underlying machinery runs them all.

Under the hood

apps/cli wires every package. runDistill uses @alembic/harness and @alembic/etl. runIngest uses @alembic/ingestion. runGoalPlan uses @alembic/forge, @alembic/vm, @alembic/swarm, @alembic/coda, and @alembic/loop-engineering. Commands return typed Result objects and render text or JSON.

2

In one picture

alembic CLI plan, forge docs, doctor distill, ingest marketing run, runs propose, approve, reject, replay serve, cockpit, tui, tail status
CLI commands grouped by purpose: plan, data, execute, observe, publish.
3

In the code

# full offline cycle
alembic doctor
alembic plan "Add a /health endpoint"
alembic forge "Add a /health endpoint" --offline
alembic run --goal GOAL.md --plan alembic.plan.ts --yes --offline
alembic docs ./docs ./site

Implementation notes

The CLI uses Node's util.parseArgs and Zod for argument parsing. It expands ~ to $HOME, respects ALEMBIC_OFFLINE, and returns non-zero exit codes on failure. Every command is tested against the offline registry so the test suite stays hermetic.

4

Try it

Pick a small task and run the full offline cycle: doctor → plan → forge → run. Verify that the run directory contains all expected artifacts.

Map: Which CLI command exercises the most packages in one invocation?
5

Quick check

Which flag forces hermetic offline execution?