On this page

Commands

Generated from the live CLI — always in sync. Run cotrackpro <command> --help for the latest.

Global options
OptionDescription
-V, --versionoutput the version number
--org <slug>active organization
--output <mode>output: table|json
--jsonshorthand for --output json
--no-colordisable color
--no-inputnever prompt; fail if input is required
--yesassume yes for confirmations
--debugverbose 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

OptionDescription
--as <ref>set name@version explicitly
--dry-runshow what would happen

cotrackpro packages yank

Remove a published version (admins only)

cotrackpro verify#

Verify a downloaded artifact's checksum and signature

OptionDescription
--strictexit 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')

OptionDescription
--dir <path>target directory (default ./cotrackpro-<name>)
--pluginmake 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)

OptionDescription
--from <file>import a form definition (a JSON Schema file)
--userstore in your user config instead of ./.cotrackpro
--forceoverwrite if it already exists

cotrackpro params list

List your parameter sets

OptionDescription
--userlist user-level sets

cotrackpro params show

Show a parameter set

OptionDescription
--userread from user config
--schemaprint the canonical JSON Schema

cotrackpro params validate

Validate one parameter set, or all of them

OptionDescription
--userread from user config

cotrackpro params fill

Fill in a parameter set and render a markdown document

OptionDescription
--userread from user config
--values <file>values JSON (non-interactive)
--out <file>write the document to a file
--copycopy the document to your clipboard

cotrackpro params types

Generate a TypeScript interface for a parameter set

OptionDescription
--userread from user config
--out <file>write the .ts to a file
--copycopy the TypeScript to your clipboard

cotrackpro params prompt

Emit a prompt to paste into your AI assistant from a parameter set

OptionDescription
--userread from user config
--out <file>write the prompt to a file
--copycopy 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

OptionDescription
--from <kind>text|params (default: by file extension)
--direction <dir>TD or LR (default TD)
--promptemit a prompt to paste into your AI assistant instead of the markdown
--out <file>write the output
--copycopy 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

OptionDescription
--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)

OptionDescription
--promptemit a paste-into-your-AI prompt instead
--out <file>write the markdown
--copycopy the output to your clipboard

cotrackpro diagram workflow

Diagram a workflow's real step graph (offline)

OptionDescription
--promptemit a paste-into-your-AI prompt instead
--out <file>write the markdown
--copycopy 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

OptionDescription
--kind <kind>blueprint|scenario|workflow (default: auto-detect)
--audience <who>dev|leader|both (default both)
--no-diagramskip the embedded flow diagram
--feedback-target <url>where feedback issues are filed
--promptemit a prompt to paste into your AI assistant instead of the guide
--out <file>write the guide markdown
--copycopy the output to your clipboard

cotrackpro guide feedback

Write a GitHub issue form for structured guide feedback

OptionDescription
--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

OptionDescription
--kind <kind>blueprint|scenario|workflow

cotrackpro workflow render

Turn a source into a guide, ready-to-run commands, or files

OptionDescription
--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)
--copycopy 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

OptionDescription
--out <file>write the app to a file (default: print it)
--copycopy 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

OptionDescription
--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)

OptionDescription
--no-openjust print the URL, don't open a browser

cotrackpro nocode run

Run an app's on-device steps and show the resulting variables

OptionDescription
--values <file>seed values JSON for input nodes
--mock <file>sample AI-tool answers JSON, keyed by "serverId/toolName", to test offline
--traceshow what each step produced, in order
--watchre-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

OptionDescription
--out <file>write the diagram to a file
--copycopy the diagram to your clipboard

cotrackpro nocode prompt

Emit a prompt to paste into your AI assistant to extend the app

OptionDescription
--out <file>write the prompt to a file
--copycopy 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

OptionDescription
--forcereplace 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

OptionDescription
--forceoverwrite existing seed files

cotrackpro nocode idea

Turn a plain-language idea into an AI prompt that returns a complete, importable app

OptionDescription
--out <file>write the prompt to a file
--copycopy 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

OptionDescription
--out <file>write the app to a file (default: print it)
--copycopy 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

OptionDescription
--copycopy the link to your clipboard
--openopen 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)

OptionDescription
--copycopy 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)

OptionDescription
--name <tag>tag the invite link for a channel, e.g. --name my-blog
--copycopy the card markdown to your clipboard

cotrackpro community showcase

Submit a tool you built to the community Showcase — or browse what others made (offline)

OptionDescription
--openopen 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)

OptionDescription
--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)

OptionDescription
--message <text>a comment to pre-fill the issue
--no-openjust print the link, don't open a browser
--urlprint 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

OptionDescription
--dir <path>target directory (default ./cotrackpro-<name>)

cotrackpro propose#

Start a community contribution to the catalog: skill|role|prompt-module|workflow|blueprint (offline)

OptionDescription
--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

OptionDescription
--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)
--exportprint 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

OptionDescription
--category <c>filter: core|feature

cotrackpro workspace status

Show which repos are present locally

OptionDescription
--dir <path>workspace directory (default: cwd)

cotrackpro workspace clone

Clone ecosystem repos (default: all)

OptionDescription
--dir <path>workspace directory
--category <c>filter: core|feature
--sshuse SSH clone URLs
--dry-runshow the plan without cloning

cotrackpro workspace link

Point each local repo's @cotrackpro/sdk at this CLI's SDK

OptionDescription
--dir <path>workspace directory
--dry-runshow 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

OptionDescription
--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)
--writemerge it into the client's config file instead of printing

cotrackpro mcp test

Check that a CoTrackPro MCP server is reachable

OptionDescription
--url <url>server URL (default the public server)

cotrackpro mcp launch

Start an MCP-server plugin