@tekmidian/pai 0.42.5 → 0.43.0

package/docs/commands/README.md

@@ -8,14 +8,17 @@ Generated man pages for every `pai` command area. Read any page in the terminal
 
 | Area | Description |
 |------|-------------|
-| [`pai backup`](backup.md) | Backup registry, config, and Postgres database to ~/.pai/backups/ |
+| [`pai audit`](audit.md) | Diagnostic audits: token-waste report and friends |
+| [`pai backup`](backup.md) | Backup registry, config, and Postgres database to PAI_HOME/backups/ |
 | [`pai clear-names`](clear-names.md) | Recovery: wipe corrupted iTerm2 session name state. |
+| [`pai config`](config.md) | PAI_HOME namespace dir: path, migrate |
 | [`pai daemon`](daemon.md) | PAI daemon management: serve, status, restart, install, uninstall, logs |
 | [`pai db`](db.md) | Database inspection: query, tables, schema (sqlite or postgres) |
 | [`pai end`](end.md) | Finalize a session: save state, mark note Completed, display safe-exit instructions. |
 | [`pai help`](help.md) | Show the man page for a command area (pai help <area>), or list all areas |
 | [`pai identity`](identity.md) | Declare who you are: self addresses and where mail is delivered |
 | [`pai kg`](kg.md) | Temporal knowledge graph: backfill, query, list, stats |
+| [`pai launch`](launch.md) | Start the Claude Code harness on any provider/model from workers.yaml. |
 | [`pai mcp`](mcp.md) | MCP server management: install and status |
 | [`pai memory`](memory.md) | Memory engine: index, search, and status |
 | [`pai notify`](notify.md) | Notification config: status, get, set, test, send |
@@ -41,8 +44,22 @@ Generated man pages for every `pai` command area. Read any page in the terminal
 
 | Command | Description |
 |---------|-------------|
-| `pai backup` | Backup registry, config, and Postgres database to ~/.pai/backups/ |
+| `pai audit` | Diagnostic audits: token-waste report and friends |
+| `pai audit tokens` | Token-waste audit: memory files, hooks, session usage, spawn overhead, daemon, env, schedule, skill catalogue |
+| `pai audit tokens daemon` | LLM spawns, KG-extraction parse failures, work-queue counts from the daemon log |
+| `pai audit tokens env` | ANTHROPIC_BASE_URL / model-override env on every live claude process |
+| `pai audit tokens files [paths...]` | Token count per memory file (CLAUDE.md chain, CORE skill, whisper rules, auto-memory) |
+| `pai audit tokens hooks` | Token cost of every SessionStart / UserPromptSubmit hook |
+| `pai audit tokens ladder` | LIVE: first-turn context at increasing headless-worker configuration (spawns real claude -p calls) |
+| `pai audit tokens schedule` | Launchd agents / crontab entries that outpace the measured prompt-cache TTL |
+| `pai audit tokens session [path]` | Cache/input/output token split for a session transcript (default: newest) |
+| `pai audit tokens skills` | Token cost of the SKILL.md / command / plugin catalogue, top entries, duplicate names |
+| `pai audit tokens spawn` | Spawn-overhead comparison: Agent-tool subagents vs. pai workers |
+| `pai backup` | Backup registry, config, and Postgres database to PAI_HOME/backups/ |
 | `pai clear-names` | Recovery: wipe corrupted iTerm2 session name state. |
+| `pai config` | PAI_HOME namespace dir: path, migrate |
+| `pai config migrate` | Move config.json, workers.yaml, whisper-rules.md, advisor-mode.json, session-state/, |
+| `pai config path` | Print the PAI_HOME namespace dir and each resolved per-user file |
 | `pai daemon` | PAI daemon management: serve, status, restart, install, uninstall, logs |
 | `pai daemon install` | Install daemon as a launchd service and update ~/.claude.json to use the shim |
 | `pai daemon logs` | Tail the daemon log (/tmp/pai-daemon.log) |
