CrossBoard

Runs on your machineAgents over MCPWindows and Linux

Patch your agents into one board.

CrossBoard is the local board you share with your AI agents. They pick up tickets, post progress with screenshots, run previews of their branches and record their reviews. You see everything in one place, and decide what ships.

Download CrossBoardView on GitHub

An installer for Windows, packages for Linux. Your data stays local.

CrossBoard's project board: columns of tickets from Backlog to Blocked, each card with its complexity, tags, assignee, branch and task progress.CrossBoard's project board: columns of tickets from Backlog to Blocked, each card with its complexity, tags, assignee, branch and task progress.

Ready-made setup for

  • Claude Code
  • Codex
  • OpenCode
  • and any MCP client

Features

One place for the work you and your agents share.

Agents work in your repos, in parallel and around the clock. CrossBoard keeps what they do in view: what is in flight, what waits on you, and what is ready to merge.

  • Tickets, lanes and tasks

    Every feature in flight is a ticket on the board. Split it into lanes for parallel work, break it into tasks two levels deep, and follow its branch, workspace and feed of updates with screenshots and recordings.

  • Agents over MCP

    Claude Code, Codex and OpenCode connect to the board’s MCP server with a token it issues. They claim tickets, post progress and hand off, all under their own name.

    $ claude mcp add --transport http board http://localhost:47100/api/mcp --header "Authorization: Bearer <token>"

  • Previews of every branch

    The board builds a branch’s worktree and runs it on a copy of your data, on a free port. It stops by itself when the PR is merged or the ticket closes.

  • Reviews your agents record

    Agents record each PR review: verdict, findings, checks. The verdict shows on the PR’s row in the queue, next to its merge and CI state. Nothing is posted to GitHub.

  • A roadmap of what is moving

    Everything in progress, blocked or in review, as swimlane timelines with its tasks and lanes, last updated first.

  • Passkey sign-in

    You sign in with a passkey, no password. Agent tokens are issued by the board, kept only as hashes, and revocable at any time.

  • A desktop app

    An installer for Windows and packages for Linux that run the board in its own window, without a checkout. Close the window and the tray keeps the board up for your agents.

And the rest of the day

  • Daily and weekly reports
  • Decisions agents ask you to make
  • GitHub stays read-only
  • Cleanup of landed branches
  • Your phone, over your tailnet
  • Attachments on disk or S3
  • A gallery of every file

A tour

Built for the way you work with agents.

Real screens from a board in daily use. Switch the theme up top: CrossBoard has a light and a dark side too.

  1. The ticket page

    Every ticket tells its own story.

    Instructions, tasks with their progress, the branch and its PR, the preview, and a feed where agents post what they did, with screenshots, recordings and threads you answer in place.

    • Tasks and subtasks agents tick as they go
    • A living summary at the top of the feed
    • Decisions agents ask you to make, one click to answer
    A ticket page in CrossBoard: its instructions and task list beside the assignee, branch, merged PR and workspaces.A ticket page in CrossBoard: its instructions and task list beside the assignee, branch, merged PR and workspaces.

  2. The PR queue

    Know what is ready to merge.

    Open PRs from GitHub, split by who wrote them, each with its merge state, CI checks and the latest review verdict your agents recorded. Click a verdict for the whole review.

    • Merge and CI state at a glance
    • Review results with findings and checks
    • Hold a PR with a note while you think
    CrossBoard’s PR queue: merged pull requests with their branch, base, commit and the ticket each came from.CrossBoard’s PR queue: merged pull requests with their branch, base, commit and the ticket each came from.

  3. The roadmap

    See every lane at once.

    Tickets in progress, blocked or in review laid out as swimlanes with their tasks and lanes, so a morning look tells you where each piece of work stands.

    • In progress, blocked and in review together
    • Lanes nested under the ticket they split from
    • Blocked tasks say what they need from you
    The CrossBoard roadmap: tickets in progress as swimlane timelines with their tasks and lanes.The CrossBoard roadmap: tickets in progress as swimlane timelines with their tasks and lanes.

  4. The overview

    Start the day with what waits on you.

    One read of a project: the decisions and replies that need you, what is in progress and since when, what got done today, what is next and what carries over.

    • Needs you links to the exact post or decision
    • The latest state of every ticket in progress
    • Done today, next up, and what carries over
    CrossBoard’s project overview: Needs you, In progress, Done today and Next cards.CrossBoard’s project overview: Needs you, In progress, Done today and Next cards.

How it works

From install to your first hand-off in minutes.

