Skip to content
Browse docs
Docs / Start here

Quick start

Connect your agent, ask what to work on, make your first call.

01 Connect your agent

claude mcp add --transport http annsa https://app.annsa.ai/mcp

Run it in your terminal. Then, in Claude Code, run /mcp, pick annsa and choose Authenticate.

Cursor or VS Code? Add it in one click:Add to CursorAdd to VS Code

Pick your agent on Connect your agent and run its command. You sign in once in the browser, and there's nothing to install. Your agent signs in as you. Read about the two kinds of sign-in and who does what.

Paste this to your agent and it sets itself up.

Set up Annsa for this agent using annsa.ai/setup.md, then start the sign-in.

02 Choose what runs without asking

Five Annsa tools can change things. Let annsa.work and annsa.file run without asking. Approve annsa.decide, annsa.board and annsa.share each time, because they change what you decided or what your customers hear.

Allow without asking:

  • annsa.work: Do the work on a priority, and settle routine asks with undo.
  • annsa.file: Add what a customer said, what an agent found, or a new idea.

Approve each time:

  • annsa.decide: Record a decision: your answer, a spec edit, or a rule.
  • annsa.board: Arrange the board. A merge retires numbers for good.
  • annsa.share: Tell the customers who asked that it shipped. Emails can't be unsent.

The reads (annsa.priorities, annsa.spec, annsa.ask) change nothing, so allow those too. Every tool.

Your call: what your agent does without asking.

03 Your agent learns the ropes

When it connects, your agent fetches Annsa's skills: how to work with Annsa, how to write its part of a spec, and how to ask you. Read them.

04 Ask what to work on

Ask your agent: what should I work on? It gets your ranked list. Each priority shows why it ranks where it does, who asked, and what's waiting. On a new workspace, it starts with a welcome instead.

05 Bring in what you know

Connect where your customers already talk to you, import your roadmap and add your ideas. Your agents add what they find while they build. It all lands in one list. Bring things in.

Your call: where to start.

06 Connect GitHub

This step is optional. You can do it later. Connect your repository so specs name real files and your work stays linked to its PRs. Annsa never writes code. GitHub.

07 Make your first call

Annsa ranks the work and shows why. You choose: put a priority on a bet, sign it, or park it with a reason.

Your call: what's worth building now.

08 Hand it to your agent

Tell your agent to pick it up. It claims the priority, reads the spec, builds, and asks you when a call is yours. How the work flows.

Next guideHow the work flowsImporting feedback