Skip to content

Command Reference

Jump to bottom
Matt Lucas edited this page Jun 24, 2026 · 1 revision

Command Reference

Complete reference for all lantern subcommands.

Service Management

lantern up

Start all background services (Relay daemon and optional Temporal dev server).

lantern up

Run once per session; launchd service starts it automatically on login.

lantern down

Stop all background services.

lantern down

lantern restart

Restart all services. Useful after installing a new binary.

lantern restart

lantern doctor

Health check all dependencies and services.

lantern doctor

Verifies Rust, Temporal CLI, git, iTerm2, agent CLIs, and service status.

Squad Management

lantern startwork [project] [slot] [--agent AGENT] [--no-init]

Launch a new squad workspace.

Arguments:

  • project — project name (optional; defaults to repo name)
  • slot — numeric slot (optional; auto-allocated if omitted)
  • --agent — agent CLI: claude (default), codex, kimi, gemini, agy, goose
  • --no-init — skip initialization prompts

Examples:

lantern startwork myproject              # Default squad
lantern startwork myproject 1            # Named slot
lantern startwork myproject --agent goose  # Solo goose
lantern startwork myproject 2 --agent codex  # Different agent

See Agent Modes for detailed mode descriptions.

lantern status

Show state of all active squads and agents.

lantern status

lantern stopwork <session> [--preserve-worktrees] [--all]

Tear down a squad workspace.

Arguments:

  • session — session ID (e.g., myproject-1)
  • --all — stop all active sessions
  • --preserve-worktrees — keep git worktrees; only close panes

Examples:

lantern stopwork myproject-1
lantern stopwork --all
lantern stopwork myproject-1 --preserve-worktrees

Pane Control

lantern pause <session>-<role>

Pause an agent (suspend without killing the pane).

lantern pause myproject-1-ai

lantern resume <session>-<role>

Resume a paused agent.

lantern resume myproject-1-ai

lantern takeover <session>-<role>

Take human control of an agent pane.

lantern takeover myproject-1-ui

Now you can type directly in the pane.

lantern release <session>-<role>

Release human control; let the agent resume.

lantern release myproject-1-ui

lantern recover <session>-<role>

Force recovery of a stuck or crashed agent.

lantern recover myproject-1-ai

lantern note <session>-<role> <message>

Inject a note into an agent pane.

lantern note myproject-1-ai "Check line 42 in src/main.rs"

Logging

lantern logs <service>

Tail logs for a service.

Services:

  • relay — Lantern Relay daemon logs
  • temporal — Temporal dev server logs

Examples:

lantern logs relay
lantern logs temporal

Developer

lantern mcp

Start the Lantern MCP stdio server (for agent CLI integration).

lantern mcp

Normally spawned by agent CLIs; you rarely run this manually.

lantern acp-run

Run a headless Goose/ACP worker for a one-shot task.

lantern acp-run --agent claude --prompt "Fix the bug in foo.rs"

Help

lantern --help

Show all available commands.

lantern <command> --help

Show help for a specific command.

lantern startwork --help

Clone this wiki locally