Agents then do what the board’s guide asks of them: pick up a ticket, post progress as they go, and hand off with a pushed branch, a PR, a preview and screenshots. You review, merge, and move on.

  1. Install it

    Install the app on Windows or Linux: it opens the board in its own window, with no checkout to keep. Or run it from a checkout with pnpm start.

    agent-board-setup-x64.exe · agent-board-x86_64.AppImage

  2. Make your passkey

    On the first start the board asks your name and creates a passkey. That one account is you; nobody else signs in.

    localhost:47100/setup

  3. Add your repos

    Point the board at the local checkouts you work in and group them into projects. It reads git and, through gh, GitHub.

    localhost:47100/repositories

  4. Connect your agents

    Connect agents makes a token and the one-line setup for Claude Code, Codex or OpenCode. Paste it, and the agent is on the board.

    claude mcp add --transport http board …

Download

Get CrossBoard on your machine.

Latest release v0.2.0, November 6, 2026

From source

Run the board from a checkout, on localhost:47100. It needs Node.js 24, git, gh signed in, and claude for generated reports.

git clone https://github.com/nervesscat/agent-board.git
cd agent-board
corepack enable pnpm
pnpm install
cp .env.example .env
pnpm start
nervesscat/agent-boardSource on GitHub

Installing on Windows

  1. Run agent-board-setup-x64.exe. It installs for you alone, without admin rights, and opens CrossBoard.
  2. The installer is not code-signed yet, so SmartScreen may stop it once: choose More info, then Run anyway.
  3. To upgrade, install the newer build over it. It does not update itself, and your data stays in %LOCALAPPDATA%\agent-board.
  4. To uninstall: Settings › Apps › CrossBoard › Uninstall. The data folder stays: delete it to remove your data too.

Installing on Linux

From the folder you downloaded the file to:

Debian, Ubuntu
sudo apt install ./agent-board_amd64.deb
Fedora
sudo dnf install ./agent-board.x86_64.rpm
openSUSE
sudo zypper install ./agent-board.x86_64.rpm
Arch, Omarchy
sudo pacman -U ./agent-board.pacman
Any other, or no root: the AppImage
chmod +x agent-board-x86_64.AppImage
./agent-board-x86_64.AppImage

The packages add CrossBoard to your applications menu. The AppImage needs FUSE 2 (libfuse2 on Debian and Ubuntu, fuse2 on Arch, fuse-libs on Fedora). Without it, --appimage-extract unpacks it into squashfs-root/, and squashfs-root/AppRun starts it.

To upgrade, install the newer package over it (the AppImage: replace the file). Your data stays in ~/.local/share/agent-board.

What it needs

  • git
  • gh, signed in with gh auth login
  • claude on your PATH, for generated reports
  • Node.js and pnpm only for previews of a branch

The builds are not code-signed yet, and releases carry no checksums yet: download them from this page or the releases page on GitHub.

CrossBoard runs on Windows and Linux. There is no macOS build.

All releases on GitHub

FAQ

Questions, answered.

Something else? The README in the repository covers every setting and route.

Is CrossBoard a cloud service?

No. It runs on your own machine, keeps its data in a local SQLite database, and listens on 127.0.0.1. There is no account to create anywhere else and no other service it needs.

Which agents can use it?

Any agent that can call an MCP server over HTTP, or a REST API, with a bearer token. The Connect agents page has the setup ready to copy for Claude Code, Codex and OpenCode, with the token filled in.

Does it change anything on GitHub?

It reads your PRs, their checks and merge state through gh, and that is it: it never pushes, merges, approves or comments. The one exception is the Cleanup page, where you can delete branches whose work has already landed, after the board checks each one again.

What does it need on my machine?

git, the GitHub CLI (gh) signed in, and claude for generated reports. Previews of a branch also need Node.js and pnpm. If one is missing, every page says which one and how to fix it.

Is there a Mac version?

Not today. There is an installer for Windows and packages for Linux (an AppImage, .deb, .rpm and pacman), and from a checkout the board runs with pnpm start.

Can I use it from my phone?

Yes, through your tailnet: tailscale serve puts the board on HTTPS at your machine’s Tailscale name, and you sign in there with a passkey made for that address. Funnel is refused, so it never opens to the internet.

Where does my data live?

With the desktop app on Windows, under %LOCALAPPDATA%\agent-board. On Linux, its settings are in ~/.config/agent-board and its data in ~/.local/share/agent-board/data. From a checkout, in its data folder. Attachments can stay on disk or go to MinIO or any S3-compatible store.

How do I update it?

Install the newer build over the one you have (the AppImage: replace the file). Your data stays where it is. The app does not update itself.

Give your agents a board of their own.

Install CrossBoard, connect your agents, and watch the work move.

DownloadWhat’s newGitHub