All commands · workspace
pm workspace init
Initialize pm storage and defaults for the current workspace or a path-like tracker target.
Bootstraps tracker storage and settings so all other commands can run safely.
Usage
pm workspace init [options] [prefix-or-path]Arguments
| <prefix-or-path> | Optional id prefix, or path-like tracker target such as ./pm-sandbox | optional |
|---|
Options
| --prefix, --id-prefix <value> | Set the item ID prefix (alias for the positional prefix) | optional |
|---|---|---|
| --preset <value> | Governance preset for new setups: minimal|default|strict | optional |
| --defaults | Use non-interactive setup defaults without opening the wizard | optional |
| --author <value> | Set the default mutation author for this project | optional |
| --agent-guidance <mode> | Agent guidance mode: ask|add|skip|status | optional |
| --type-preset <name> | Register domain item types during init: agile|ops|research | optional |
| --with-packages | Install all bundled first-party packages during initialization | optional |
| --no-merge-fence | Skip automatic merge-driver installation for a fresh Git-backed tracker | optional |
| --workspace <dir> | Initialize repository-local tracker storage at <dir>/.agents/pm | optional |
| --force | Allow initializing tracker files directly in a directory that looks like a workspace root | optional |
| --verbose | Include the full resolved settings tree in the output (default output is a concise summary) | optional |
Examples
pm workspace init