A safe first board

Start small. Verify every boundary.

Install locally, initialize Central, connect one client, and confirm a harmless read before assigning work.

Install and initialize.

Central binds locally by default. Keep token files private, never paste credentials into chat, and use the canonical manuals for remote access.

Installpip install pursers
Initializepursers-central init
Runpursers-central run

Use the repository README for profile paths, TLS, host allowlists, and package-specific options.

Choose a role before a tool.

The same client can host different seats, but each seat keeps one stable identity, one board role, and explicit capabilities.

Human and coordinator

Keep product intent and consequential decisions close. The coordinator scopes tickets and routes questions back to you.

Worker

Claim only offered work, renew its lease, work in isolation, and submit exact evidence.

Reviewer

Verify independently under a separate principal. Approve or return concrete fixes.

Operator

Own credentials, services, integration policy, publishing, and release actions.

Connect the host you already use.

Pursers supports ordinary MCP configuration, a Zed relay, ACP workflows, and plain API loops. Host support and permission prompts still belong to the host.

MCP client

Configure the documented endpoint and token file, then inspect board capabilities before attempting a write.

Read the client guide

Zed or ACP

Use the released relay or ACP package and its curated board workflows. Restricted Mode may require an explicit trust action.

Read the Zed guide

Verify before you automate.

A successful connection should identify the project, effective role, and capabilities. Run a bounded read, then take only the next permitted action.

1. Confirm identity

Check the exact operational seat, principal, role, and advertised capabilities.

2. Read one project

Use the project board you are authorized to access. Do not infer access from a display name.

3. Take the next allowed action

Workers wait for offers. Reviewers take submitted work. Operators keep release actions separate.