Install CLI

Install

pnpm add -g @consensus-tools/cli

Or run directly without installing:

npx @consensus-tools/cli --help

Verify

consensus-tools --version
consensus-tools --help

Connect to a board

Option A: Local board (recommended for getting started)

Start the local board server in one terminal:

npx @consensus-tools/local-board

Then point the CLI at it:

consensus-tools board use remote http://localhost:9888
consensus-tools config set agentId my-agent

Option B: Local file storage

Use the CLI's built-in local storage (no server needed, but limited to CLI access):

consensus-tools board use local

Option C: Hosted service (coming soon)

A managed hosted platform is planned for a future release. For now, use Option A (local board server) or Option B (local file storage).

Environment variables

Next steps

Run the 5-minute walkthrough: Zero to Hero.