Skip to content

bumpcore/trackboi

Repository files navigation

trackboi

No bullshit kanban for agents and people.

trackboi is a local-first desktop kanban app with an MCP server built in. It is 100% local and git based: your boards, cards, tracks, notes, and agent handoffs live on disk beside the work instead of disappearing into somebody else's SaaS.

Quick setup for agents

Install trackboi, then run this in any repo where you want agents to use it:

trackboi install --all

That writes a repo-local .mcp.json, installs the trackboi skill under .agents/skills/trackboi, and adds managed AGENTS.md guidance. The MCP server command it installs is:

trackboi mcp

After that, restart or reload your agent client so it picks up the new MCP server.

Why

  • Plan work with people and agents in the same place.
  • Keep task state in the repo, close to the code.
  • Use trackboi as a desktop app, a CLI, or an MCP server for agent workflows.
  • Own the files. Move them, diff them, back them up, commit them.

Install

Download the latest release artifact for your OS from GitHub Releases.

  • Linux: AppImage, RPM, or DEB
  • macOS: DMG or ZIP
  • Windows: NSIS installer or ZIP

Or run the latest-release installer:

curl -fsSL https://raw.githubusercontent.com/bumpcore/trackboi/master/scripts/install.sh | sh

Windows PowerShell:

iwr https://raw.githubusercontent.com/bumpcore/trackboi/master/scripts/install.ps1 -UseB | iex

The first public builds are unsigned, so macOS and Windows may show trust warnings.

Development

trackboi uses Bun, Vue, Electron, and electron-builder.

bun install
bun run dev

Run checks and tests:

bun run check
bun test

Build local packages:

bun run dist:linux
bun run dist:mac
bun run dist:win

Platform packages are written to release/.

MCP

Run the local MCP server:

trackboi mcp

trackboi's MCP tools use the same local project state as the desktop app, so agents can create cards, update tracks, write notes, and leave handoffs without a remote service.

See docs/usage-guide.md for storage layout, onboarding, and MCP setup examples for common clients.

License

MIT

About

Zero bullshit. 100% local kanban for you and your agents.

Resources

License

Stars

Watchers

Forks

Contributors