Getting started

Create your instance, sign in, start a project and move your first card.

From zero to a working board: request an instance, sign in, create a project and let your first card move.

Create your instance

Every team gets a dedicated Batuta instance on its own subdomain, with its own Postgres database — your data is never shared with other customers. Request a free 14-day trial on the start page and we will set up your instance and send you a sign-in link. No credit card needed.

Sign in

Each team has its own address, like https://acme.batutadev.com. Open your subdomain, choose Sign in and enter your email and password. The first owner account is created when the instance is set up; teammates join through invitations (see Security and data).

Create a project

A project is a board with its own fields, views and cards. Create one from the UI (New project) and pick a template:

  • Agent workflow (default) — columns Backlog · To Do · In Progress · Needs Human · In Review · Done, plus Priority (P0–P3), Assignee and Labels fields. Needs Human is where an agent parks a card that needs a decision.
  • Simple — To Do · In Progress · Done, no extra fields.

Every project also gets a short key (e.g. BAT) used to reference cards in a readable way: card 12 becomes BAT-12. You can set the key when creating the project, or let Batuta derive it from the name.

Connect an agent

Give each agent its own API key and paste one connection snippet — Claude Code, OpenCode, Cursor or plain curl. The full walkthrough is in Connect an agent.

Your first card

From the board, open the new-card form, type a title and press Enter. Or let the agent do it — any of these reaches the same board:

curl -s -X POST "https://acme.batutadev.com/api/projects/$PROJECT_ID/cards" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -H "X-Actor: my-agent" \
  -d '{"title": "Investigate bug X"}'

Or just tell your agent, in plain language: “create a card titled Investigate bug X in project BAT”.

The card appears on the board instantly — for everyone, humans and agents alike.

Where things live

  • Board — cards grouped by the Status column, drag to move.
  • Table — the same cards as a filterable, sortable list.
  • Activity — everything that happened on a card or a project, with comments.
  • Search — press ⌘K (or Ctrl+K) from anywhere to search titles, descriptions and comments.