Commands

Phantasm CLI reference

phantasm --help
phantasm --version
phantasm bootstrap [project-path] [--agent-guidance] [--agent-file <path>]
phantasm agents --add [project-path] [--agent-file <path>]
phantasm handle-request '<json request envelope>'

phantasm --help prints a command index. Use phantasm agents --help or phantasm help agents for command-specific options.

Common command

phantasm bootstrap is the standard setup command for a project.

phantasm bootstrap
phantasm bootstrap .
phantasm bootstrap /path/to/project

Agent guidance options

phantasm bootstrap --agent-guidance
phantasm bootstrap --agent-file AGENTS.md
phantasm bootstrap --agent-file AGENTS.md --agent-file CLAUDE.md
phantasm agents --add
phantasm agents --add --agent-file AGENTS.md --agent-file CLAUDE.md

Use agents --add to add or refresh guidance without bootstrapping again. Before Phantasm changes an existing agent file, it creates a timestamped sibling backup. It also prompts for confirmation with a y/N question.

Full MVP runtime operations

The current handle-request surface includes: bootstrap, ingest, revise, tombstone, archive, promote, resolve_conflict, accept_suggestion, reject_suggestion, defer_review, resolve_review, search, compile, inspect, audit, review_queue, health, snapshot_export, snapshot_import, backup_list, backup_restore, maintenance_plan, and maintenance_run.

Advanced runtime command

handle-request runs one JSON request against the current project runtime.

phantasm handle-request '{"api_version":"v1","operation":"health","request_id":"health-1","client":{"profile":"codex"},"params":{}}'

Configuration files after bootstrap

For the current post-bootstrap config surface, including every key in phantasm.toml and clients.toml, see configuration.html.

More detail

For the repository docs version of this reference, see docs/commands-and-usage.md.