@@ -67,6 +84,7 @@ Generated man pages for every `pai` command area. Read any page in the terminal
 | `pai kg list` | List currently-valid triples |
 | `pai kg query` | Query KG triples by subject, predicate, object, time, or project |
 | `pai kg stats` | Show triple counts and contradiction count |
+| `pai launch` | Start the Claude Code harness on any provider/model from workers.yaml. |
 | `pai mcp` | MCP server management: install and status |
 | `pai mcp install` | Register the PAI MCP server (pai) in ~/.claude.json (restart Claude Code to activate) |
 | `pai mcp status` | Show whether the PAI MCP server (pai) is registered and the binary exists |
@@ -74,7 +92,7 @@ Generated man pages for every `pai` command area. Read any page in the terminal
 | `pai memory embed [project-slug]` | Generate embeddings for un-embedded chunks (Phase 2.5) |
 | `pai memory index [project-slug]` | Index memory files for one project or all projects |
 | `pai memory search <query>` | Search indexed memory (BM25 keyword, semantic, or hybrid) |
-| `pai memory settings [key] [value]` | View or modify search settings in ~/.config/pai/config.json |
+| `pai memory settings [key] [value]` | View or modify search settings in the PAI config file (`pai config path`) |
 | `pai memory sources` | Show what the indexer has taken in: composition by source, which roots |
 | `pai memory status [project-slug]` | Show memory index statistics |
 | `pai notify` | Notification config: status, get, set, test, send |
@@ -107,6 +125,7 @@ Generated man pages for every `pai` command area. Read any page in the terminal
 | `pai project info <slug>` | Show full details for a project |
 | `pai project list` | Show the unified deduped listing (same as `pai`). |
 | `pai project list-raw` | Raw registry listing with slug, path, status, last_active columns |
+| `pai project mcp [names...]` | View or set the MCP servers this project's interactive supervisor session |
 | `pai project merge <from> <into>` | Fold a duplicate project into another: move its sessions (renumbered), repoint its tags, aliases, compaction records and links, keep the old slug as an alias, then delete the row. Preview unless --execute is given. |
 | `pai project move <slug> <new-path>` | Update the root path for a project |
 | `pai project name <identifier> <shortname>` | Give a project a short name for quick access |
@@ -114,6 +133,7 @@ Generated man pages for every `pai` command area. Read any page in the terminal
 | `pai project promote` | Promote a session note into a new standalone project |
 | `pai project rebind <slug> <new-path>` | Manually update the root_path for a project (for when auto-detect found multiple matches). |
 | `pai project tag <slug> <tags...>` | Add one or more tags to a project |
+| `pai project tools [names...]` | View or set the built-in tool schemas this project's interactive |
 | `pai project unarchive <slug>` | Restore an archived project to active status |
 | `pai project unname <shortname>` | Remove a project's short name |
 | `pai project unregister <slug>` | Remove a project row entirely, for paths that should never have been registered (worktrees, temp dirs). Refuses when the row holds sessions — merge those first. Preview unless --execute is given. The directory itself is never touched. |
@@ -132,6 +152,7 @@ Generated man pages for every `pai` command area. Read any page in the terminal
 | `pai projects info <slug>` | Show full details for a project |
 | `pai projects list` | Show the unified deduped listing (same as `pai`). |
 | `pai projects list-raw` | Raw registry listing with slug, path, status, last_active columns |
+| `pai projects mcp [names...]` | View or set the MCP servers this project's interactive supervisor session |
 | `pai projects merge <from> <into>` | Fold a duplicate project into another: move its sessions (renumbered), repoint its tags, aliases, compaction records and links, keep the old slug as an alias, then delete the row. Preview unless --execute is given. |
 | `pai projects move <slug> <new-path>` | Update the root path for a project |
 | `pai projects name <identifier> <shortname>` | Give a project a short name for quick access |
