Skip to content

CLI commands

The seal binary is the single entry point for everything user-facing. Subcommands are stable; the bare-name form (seal or seal "prompt") opens the interactive TUI.

CommandWhat it does
sealOpen the interactive TUI in the current project.
seal "prompt text"One-shot mode — runs the agent against the prompt and exits with the final response.
seal --resumeResume the most recent session in the current project. With ambiguity, opens a picker.
seal --resume <session-id>Resume the named session directly.
seal --always-approveBypass the per-session manifest-approval prompt at startup. Convenient on a project whose seal.toml you’ve already trust-on-first-use’d.
CommandWhat it does
seal embarkFirst-run wizard: provider, credential, optionally a starter seal.toml. See Install.
seal initScaffold seal.toml only — for projects whose credentials are already configured.
seal signShow the current grant diff and re-sign seal.toml. Interactive Y/N by default; -y / --always-approve skips the prompt for scripts.
CommandWhat it does
seal sessionsList recent sessions in the current project — id, started-at, last message snippet.

The daemon (seal-daemon) auto-starts the first time seal runs and stays alive between sessions. You only need these when something’s wrong:

CommandWhat it does
seal startForce-start the daemon. Kills any existing daemon first.
seal stopStop the daemon. Equivalent to seal daemon stop.
seal daemon statusPrint the daemon pid, build info, and active-turn count. Exits non-zero if no daemon is running.
seal daemon stop [--force]Graceful shutdown via the tryShutdown RPC. Refuses if a peer is mid-turn unless --force is set.
seal daemon restart [--force]stop + start, picking up the latest seal-daemon binary on disk.
CommandWhat it does
seal raftMulti-agent session manager — spawn / supervise / inspect multiple parallel agents from one TUI.
seal dashboardLive daemon dashboard: active turns, grants exercised, sandbox denials. --demo populates with synthetic data; --graph opens directly in graph view.