Quickstart

From zero to signed in, in two steps — about a minute. Requires Node.js 20+ on macOS, Linux, or Windows.

Building with real families in mind? Everything you make here is educational and informational only — not legal or clinical advice.

New to the command line? Once it's installed, run cotrackpro start for a guided tour — many commands work with no account.

In short: you install one program, sign in once, and you're ready. If the install step looks scary, ask someone comfortable with computers to sit with you for the first minute — after that it's typing simple commands.

Developer note: cotrackpro setup runs an OAuth device flow; the token lands in your OS keychain when available. For CI or headless machines, set COTRACKPRO_TOKEN instead — the CLI prefers the environment variable over the keychain.

1. Install and sign in#

npm install -g @cotrackpro-dev/cli
cotrackpro setup        # opens your browser to sign in

No global install? Use it on demand: npx @cotrackpro-dev/cli setup.

Preview scope. The CLI ships today under a temporary npm scope, @cotrackpro-dev — the command is still cotrackpro. It moves to @cotrackpro/cli once that scope is available; the command and everything below are identical either way.

2. Confirm you're in#

cotrackpro whoami       # your name, org, role, and tier

✅ See your name and tier? You're set up — that's the whole quickstart. Something off? Run cotrackpro doctor to diagnose it.

Go further, when you're ready#

You don't need these to start — reach for them as you build. Add --help to any command for options, or --output json for scripting.

# Build from CoTrackPro libraries
cotrackpro packages pull mylib@1.2.3      # download (integrity-verified)
cotrackpro packages publish ./mylib.tgz   # publish to your org
cotrackpro scaffold reporter              # a new module, pre-wired to the SDK

# Work across the ecosystem
cotrackpro workspace clone --category core   # clone the core repos
cotrackpro workspace link                    # dev them against this CLI's SDK

# Explore the platform offline
cotrackpro artifacts search incident
cotrackpro catalog roles

Your first prototype, in five minutes#

No account needed for any of this. One command creates a typed starter, seeds its test data, and runs it:

cotrackpro nocode try incident-log            # starter + test data + a first run, in one go
cotrackpro nocode run incident-log.ctp.json --watch   # live preview while you edit
cotrackpro nocode share incident-log.ctp.json --open  # publish it as a fill-in link

Prefer dragging steps together? cotrackpro nocode build opens the visual builder — it live-previews as you edit and has the same share link. Have an idea but no app yet? cotrackpro nocode idea "track school pickup notes" --copy gives your AI assistant everything it needs to reply with a complete, importable app.

Next: build from code with the SDK, or browse the full command reference.

New to the platform? See what you can build with — workflows, scenarios, skills, and roles — in the Library.