camelot
Local-first cockpit for AI-agent work: Kanban cards, Markdown documents and flow insights. One Go binary with SQLite, a templ web UI, and a CLI and MCP server for agents.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/mrdhira--camelot)HTML
<a href="/listings/mrdhira--camelot"><img src="/api/listings/mrdhira--camelot/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
From a [release](https://github.com/mrdhira/camelot/releases): a single binary for Linux and macOS (amd64, arm64) with `checksums.txt`, or the image `ghcr.io/mrdhira/camelot`. From source: `go install github.com/mrdhira/camelot/services/camelot@latest` (Go 1.27.4).
camelot --vault ~/my-vault serve # http://127.0.0.1:7700
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 68 lines
- # Camelot
- A local-first cockpit for one person running a team of AI agents: a Kanban board of cards, the documents those cards build (business, product and technical requirements, OKRs, KPIs), and the facts between them. The person reads and decides in the web UI; agents record their work through a CLI or an MCP server.
- - **Cockpit:** what changed in cards and documents since you last looked, the decisions waiting for you (answered in one press, the answer recorded for the agent), what is in flight and for how long, what is blocked or stale; pages refresh themselves as agents work.
- - **Board:** seven columns (Backlog, TODO, Plan, Work, QA, Review in Progress, Done), drag-and-drop, every move recorded with who and why.
- - **Insights:** the Kanban Guide's flow measures (WIP, throughput, work item age, cycle time), open work by type and debt share, milestone progress; each number with its formula and sample size.
- - **Documents:** Markdown files with frontmatter, linked in a chain (TRD → PRD → BRD → OKR), rendered for reading, with progress from the cards that build them, the gaps in the chain and their change history.
- - **Comments:** one thread per card and per document (a document comment can name a section); agents read and answer them.
- - **Look:** a light and a dark theme, and colours that mean one thing everywhere: the design book is at `/design` and in `docs/design.md`.
- Cards and their history live in SQLite; documents stay Markdown files where they are. See `docs/adr/`.
- ## Install
- From a [release](https://github.com/mrdhira/camelot/releases): a single binary for Linux and macOS (amd64, arm64) with `checksums.txt`, or the image `ghcr.io/mrdhira/camelot`. From source: `go install github.com/mrdhira/camelot/services/camelot@latest` (Go 1.27.4).
- ```bash
- camelot --vault ~/my-vault serve # http://127.0.0.1:7700
- ```
- ## Run from this repository
- Docker (Colima), on http://camelot.localhost:
- ```bash
- make up # image + deployment/local stack: the app behind its own Caddy on 127.0.0.1:80
- make down # stop; releases the database for the native CLI
- ```
- Native, without Docker:
- ```bash
- make build # bin/camelot (Go 1.27.4, CGO off)
- bin/camelot --vault <dir> serve # http://127.0.0.1:7700 (loopback only, no sign-in)
- ```
- The Docker stack is its own compose project (`camelot-local`) and network, publishes only `127.0.0.1:80` and answers only `camelot.localhost` (any other Host: 421). SQLite's locks do not cross the Colima VM boundary, so while the container serves it owns the database (`.camelot/server.lock`): the native CLI refuses it, and agents go through `scripts/camelot`, which runs the command in the container (`docker exec`) when the stack is up and natively otherwise. See `docs/adr/ADR-003-docker-stack.md`.
- The vault is a directory holding `tasks/TASK.md` (found by walking up from the working directory when `--vault` is not set); the database defaults to `<vault>/.camelot/camelot.db`, backed up daily to `.camelot/backups/` (14 kept).
- ## Agents
- ```bash
- scripts/camelot task create --prefix DITA --title "…" --type feature --actor go-engineer
- scripts/camelot task move --id DITA-012 --status wip --note "build started" --actor go-engineer
- scripts/camelot task update --id DITA-012 --waiting "Pick A or B? A is cheaper." --actor dita
- scripts/camelot insights # JSON: every number with its formula
- scripts/camelot check # data quality; exit 1 on any problem
- ```
- MCP (stdio; protocol 2025-11-25 with initialize, and 2026-07-28 with `server/discover`), through the wrapper so it works with or without the stack:
- ```json
- { "mcpServers": { "camelot": { "command": "<repo>/scripts/camelot", "args": ["mcp"], "env": { "CAMELOT_ACTOR": "dita" } } } }
- ```
- Tools: `list_tasks`, `get_task` (with the card's open comments), `create_task`, `update_task`, `delete_task`, `list_docs`, `get_doc`, `set_doc_status`, `list_comments`, `add_comment`, `resolve_comment`, `insights`, `check`.
- ## Develop
- `make check` (the quality gate), `make e2e` (Playwright on a throwaway copy of `testdata/vault`), `make scan` (secret scan before a push). Rules: `AGENTS.md`.
- Releases: push a tag `vX.Y.Z` on `main`; `.github/workflows/release.yml` runs the checks again, then publishes the binaries (with `LICENSE.md` and `THIRD_PARTY_NOTICES.md` from `scripts/notices`) and the image.
- ## License
- Source-available under the [PolyForm Noncommercial License 1.0.0](LICENSE.md): free to read, run, change and share for any noncommercial purpose (personal use, study, research, hobby projects, noncommercial organizations). Commercial use is not licensed. Because it restricts commercial use, it is not an OSI open-source license. Third-party software in the binary keeps its own licenses (`scripts/notices`).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.