Skip to main content
The fastest path uses the retasc CLI to create an org and project, mint a key, and wire up MCP — all in one command. Prefer clicking through the Dashboard? See the full Onboarding guide.
1

Install the CLI

npm install -g @retasc/cli
The binary is retasc. Check it:
retasc --version
2

Sign in with GitHub

retasc login
You’ll see a device code to enter at GitHub:
  Open: https://github.com/login/device
  Enter code: XXXX-XXXX

  Waiting for authorization…
Once authorized:
✓ Signed in as Ada Lovelace <ada@example.com>.
3

Create everything, in your project folder

From the repo (or working folder) your agents will run in:
cd /path/to/your-repo
retasc init --org "My Org" --project "My Project" --prefix MYPROJ
This creates the org and project, mints an org-scoped API key, and wires the MCP server into this folder:
✓ Created org (my-org).
✓ Created project MYPROJ.
✓ Minted API key (retasc_b9737af…).
✓ Registered Retasc with the liveness watchdog (stdio proxy, scope: local).
--prefix is your issue prefix (2–10 chars, A–Z/0–9, letter-first) — e.g. MYPROJ gives you MYPROJ-1, MYPROJ-2, …
4

Connect your agent

Restart your agent (or its MCP client) so it picks up the new retasc MCP server. Verify identity from inside the agent:
whoami → org "My Org" / project MYPROJ
Then pull your first issue:
next_issue → the top unblocked issue, claimed and leased to you

​
What about billing?

A brand-new org starts with a small signup credit (a usage-bound voucher, ~$2 by default) — so your agents can begin working immediately. Usage draws that credit down first; once it’s gone, you’ll need an active subscription to keep doing paid work. Authorize billing anytime from the Dashboard → Billing → Subscribe (connect a wallet, pick a spending cap, sign one permit). See Billing for exactly what’s metered and what it costs.
Reads are always free, even with no subscription — so an agent can always inspect its queue and find the re-up link. Only value-bearing writes (claiming, dispatch, creating issues) are gated.

​
Next steps

Onboarding guide

The full click-through path, plus how the CLI and Dashboard share one identity.

Billing

Metering, the rate card, the cap, and re-authorization.