On this page
Commands
Generated from the live CLI — always in sync. Run cotrackpro <command> --help for the latest.
Global options
| Option | Description |
|---|---|
-V, --version | output the version number |
--org <slug> | active organization |
--output <mode> | output: table|json |
--json | shorthand for --output json |
--no-color | disable color |
--no-input | never prompt; fail if input is required |
--yes | assume yes for confirmations |
--debug | verbose errors + stack traces |
All commands#
cotrackpro start#
New here? A quick tour of what you can do
cotrackpro setup#
Guided first-time setup
cotrackpro login#
Sign in via your browser
cotrackpro whoami#
Show who you are and what you can do
cotrackpro org#
Manage your active organization
cotrackpro org list
List your organizations
cotrackpro org switch
Switch active organization
cotrackpro doctor#
Diagnose and fix setup problems
cotrackpro packagesalias: pkg#
Download and publish libraries
cotrackpro packages list
List libraries in your organization
cotrackpro packages pull
Download a library (name@version) - verifies integrity
cotrackpro packages publish
Publish a .tgz to your organization
| Option | Description |
|---|---|
--as <ref> | set name@version explicitly |
--dry-run | show what would happen |
cotrackpro packages yank
Remove a published version (admins only)
cotrackpro verify#
Verify a downloaded artifact's checksum and signature
| Option | Description |
|---|---|
--strict | exit non-zero unless a checksum is verified (fail-closed for pipelines) |
cotrackpro scaffold#
Create a new starter project, already wired up to the CoTrackPro toolkit (a 'scaffold')
| Option | Description |
|---|---|
--dir <path> | target directory (default ./cotrackpro-<name>) |
--plugin | make it a plugin that gets a scoped access key from the CLI when it runs |
--scopes <list> | comma-separated scopes the plugin needs |
--params <name|file> | include a parameter set (name in ./.cotrackpro/params or a JSON Schema file) |
--diagram <file> | include an APPROVED diagram (cotrackpro diagram extract) as docs/diagram.md |
cotrackpro params#
Create and use your own parameter sets — custom field schemas (offline)
cotrackpro params new
Create a parameter set (interactive, or import a JSON Schema with --from)
| Option | Description |
|---|---|
--from <file> | import a form definition (a JSON Schema file) |
--user | store in your user config instead of ./.cotrackpro |
--force | overwrite if it already exists |
cotrackpro params list
List your parameter sets
| Option | Description |
|---|---|
--user | list user-level sets |
cotrackpro params show
Show a parameter set
| Option | Description |
|---|---|
--user | read from user config |
--schema | print the canonical JSON Schema |
cotrackpro params validate
Validate one parameter set, or all of them
| Option | Description |
|---|---|
--user | read from user config |
cotrackpro params fill
Fill in a parameter set and render a markdown document
| Option | Description |
|---|---|
--user | read from user config |
--values <file> | values JSON (non-interactive) |
--out <file> | write the document to a file |
--copy | copy the document to your clipboard |
cotrackpro params types
Generate a TypeScript interface for a parameter set
| Option | Description |
|---|---|
--user | read from user config |
--out <file> | write the .ts to a file |
--copy | copy the TypeScript to your clipboard |
cotrackpro params prompt
Emit a prompt to paste into your AI assistant from a parameter set
| Option | Description |
|---|---|
--user | read from user config |
--out <file> | write the prompt to a file |
--copy | copy the prompt to your clipboard |
cotrackpro diagram#
Turn a document or form into a flowchart you can review and approve before building (offline)
cotrackpro diagram extract
Turn a document or parameter set into an approval-ready Mermaid markdown
| Option | Description |
|---|---|
--from <kind> | text|params (default: by file extension) |
--direction <dir> | TD or LR (default TD) |
--prompt | emit a prompt to paste into your AI assistant instead of the markdown |
--out <file> | write the output |
--copy | copy the output to your clipboard |
cotrackpro diagram approve
Sign off an approval doc (set its Status to Approved) so `scaffold --diagram` will build from it
| Option | Description |
|---|---|
--by <name> | record who approved it (stamps Approved by + today's date) |
--out <file> | write to a different file instead of in place |
cotrackpro diagram check
Validate the Mermaid in a markdown or .mmd file
cotrackpro diagram role
Diagram a role's composed skills + always-on guardrails (offline)
| Option | Description |
|---|---|
--prompt | emit a paste-into-your-AI prompt instead |
--out <file> | write the markdown |
--copy | copy the output to your clipboard |
cotrackpro diagram workflow
Diagram a workflow's real step graph (offline)
| Option | Description |
|---|---|
--prompt | emit a paste-into-your-AI prompt instead |
--out <file> | write the markdown |
--copy | copy the output to your clipboard |
cotrackpro guide#
Generate dual-audience operational onboarding + feedback guides from the catalog (offline)
cotrackpro guide list
List sources you can generate a guide from (blueprints, scenarios, workflows)
cotrackpro guide new
Create a step-by-step onboarding guide from a blueprint, scenario, or workflow
| Option | Description |
|---|---|
--kind <kind> | blueprint|scenario|workflow (default: auto-detect) |
--audience <who> | dev|leader|both (default both) |
--no-diagram | skip the embedded flow diagram |
--feedback-target <url> | where feedback issues are filed |
--prompt | emit a prompt to paste into your AI assistant instead of the guide |
--out <file> | write the guide markdown |
--copy | copy the output to your clipboard |
cotrackpro guide feedback
Write a GitHub issue form for structured guide feedback
| Option | Description |
|---|---|
--out <file> | path (default .github/ISSUE_TEMPLATE/guide-feedback.yml) |
cotrackpro workflow#
Workflow Studio — turn one source into a guide, ready-to-run commands, or files (offline)
cotrackpro workflow list
List sources you can render (blueprints, scenarios, workflows)
cotrackpro workflow show
Show what a source includes and the files it creates
| Option | Description |
|---|---|
--kind <kind> | blueprint|scenario|workflow |
cotrackpro workflow render
Turn a source into a guide, ready-to-run commands, or files
| Option | Description |
|---|---|
--as <kind> | playbook (a guide), commands (ready-to-run CLI), assets (the files), or prompt (for your AI) — default playbook |
--kind <kind> | source kind: blueprint|scenario|workflow |
--audience <who> | playbook audience: dev|leader|both |
--repos <list> | comma-separated repos for the commands projection |
--out <path> | write output (file for playbook/commands/prompt; directory for assets) |
--copy | copy the output to your clipboard |
cotrackpro nocode#
Build, run, and diagram small apps that run on your device — no account, no code (offline)
cotrackpro nocode examples
List starter no-code apps you can create
cotrackpro nocode new
Create a starter app (.ctp.json) you can run or diagram right away — or `blank` for an empty app you build up yourself
| Option | Description |
|---|---|
--out <file> | write the app to a file (default: print it) |
--copy | copy the app JSON to your clipboard |
cotrackpro nocode validate
Check a no-code app for problems: bad structure, broken links, disallowed steps, loops
cotrackpro nocode fix
Auto-repair a no-code app: fill in the variables and AI-tool permissions its steps need
| Option | Description |
|---|---|
--out <file> | write to a different file instead of in place |
cotrackpro nocode build
Open the drag-and-drop visual builder in your browser (the .ctp.json it exports runs here)
| Option | Description |
|---|---|
--no-open | just print the URL, don't open a browser |
cotrackpro nocode run
Run an app's on-device steps and show the resulting variables
| Option | Description |
|---|---|
--values <file> | seed values JSON for input nodes |
--mock <file> | sample AI-tool answers JSON, keyed by "serverId/toolName", to test offline |
--trace | show what each step produced, in order |
--watch | re-run whenever the app (or --values/--mock file) changes — pairs with the visual builder's export |
cotrackpro nocode mermaid
Render the app as a Mermaid flowchart
| Option | Description |
|---|---|
--out <file> | write the diagram to a file |
--copy | copy the diagram to your clipboard |
cotrackpro nocode prompt
Emit a prompt to paste into your AI assistant to extend the app
| Option | Description |
|---|---|
--out <file> | write the prompt to a file |
--copy | copy the prompt to your clipboard |
cotrackpro nocode try
One command to a running prototype: create a starter (example or catalog form), seed test data, and run it
| Option | Description |
|---|---|
--force | replace existing files for this starter |
cotrackpro nocode seed
Write ready-to-edit test-data files (--values / --mock) derived from the app's own inputs and AI steps
| Option | Description |
|---|---|
--force | overwrite existing seed files |
cotrackpro nocode idea
Turn a plain-language idea into an AI prompt that returns a complete, importable app
| Option | Description |
|---|---|
--out <file> | write the prompt to a file |
--copy | copy the prompt to your clipboard |
cotrackpro nocode from-form
Turn a curated catalog form (incident log, evidence log, …) into a typed app starter — no arg lists the forms
| Option | Description |
|---|---|
--out <file> | write the app to a file (default: print it) |
--copy | copy the app JSON to your clipboard |
cotrackpro nocode share
Publish the app as a link — opens a fill-in page; the whole app travels inside the link, nothing is uploaded
| Option | Description |
|---|---|
--copy | copy the link to your clipboard |
--open | open the link in your browser |
cotrackpro nocode apps
Your app library — keep workflows in a folder YOU own (your repo, synced drive, anywhere) (offline)
cotrackpro community#
Browse developer-community tiers, and log contributions + track XP — personal, offline, anyone can use (offline)
cotrackpro community join
How to join the developer community — the role, the tiers, and the three ways to sign up (offline)
cotrackpro community invite
Get a shareable invite link + message to bring others into the community (offline)
| Option | Description |
|---|---|
--copy | copy the invite message to your clipboard |
cotrackpro community card
Make a shareable progress card (XP, badges, streak + an invite link) to post or paste (offline)
| Option | Description |
|---|---|
--name <tag> | tag the invite link for a channel, e.g. --name my-blog |
--copy | copy the card markdown to your clipboard |
cotrackpro community showcase
Submit a tool you built to the community Showcase — or browse what others made (offline)
| Option | Description |
|---|---|
--open | open the submission form in your browser |
cotrackpro community tiers
List the membership tiers and what they unlock
cotrackpro community show
Show one tier's cumulative scopes and Slack channels
cotrackpro community events
List the XP events the community recognizes (recognition, not a scope grant)
cotrackpro community badges
List the badges the community celebrates and how they're earned
cotrackpro community log
Record a contribution to your local ledger (e.g. merge-pr, answer-help)
cotrackpro community xp
Score your contributions — total XP, badges, and progress. Defaults to your local ledger (offline)
| Option | Description |
|---|---|
--events <list> | comma list, e.g. publish-package:2,merge-pr:1 |
--file <json> | a JSON map of event id → count |
cotrackpro tools#
Browse the developer tools a non-coder needs, explained in plain words (offline)
cotrackpro feedback#
Tell the maintainers what's working — opens a pre-filled GitHub issue you review and submit (offline)
| Option | Description |
|---|---|
--message <text> | a comment to pre-fill the issue |
--no-open | just print the link, don't open a browser |
--url | print the feedback link only |
cotrackpro glossary#
Plain-language definitions of the words the CLI uses — library, scope, token, scaffold, Mermaid… (offline)
cotrackpro completion#
Print a tab-completion script for your shell (bash|zsh|fish) (offline)
cotrackpro project#
Create ready-to-edit starter projects from proven blueprints (offline)
cotrackpro project list
List project blueprints
cotrackpro project show
Show what a blueprint covers and the catalog pieces it uses
cotrackpro project new
Create a working starter project from a blueprint
| Option | Description |
|---|---|
--dir <path> | target directory (default ./cotrackpro-<name>) |
cotrackpro propose#
Start a community contribution to the catalog: skill|role|prompt-module|workflow|blueprint (offline)
| Option | Description |
|---|---|
--lens <list> | guardrail lens to bind: child-centered,trauma-informed |
--modules <list> | comma-separated prompt modules to bind (validated against the catalog) |
--title <text> | human-readable title |
--summary <text> | one-sentence description |
--disciplines <list> | fields of study a blueprint bridges |
--dir <path> | output directory (default ./cotrackpro-proposal-<name>) |
cotrackpro token#
Create a short-lived, limited access key so a script can safely read protected data
| Option | Description |
|---|---|
--scopes <list> | comma-separated scopes (required), e.g. org:packages:read |
--ttl <sec> | token lifetime in seconds (default 300) |
--plugin <name> | label for the requesting tool (default cli) |
--export | print shell `export` lines for `eval` |
cotrackpro artifacts#
Browse the catalog of reusable building blocks — 'artifacts' (offline)
cotrackpro artifacts list
List all artifacts
cotrackpro artifacts search
Search artifacts by keyword
cotrackpro artifacts show
Show one artifact's metadata
cotrackpro catalog#
Browse everything you can build with: artifacts|roles|workflows|skills|knowledge|scenarios|prompt-modules|apps|triggers|safety (offline)
cotrackpro workspacealias: ws#
Clone and link the CoTrackPro ecosystem locally
cotrackpro workspace list
List ecosystem repositories
| Option | Description |
|---|---|
--category <c> | filter: core|feature |
cotrackpro workspace status
Show which repos are present locally
| Option | Description |
|---|---|
--dir <path> | workspace directory (default: cwd) |
cotrackpro workspace clone
Clone ecosystem repos (default: all)
| Option | Description |
|---|---|
--dir <path> | workspace directory |
--category <c> | filter: core|feature |
--ssh | use SSH clone URLs |
--dry-run | show the plan without cloning |
cotrackpro workspace link
Point each local repo's @cotrackpro/sdk at this CLI's SDK
| Option | Description |
|---|---|
--dir <path> | workspace directory |
--dry-run | show the plan without editing |
cotrackpro pluginsalias: plugin#
Add and manage tools that extend the CLI
cotrackpro plugins install
Install a tool from a manifest URL
cotrackpro plugins register
Register a local package as a plugin (reads cotrackpro.plugin.json)
cotrackpro plugins list
List installed tools
cotrackpro plugins remove
Remove an installed tool
cotrackpro mcp#
Connect your AI app to CoTrackPro tools (MCP) and launch them
cotrackpro mcp config
Print (or --write) an MCP connection config for your AI app
| Option | Description |
|---|---|
--client <c> | claude-desktop|claude-code|cursor|vscode|gemini-cli (default claude-desktop) |
--url <url> | your CoTrackPro MCP server URL |
--name <name> | server name (default cotrackpro) |
--write | merge it into the client's config file instead of printing |
cotrackpro mcp test
Check that a CoTrackPro MCP server is reachable
| Option | Description |
|---|---|
--url <url> | server URL (default the public server) |
cotrackpro mcp launch
Start an MCP-server plugin