Management Commands
Management commands handle PP Core's configuration and workspace plumbing: settings wizards, integrations, command surface visibility, updates, isolated workspaces and parallel workstreams, capture and threading, quick execution paths, undo, cleanup, and help.
/pp-settings
Opens an interactive wizard that walks through configuration across six areas: Planning, Execution, Docs and Output, Features, Model and Pipeline, and Misc.
/pp-settings
/pp-config
Consolidated configuration entry point with mode routing for settings and integrations.
/pp-config
/pp-config --advanced
/pp-config --integrations
/pp-config --profile quality
| Flag | Behavior |
|---|---|
--advanced | Exposes power-user knobs for planning, execution, discussion, cross-AI, git, and runtime behavior. |
--integrations | Manages API keys and agent-skill injection. |
--profile [name] | Switches the model profile; accepts quality, balanced, budget, or inherit. |
/pp-surface
Toggles which skill commands are surfaced without reinstalling PP Core.
/pp-surface list
/pp-surface profile standard
/pp-surface disable utility
| Subcommand | Behavior |
|---|---|
list | Lists enabled and disabled clusters with their token costs. |
status | Same as list, with a profile summary. |
profile [name] | Switches the base surface profile: core, standard, or full. |
disable [cluster] | Removes a cluster from the active surface. |
enable [cluster] | Restores a cluster to the active surface. |
reset | Returns to the install-time defaults. |
Valid clusters: core_loop, audit_review, milestone, research_ideate, workspace_state, docs, ui, ai_eval, ns_meta, utility.
/pp-update
Updates PP Core to the latest version and shows the changelog.
/pp-update
/pp-update --sync
/pp-update --next
| Flag | Behavior |
|---|---|
--sync | Syncs managed skills across runtime roots; supports --from, --to, --dry-run, and --apply. |
--reapply | Recovers local customizations through a three-way merge after updating. |
--next / --rc | Targets the @next release candidate rather than @latest. |
/pp-workspace
Creates, lists, and removes isolated workspace environments.
/pp-workspace --new --name feature-x --repos myrepo --strategy worktree
/pp-workspace --list
/pp-workspace --remove feature-x
| Flag / Option | Behavior |
|---|---|
--new | Creates an isolated workspace; combine with --name, --repos, and --strategy. |
--list | Lists all active workspaces. |
--remove | Removes a named workspace. |
--name [name] | Sets the workspace identifier. |
--repos [repos] | Comma-separated list of repositories to include. |
--strategy [strategy] | worktree (faster, shared objects) or clone (fully isolated). |
/pp-workstreams
Manages parallel workstreams for concurrent work within a milestone.
/pp-workstreams list
/pp-workstreams create payments
/pp-workstreams switch payments
| Subcommand | Behavior |
|---|---|
list | Shows all workstreams with status and progress. |
create [name] | Creates a new workstream. |
status [name] | Shows the phase breakdown for a workstream. |
switch [name] | Makes a workstream the active context. |
progress | Summarizes progress across all workstreams. |
complete [name] | Archives a workstream to milestones/. |
resume [name] | Activates a workstream and prompts to resume its work. |
/pp-capture
Routes ideas, tasks, notes, and seeds to their appropriate destinations.
/pp-capture "refactor the auth module to use JWTs"
/pp-capture --note "talked to design team — they want rounded corners"
/pp-capture --backlog "add dark mode support"
/pp-capture --list
| Flag | Behavior |
|---|---|
| (none) | Creates a structured todo under .planning/todos/. |
--note [text] | Appends a timestamped note. |
--backlog [text] | Adds an item to ROADMAP.md using 999.x numbering. |
--seed [text] | Plants a forward-looking idea with triggers under .planning/seeds/. |
--list | Opens the interactive todo browser. |
/pp-thread
Creates and manages persistent context threads that span sessions.
/pp-thread "investigating the N+1 query in orders"
/pp-thread list --open
/pp-thread resume auth-refactor
| Subcommand / Argument | Behavior |
|---|---|
[text] | Opens a new thread from the given description. |
list [--open|--resolved] | Lists threads, optionally filtered by state. |
status [slug] | Shows a thread's context summary. |
close [slug] | Marks a thread as resolved. |
resume [slug] | Restores a thread's context into the current session. |
/pp-quick
Executes ad-hoc tasks with PP Core guarantees through a shortened pipeline.
/pp-quick "add rate limiting to the upload endpoint"
/pp-quick "fix flaky test in auth suite" --validate
/pp-quick list
| Flag / Subcommand | Behavior |
|---|---|
--full | Enables the complete pipeline: discussion, research, and validation. |
--validate | Enables plan-checking and verification only. |
--discuss | Runs a lightweight discussion before planning. |
--research | Spawns a focused research agent. |
list | Lists all quick tasks. |
status [slug] | Shows the status of a specific task. |
resume [slug] | Resumes an in-progress task. |
/pp-fast
Runs trivial tasks inline with no planning overhead.
/pp-fast "fix typo in README"
/pp-fast "bump version to 1.2.1 in package.json"
/pp-undo
Safely reverts phase and plan commits, with dependency checks to avoid breaking later work.
/pp-undo --last 5
/pp-undo --phase 03
| Flag | Behavior |
|---|---|
--last N | Lists the most recent N PP Core commits to select from. |
--phase NN | Reverts all commits belonging to a phase. |
--plan NN-MM | Reverts a specific plan, using phase-plan notation. |
/pp-cleanup
Archives completed phase directories and prunes stale branches.
/pp-cleanup
/pp-help
Displays the PP Core command reference at the requested level of detail.
/pp-help
/pp-help --brief
/pp-help workflow
/pp-help --brief ship
| Flag / Argument | Behavior |
|---|---|
| (none) | One-page tour of all commands. |
--brief | One line per command. |
--full | Complete reference for every command. |
[topic] | Shows the section for a single topic. |
--brief [topic] | Compact, scoped lookup for one topic. |