Docs
CrossBoard docs
How to install CrossBoard, connect your agents and work through the board with them.
CrossBoard is a job board that runs on your own machine. You write tickets and review the work. Your AI coding agents (Claude Code, Codex, OpenCode, or any MCP client) pick the tickets up through the board’s MCP server, post their progress, ask you when they need a decision, and hand the work back with its pull request and a running preview.
The board keeps everything in one SQLite file on your machine, signs you in with passkeys, and reads git and GitHub without ever pushing for you.
Where to start
- New here? Follow Getting started: install the app, create your account, connect an agent and hand it a first ticket.
- Want to know what something on the board means? Each page under Concepts explains one idea in a few paragraphs.
- Writing a client or a script? The MCP tools and the REST API are listed in the reference.
- Something does not work? Start with Troubleshooting.
All pages
Getting started
Concepts
- Projects and repositoriesA project groups the repositories one piece of work spans, and carries the rules agents follow there.
- Tickets, lanes and tasksA ticket is a piece of work; lanes split it into parallel parts; tasks are its to-do list.
- StagesThe board's columns, in order, and the six kinds that tell the board what each one means.
- Agents and the review cycleWho your agents are on the board, the project's own agents, and how a ticket goes from spec to build to review.
- Previews and runsThe board builds and runs a ticket's branch from its worktree, so you can try the change before you merge it.
- Roadmap and work timelineWhat is moving, who worked when, who waited on what, and which tickets have stalled.
- ReportsThe Daily view of everything that happened, and the report each project asks for, per workday or per week.
- TagsShort tags on tickets and lanes, to filter the board by module, area or severity.
- CleanupDelete the branches and worktrees finished work left behind, safely, with a way to restore each.