Skip to main content

Commands

phonton                 Launch the interactive TUI
phonton goal <goal>     Run a noninteractive goal through plan/edit/verify/review
phonton ask <question>  One-shot Q&A using the configured provider
phonton doctor          Check config, store, trust, git, cargo, provider, and index backend
phonton plan <goal>     Preview the task DAG without changing files
phonton review          Show verified diff review payloads
phonton memory          Inspect and manage local decision memory
phonton extensions      Inspect skills, steering, MCP servers, and profiles
phonton mcp             Inspect or call configured MCP servers with approval gates
phonton config path     Print the resolved config file path
phonton config show     Dump resolved config as TOML
phonton version         Print version

Plan preview​

phonton plan --json "add rate limiting to auth"

The JSON preview includes the executable subtask DAG plus v0.19.0 evidence:

plan_graph
swarm_mode
swarm_reason
assignments
conflict_groups
index_backend

Use --no-memory when you want a plan that ignores stored decision memory:

phonton plan --no-memory "add rate limiting to auth"

MCP capability preview​

List configured servers:

phonton mcp list

Preview negotiated tools and proposed permission rules:

phonton mcp capabilities github --yes
phonton mcp capabilities github --json --yes

Capability preview captures initialize metadata and tools/list descriptors. It does not call tools and does not write or grant permissions silently.

Actual tool inspection or calls remain approval-gated:

phonton mcp tools github --yes
phonton mcp call github search_repositories '{"query":"phonton"}' --yes

Extensions​

Current extension commands are inspection commands:

phonton extensions list
phonton extensions doctor
phonton extensions skills --json
phonton extensions steering --json
phonton extensions mcp --json
phonton extensions profiles --json

Extension records live under .phonton in the user or workspace scope. They are local files a developer can inspect before enabling trust or using MCP tools.

Review​

phonton review latest
phonton review latest --json

Record the decision explicitly:

phonton review approve latest
phonton review reject latest
phonton review rollback latest 1

Memory​

Memory commands are for local decision notes that should influence later planning and review.

phonton memory list
phonton memory pin <memory-id>
phonton memory edit <memory-id> "Prefer cargo test --locked --workspace before review"
phonton memory delete <memory-id>
phonton memory unpin <memory-id>

Keep memory short and operational. Good entries explain repo-specific constraints, preferred test commands, or decisions that should survive across tasks.