Quickstart

Install from source and run your first agent command in under 5 minutes.

Install

You need Node.js 20.18+ and pnpm 10+.

git clone https://github.com/TokenDanceLab/TokenDanceCode.git
cd TokenDanceCode
pnpm install
pnpm verify
pnpm --filter @tokendance/code-cli build
tokendance doctor
tokendance run "hello"

pnpm verify runs typecheck, lint, test, and contract checks to confirm your environment is ready. tokendance doctor prints the current runtime status, detected providers, and any config issues.

No API key?

The CLI ships with MockProvider — no keys needed to validate your install, run SDK smoke tests, write transcripts, and verify package integrity. Great for a first dry run and CI environments.

tokendance quickstart
tokendance doctor --json
tokendance run "hello from mock"

Once you have real keys, inject them via environment variables to switch to an actual provider. See Providers for details.