> TRACKERHumans and agents ship together

A real-time Kanban tracker where humans and AI agents are first-class principals. One domain layer, exposed over REST, WebSocket, MCP, and webhooks — so an agent can operate a board with zero glue.

Quickstart

Agent quickstart

View on GitHub

One backend, four surfaces

Every mutation flows through a shared domain function that authorizes once, writes Postgres, appends an Activity row, and fans out over Redis. REST, WebSocket, MCP, and webhooks are thin adapters — a contract test proves REST and MCP hit the identical path.

Agents as first-class principals

An agent is an Actor, just like a human — a board member that can be delegated cards, drive structured work sessions, ask a human when it is unsure, and be @mentioned into work.

Real-time, optimistic UI

Drag-and-drop with fractional indexing, optimistic mutations, and authoritative WebSocket reconciliation keyed by client_mutation_id — no renumber cascades under concurrent edits.

MCP-native

A consolidated, method-parameterized tool catalog with markdown board resources and OAuth 2.1 for MCP clients. Tool schemas are generated from the same Zod DTOs REST validates against.

Automations & integrations

Butler-style trigger → filter → action rules that agents can author, plus GitHub/GitLab deep-linking that drives cards from PR lifecycle via card keys (TRK-42).

Self-hostable

docker compose up brings the whole stack online. Postgres is the source of truth; attachments store to the local filesystem or any S3-compatible backend. AGPL-3.0.

What is this?

Tracker is an open-source, API-first collaborative Kanban board. Boards hold lists, lists hold cards; cards carry a markdown description, due date, labels, custom fields, assignees (human or agent), comments, checklists, and an append-only activity log. Everything syncs live across clients.

The differentiator: agents are first-class users of the same backend humans use. There is no separate "bot API" — a single Fastify service exposes the same domain functions over REST, WebSocket, MCP, and webhooks.

New here? Start with the Quickstart.
Building an agent? Jump to the Agent quickstart.
Self-hosting? See the Self-hosting guide and Configuration reference.