CLI Reference

All commands are deterministic. Validation uses embedded schemas.

Quick Reference

Command	Purpose	Modifies State
`explore`	Search codebase, symbols, call graphs	No
`store`	Store idea/decision/learning	Yes
`recall`	Search and retrieve knowledge	No
`brief`	Get file briefing and intelligence	No
`init`	Initialize .palace/ structure	Yes
`scan`	Build/refresh Index	Yes
`check`	Verify freshness and CI	No
`serve`	Start MCP server	No
`session`	Manage agent sessions	Yes
`corridor`	Cross-workspace sharing	Varies
`dashboard`	Start web dashboard	No
`clean`	Cleanup stale data	Yes
`update`	Self-update to latest	Yes
`version`	Show version info	No

Core Commands

explore

Search the codebase, symbols, and call graphs.


palace explore "<query>" [options]
palace explore --map <symbol> [options]
palace explore --rooms

Options:

Flag	Description
`--room <name>`	Filter to specific room
`--rooms`	List all configured rooms
`--limit <n>`	Maximum results (default: 10)
`--fuzzy`	Enable fuzzy matching
`--full`	Get full context (generates `context-pack.json`)
`--map <symbol>`	Trace call graph for a symbol or file
`--file <path>`	File path for `--map` mode
`--depth <n>`	Recursion depth for call chain (1-10)
`--direction <d>`	Trace direction: `up`, `down`, or `both`

store

Store ideas, decisions, and learnings (auto-classified).


palace store "<content>" [options]

Options:

Flag	Description
`--as <type>`	Force type: `decision`, `idea`, `learning`
`--scope <scope>`	Scope: `file`, `room`, `palace` (default: `palace`)
`--path <path>`	Scope path for file/room scope
`--direct`	Bypass proposals workflow (human-only, creates approved records directly)

recall

Search and retrieve knowledge.


palace recall [query] [options]

Options:

Flag	Description
`--type <type>`	Filter by type: `decision`, `idea`, `learning`
`--pending`	Show decisions awaiting outcome

Subcommands:

update <id> <outcome>: Record decision outcome (success, failed, mixed)
link --<rel> <target> <source>: Create relationships between records (flags before source ID)

brief

Get file briefing and intelligence.


palace brief <file-path> [options]

Options:

Flag	Description
`--sessions`	Include recent agent activity details

Setup & Indexing

init

Initialize the palace in the current directory.


palace init [options]

Options:

Flag	Description
`--detect`	Auto-detect project type and generate rooms
`--with-outputs`	Also create generated output templates
`--force`	Overwrite existing curated files

scan

Build or refresh the Index (Tier-0).


palace scan [options]

Options:

Flag	Description
`--full`	Force full rescan (default: incremental)
`--deep`	Enable LSP-based deep analysis

Parses files using Tree-sitter and stores symbols in SQLite. For Dart/Flutter projects, deep analysis runs automatically to extract accurate call relationships via LSP.

check

Verify Index freshness and validate schemas.


palace check [options]

Options:

Flag	Description
`--strict`	Hash all files (slower but thorough)
`--diff <range>`	Scope check to a specific git diff range
`--collect`	Also generate context pack from diff
`--signal`	Also generate change signal from diff

Maintenance

clean

Cleanup stale sessions, agents, and old learnings.


palace clean [--dry-run]