@@ -139,6 +160,7 @@ Generated man pages for every `pai` command area. Read any page in the terminal
 | `pai projects promote` | Promote a session note into a new standalone project |
 | `pai projects rebind <slug> <new-path>` | Manually update the root_path for a project (for when auto-detect found multiple matches). |
 | `pai projects tag <slug> <tags...>` | Add one or more tags to a project |
+| `pai projects tools [names...]` | View or set the built-in tool schemas this project's interactive |
 | `pai projects unarchive <slug>` | Restore an archived project to active status |
 | `pai projects unname <shortname>` | Remove a project's short name |
 | `pai projects unregister <slug>` | Remove a project row entirely, for paths that should never have been registered (worktrees, temp dirs). Refuses when the row holds sessions — merge those first. Preview unless --execute is given. The directory itself is never touched. |
@@ -194,10 +216,17 @@ Generated man pages for every `pai` command area. Read any page in the terminal
 | `pai worker classes list` | List classes and their targets (default action) |
 | `pai worker classes set <class> [target]` | Point a class at a provider (or provider/fast), or give only constraints: |
 | `pai worker classes unset <class>` | Remove a class (runs then use the active provider) |
+| `pai worker config` | workers.yaml itself: path, init, migrate, check, inline-keys |
+| `pai worker config check [path]` | Validate workers.yaml (or the file at [path]); exits non-zero with file:line on error |
+| `pai worker config init` | Write the commented starter workers.yaml (refuses if one already exists) |
+| `pai worker config inline-keys` | Move each provider's key_file contents inline as `key:` (quoted); key files are left on disk |
+| `pai worker config migrate` | Two things this can mean, chosen from what is on disk: |
+| `pai worker config path` | Print the resolved workers.yaml path |
 | `pai worker controls <id> <who>` | Hand the desktop controls (clickr) to a worker or take them back. |
 | `pai worker discard <id>` | Drop a worker's worktree and branch, keeping nothing |
 | `pai worker fallback [action] [provider]` | Machine-wide fallback: every NEW Claude Code process runs on a worker |
 | `pai worker follow [id]` | Live transcript of one worker, or of this session's running workers |
+| `pai worker goal <id> <text>` | Relabel a running worker (its ps / pane goal) without sending it a message |
 | `pai worker handoff <json>` | From inside a worker: append a handoff to the parent's inbox and (when it runs) say it to the parent. |
 | `pai worker install` | Migrate: Agent hook in settings.json, ~/.local/bin glm* shims, old script cleanup |
 | `pai worker kill <id>` | Send SIGTERM to a running worker process |

package/docs/commands/audit.md

