Cairn

by shahrammebashar

Not rated
GitHub

About

About A repo-native task graph as plain Markdown files, served to AI agents over MCP and to humans over a clean web UI .

Details

Author
shahrammebashar
Categories
Productivity, Project Management, Knowledge Base, Automation

Setup

Install Cairn in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/shahrammebashar/cairn

Follow the installation instructions in the repository README, then restart your MCP client.

Repo-native task management. One task graph your agents and you share.

Download·Documentation·Connect an agent·SPEC·Changelog

cairn is a task graph that lives asMarkdown files in your repository. A single Go binary (cairn) serves it to AI agents overMCPand to humans over a clean web UI. One source of truth: the files. One rule-set:internal/task. No database.

- Lives in your repo.A task is Markdown (YAML frontmatter for the machine, a prose body for humans). Tasks branch, merge, and review like code; a task's historyisits git history.
- Built for agents.Agents list ready work, claim it, run an observable session with heartbeats, and hand off for review. Every write is stamped with the actor that made it.
- One rule-set, two front-ends.The web UI and the MCP server are thin adapters over the same engine, so an agent and a human always see the same gates and the same readiness.
- Connect any agent in one click.The Connect page detects installed agents and writes their MCP config for you, each under its own identity.

make build # -> bin/cairn cairn web --repo . # open the board in your browser

Then open theConnectpage and wire up an agent in one click, or do it by hand:

claude mcp add cairn -- "$(pwd)/bin/cairn" serve --actor agent:claude --repo "$(pwd)"

Full walkthrough:InstallationQuickstart.

One-click connect forClaude Code, Cursor, Codex, Windsurf, OpenCode, Kilo Code, and Pi; a copy-paste guide forAntigravityand any other MCP client. See theAgents guide.

make check # gofmt + go vet + go test ./... make web-dev # Vite dev server (proxies /api -> :8080) make desktop-dev # native window against a dev server

This repo dogfoods cairn: its own work is tracked in.cairn/. SeeAGENTS.mdand.cairn/WORKFLOW.md.

cairn is alocal, single-usertool with no authentication by design. SeeSECURITY.mdfor the trust model and how to report a vulnerability.

A read-only server for accessing Atlassian products like Confluence and Jira.

Decispher captures the decisions, conventions, and constraints from the conversations your team is already having in Slack, GitHub, GitLab, and Jira, then serves them back to every human and every agent that needs them. Automatically.

An MCP server with integrations for GitLab, Jira, Confluence, and YouTube, providing AI-powered search and development utility tools.

Create notes, search, & think with your Fabric AI workspace

Perform queries and entity operations in your Fibery workspace.

Official Notion MCP server for searching, reading, creating, and updating Notion pages, databases, and workspace content from AI agents.

Keep teams & agents coordinated automatically

Connect to the Taskade platform via MCP. Access tasks, projects, workflows, and AI agents in real-time through a unified workspace and API.

A universal remote MCP server that connects to popular productivity tools such as Notion, Monday, AirTable, and many more.

advanced-math-mcp — MCP server for linear algebra, calculus, and symbolic math. 17 tools with a unified evaluate() expression engine. Supports matrices, eigenvalues, SVD, integrals, limits, derivatives, and more.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.