Skip to content

CLI reference

polydomain makes no network calls and collects no telemetry — its templates are bundled with the CLI.

Scaffold a new command center in [dir] (defaults to the current directory). Prompts for the target agent(s) unless --agent or --yes is given.

FlagDescription
--agent <list>Comma-separated agents: claude, codex, gemini, cursor (default: claude)
--domains <spec>minimal, standard, full, or a comma-separated list (default: standard = work,side-project)
--with-referencesAlias for --references notes
--references <type>Add a notes-store capsule: notes (generic core) or obsidian (core + Obsidian conventions)
--actions <platform>Add an actions capsule (macos) — recipes for reminders/calendar/email
--no-memorySkip the memory/ directory
--no-gitSkip git init
--forceWrite into a non-empty directory
-y, --yesAccept all defaults, no prompts

Add a domain capsule (domains/<name>.md) and register it in domains/_registry.md. Run it from inside a command center. The name must be a simple identifier (letters, digits, hyphens); it fails if the capsule already exists.

Add an entrypoint for another agent (claude, codex, gemini, cursor). Run it from inside a command center. Fails if that agent’s entrypoint already exists.

Add a notes-store capsule to an existing command center: notes (the generic references/notes-store.md core) or obsidian (the core plus references/obsidian.md). Run it from inside a command center. Fails on an unknown type or if the capsule already exists.

Bring an existing repo up to the command-center standard. Run it from inside a git repo with a clean working tree. It creates the adopt/standard branch and writes MIGRATION.md (a playbook your agent follows); it writes nothing else and edits nothing. Fails if the directory is not a git repo, the tree is dirty, or the branch already exists. See Adopt an existing repo.

Add an actions capsule to an existing command center (macos). Generates actions/macos.md with verified osascript/Mail.app recipes for reminders, calendar events, and email. Run it from inside a command center. Fails on an unknown platform, outside a center, or if the capsule already exists. See Actions (macOS).

Standard.