@@ -0,0 +1,113 @@
+<!-- GENERATED by scripts/build-docs.mjs from the live Commander tree (src/cli/program.ts). Do not edit by hand. -->
+
+# pai audit
+
+> Diagnostic audits: token-waste report and friends
+
+## Synopsis
+
+```
+pai audit <subcommand> [options]
+```
+
+## Subcommands
+
+| Command | Description |
+|---------|-------------|
+| [`pai audit tokens`](#pai-audit-tokens) | Token-waste audit: memory files, hooks, session usage, spawn overhead, daemon, env, schedule, skill catalogue |
+
+### pai audit tokens
+
+Token-waste audit: memory files, hooks, session usage, spawn overhead, daemon, env, schedule, skill catalogue
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--json` | Print JSON instead of a table |  |
+
+
+### pai audit tokens files [paths...]
+
+Token count per memory file (CLAUDE.md chain, CORE skill, whisper rules, auto-memory)
+
+**Arguments**
+
+| Argument | Kind | Description |
+|----------|------|-------------|
+| `[paths...]` | variadic | Files to count (default: the standard memory set) |
+
+
+### pai audit tokens hooks
+
+Token cost of every SessionStart / UserPromptSubmit hook
+
+
+### pai audit tokens session [path]
+
+Cache/input/output token split for a session transcript (default: newest)
+
+**Arguments**
+
+| Argument | Kind | Description |
+|----------|------|-------------|
+| `[path]` | optional | Session JSONL path (default: newest under ~/.claude/projects) |
+
+
+### pai audit tokens spawn
+
+Spawn-overhead comparison: Agent-tool subagents vs. pai workers
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-n, --n <count>` | How many of the newest logs per group to read (default 10) |  |
+| `--detail` | Print one row per log (first-turn ctx, prompt tokens, overhead, model, path) |  |
+
+
+### pai audit tokens daemon
+
+LLM spawns, KG-extraction parse failures, work-queue counts from the daemon log
+
+
+### pai audit tokens env
+
+ANTHROPIC_BASE_URL / model-override env on every live claude process
+
+
+### pai audit tokens schedule
+
+Launchd agents / crontab entries that outpace the measured prompt-cache TTL
+
+
+### pai audit tokens skills
+
+Token cost of the SKILL.md / command / plugin catalogue, top entries, duplicate names
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--top <n>` | How many top-by-tokens entries to show (default 15) |  |
+
+
+### pai audit tokens ladder
+
+LIVE: first-turn context at increasing headless-worker configuration (spawns real claude -p calls)
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--live` | Actually spawn claude -p (billed API traffic); refuses without this flag |  |
+| `--model <model>` | Model to probe with (default haiku) |  |
+| `--mcp-config <path>` | MCP config for the L2 rung (default: newest *.mcp.json in the workers log dir) |  |
+
+
+## See also
+
+[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+
+Run `pai help <area>` to read any of these in the terminal.
+

package/docs/commands/backup.md

@@ -2,7 +2,7 @@
 
 # pai backup
 
-> Backup registry, config, and Postgres database to ~/.pai/backups/
+> Backup registry, config, and Postgres database to PAI_HOME/backups/
 
 ## Synopsis
 
@@ -18,7 +18,7 @@ pai backup [options]
 
 ## See also
 
-[`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <area>` to read any of these in the terminal.
 

package/docs/commands/clear-names.md

@@ -21,7 +21,7 @@ pai clear-names [options]
 
 ## See also
 
-[`pai backup`](backup.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <area>` to read any of these in the terminal.
 

package/docs/commands/config.md

@@ -0,0 +1,59 @@
+<!-- GENERATED by scripts/build-docs.mjs from the live Commander tree (src/cli/program.ts). Do not edit by hand. -->
+
+# pai config
+
+> PAI_HOME namespace dir: path, migrate
+
+## Synopsis
+
+```
+pai config <subcommand> [options]
+```
+
+## Subcommands
+
+| Command | Description |
+|---------|-------------|
+| [`pai config path`](#pai-config-path) | Print the PAI_HOME namespace dir and each resolved per-user file |
+| [`pai config migrate`](#pai-config-migrate) | Move config.json, workers.yaml, whisper-rules.md, advisor-mode.json, session-state/, |
+
+### pai config path
+
+Print the PAI_HOME namespace dir and each resolved per-user file
+
+
+### pai config migrate
+
+Move config.json, workers.yaml, whisper-rules.md, advisor-mode.json, session-state/,
+
+session-scan-cache.json, queries/, summary-cooldowns.json, work-queue.json,
+kg-backfill-state.json, voices.json, the orphaned federation.db,
+~/.pai/registry.db, ~/.pai/federation.db (live), ~/.pai/backups/,
+~/.pai/obsidian-vault/, ~/.pai/scheduler-state.json, and ~/.claude/Agents/,
+~/.claude/Commands/ into PAI_HOME.
+registry.db and federation.db each get an extra WAL checkpoint and PRAGMA
+integrity_check (sqlite3 CLI, if present) on top of the byte-identical copy.
+backups/ is copied and sha256-verified file-by-file into
+backups/legacy-pai-backups/ rather than merged in place. Agents/ and Commands/ each
+get a symlink left at the old ~/.claude path once their content has moved, so
+Claude Code still finds them at its fixed harness paths.
+Each file is copied, verified byte-identical, then the old file is renamed to
+<name>.migrated-<YYYYMMDD> (never deleted); directories move their contents, then
+the emptied old directory is renamed the same way. Idempotent — entries already at
+the new location, or with nothing old to migrate, are skipped.
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--dry-run` | Print the plan without writing anything |  |
+| `--logs` | Also move ~/.claude/logs/workers into PAI_HOME (refuses while any worker       other than the interactive session is RUNNING — see `pai worker ps`) |  |
+| `--history` | Also move ~/.claude/History/, agent-sessions.json, session-routing.json       and history/security/security-events.jsonl into PAI_HOME. These are       written by hooks on EVERY session's every turn, not just spawned       workers — refuses while any worker other than the interactive       session is RUNNING (see `pai worker ps`), but that guard cannot see       OTHER interactive `claude` sessions on this machine. Confirm none       are active (`ps aux \| grep claude`, `aibroker sessions list`) before       passing this flag. |  |
+
+
+## See also
+
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+
+Run `pai help <area>` to read any of these in the terminal.
+

package/docs/commands/daemon.md

@@ -72,7 +72,7 @@ Tail the daemon log (/tmp/pai-daemon.log)
 
 ## See also
 
-[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <area>` to read any of these in the terminal.
 

package/docs/commands/db.md

@@ -68,7 +68,7 @@ Show column schema for a table
 
 ## See also
 
-[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <area>` to read any of these in the terminal.
 

package/docs/commands/end.md

@@ -21,7 +21,7 @@ pai end [options]
 
 ## See also
 
-[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <area>` to read any of these in the terminal.
 

package/docs/commands/help.md

@@ -24,7 +24,7 @@ pai help [area] [options]
 
 ## See also
 
-[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <area>` to read any of these in the terminal.
 

package/docs/commands/identity.md

@@ -59,7 +59,7 @@ Set where digests and 'mail me X' are delivered
 
 ## See also
 
-[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <area>` to read any of these in the terminal.
 

package/docs/commands/kg.md

@@ -83,7 +83,7 @@ pai kg stats
 
 ## See also
 
-[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <area>` to read any of these in the terminal.
 

package/docs/commands/launch.md

@@ -0,0 +1,45 @@
+<!-- GENERATED by scripts/build-docs.mjs from the live Commander tree (src/cli/program.ts). Do not edit by hand. -->
+
+# pai launch
+
+> Start the Claude Code harness on any provider/model from workers.yaml.
+
+No args, in a terminal: pick from a numbered table. --list (or piped/non-
+interactive output): print the table and exit.
+--provider <name> [--model <model>]: start directly, no prompt.
+A running claude process cannot switch provider — this always starts a NEW
+session in the current terminal. Claude Code's own /model command only shows
+the CURRENT endpoint's models; `pai launch --list` (or the /providers skill)
+shows every provider configured here.
+Extra arguments after the options are passed to claude verbatim, e.g.
+`pai launch --provider glm -- --resume <id>`.
+The `glm`/`kimi` shell shims are thin aliases of `pai launch --provider <name>`.
+
+## Synopsis
+
+```
+pai launch [args...] [options]
+```
+
+## Arguments
+
+| Argument | Kind | Description |
+|----------|------|-------------|
+| `[args...]` | variadic | extra claude arguments, e.g. --resume <id> |
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--provider <name>` | Provider to start on (default: prompt from the table) |  |
+| `--model <model>` | Model id for that provider (default: the provider's default model) |  |
+| `--list` | Print the provider/model table and exit |  |
+| `--current` | With --list, also detect and mark this session's own provider/model |  |
+| `--dry-run` | Print the resolved command and environment (key masked); do not exec |  |
+
+## See also
+
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+
+Run `pai help <area>` to read any of these in the terminal.
+

package/docs/commands/mcp.md

@@ -29,7 +29,7 @@ Show whether the PAI MCP server (pai) is registered and the binary exists
 
 ## See also
 
-[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <area>` to read any of these in the terminal.
 

package/docs/commands/memory.md

@@ -18,7 +18,7 @@ pai memory <subcommand> [options]
 | [`pai memory embed [project-slug]`](#pai-memory-embed-project-slug) | Generate embeddings for un-embedded chunks (Phase 2.5) |
 | [`pai memory search <query>`](#pai-memory-search-query) | Search indexed memory (BM25 keyword, semantic, or hybrid) |
 | [`pai memory status [project-slug]`](#pai-memory-status-project-slug) | Show memory index statistics |
-| [`pai memory settings [key] [value]`](#pai-memory-settings-key-value) | View or modify search settings in ~/.config/pai/config.json |
+| [`pai memory settings [key] [value]`](#pai-memory-settings-key-value) | View or modify search settings in the PAI config file (`pai config path`) |
 | [`pai memory sources`](#pai-memory-sources) | Show what the indexer has taken in: composition by source, which roots |
 
 ### pai memory index [project-slug]
@@ -92,7 +92,7 @@ Show memory index statistics
 
 ### pai memory settings [key] [value]
 
-View or modify search settings in ~/.config/pai/config.json
+View or modify search settings in the PAI config file (`pai config path`)
 
 **Arguments**
 
@@ -134,7 +134,7 @@ pai memory status
 
 ## See also
 
-[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <area>` to read any of these in the terminal.
 

package/docs/commands/notify.md

@@ -77,7 +77,7 @@ Send a notification with an explicit event type and message
 
 ## See also
 
-[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <area>` to read any of these in the terminal.
 

package/docs/commands/observation.md

@@ -74,7 +74,7 @@ pai observation stats
 
 ## See also
 
-[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <area>` to read any of these in the terminal.
 

package/docs/commands/obsidian.md

@@ -54,7 +54,7 @@ Open the vault in Obsidian (macOS)
 
 ## See also
 
-[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <area>` to read any of these in the terminal.
 

package/docs/commands/pause.md

@@ -33,7 +33,7 @@ pai pause [target] [options]
 
 ## See also
 
-[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <area>` to read any of these in the terminal.
 

package/docs/commands/project.md

@@ -38,6 +38,8 @@ pai project <subcommand> [options]
 | [`pai project unname <shortname>`](#pai-project-unname-shortname) | Remove a project's short name |
 | [`pai project names`](#pai-project-names) | List named projects (your curated shortlist) |
 | [`pai project config [identifier]`](#pai-project-config-identifier) | View or modify session launch config for a project. |
+| [`pai project mcp [names...]`](#pai-project-mcp-names) | View or set the MCP servers this project's interactive supervisor session |
+| [`pai project tools [names...]`](#pai-project-tools-names) | View or set the built-in tool schemas this project's interactive |
 
 ### pai project list
 
@@ -398,9 +400,52 @@ Use --options to discover available keys and presets.
 | `--reset` | Reset config to empty (inherit global defaults) |  |
 
 
+### pai project mcp [names...]
+
+View or set the MCP servers this project's interactive supervisor session
+
+loads (run from inside the project, like `pai projects here`).
+No names: print the current value. Names (comma-separated or repeated
+args): set it, validated against ~/.claude.json's mcpServers.
+--clear: unset (all servers load — today's default).
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `[names...]` | variadic |
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--clear` | Unset — all MCP servers load again |  |
+
+
+### pai project tools [names...]
+
+View or set the built-in tool schemas this project's interactive
+
+supervisor session loads (run from inside the project, like `pai projects
+here`). No names: print the current value. Names (comma-separated or
+repeated args): set it. --clear: unset (all tools load — today's default).
+
+**Arguments**
+
+| Argument | Kind |
+|----------|------|
+| `[names...]` | variadic |
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--clear` | Unset — all built-in tools load again |  |
+
+
 ## See also
 
-[`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <area>` to read any of these in the terminal.