bybradgroux· 1 MCP server
Lightweight orchestration harness built for your AI agents. The unfiltered truth about where your project stands.
$git clone https://github.com/bradgroux/veritas-kanbanInstalls into the current project.
Install veritas-kanban by running `git clone https://github.com/bradgroux/veritas-kanban`, then use it for the current task and follow its documentation at https://github.com/bradgroux/veritas-kanban.
| 1 | <div align="center"> |
| 2 | |
| 3 | # ⚖️ Veritas Kanban |
| 4 | |
| 5 | _Veritas in actis — Truth in action._ |
| 6 | |
| 7 | **Local-first task management board with optional AI agent orchestration.** |
| 8 | |
| 9 | Start with a visual Kanban board. Add CLI, MCP, OpenClaw, Squad Chat webhooks, workflows, or governance only when you need that layer. |
| 10 | |
| 11 | [](https://github.com/BradGroux/veritas-kanban/actions/workflows/ci.yml) |
| 12 | [](LICENSE) |
| 13 | [](CHANGELOG.md) |
| 14 | [](https://www.typescriptlang.org/) |
| 15 | [](CONTRIBUTING.md) |
| 16 | |
| 17 |  |
| 18 | |
| 19 | > 🎬 [Watch the full demo video](https://bradgroux.github.io/veritas-kanban/demo/) |
| 20 | |
| 21 | ⭐ **If you find this useful, star the repo — it helps others discover it!** |
| 22 | |
| 23 | [Quickstart](#-quickstart) · [Features](#-feature-highlights) · [Why VK](#-why-veritas-kanban) · [All Features](docs/FEATURES.md) · [Docs](docs/) · [Troubleshooting](docs/TROUBLESHOOTING.md) · [API](#-api-versioning) · [Agent Setup](#-optional-agent-integration) · [MCP Server](#-mcp-server) · [Contributing](CONTRIBUTING.md) · [Changelog](CHANGELOG.md) |
| 24 | |
| 25 | </div> |
| 26 | |
| 27 | --- |
| 28 | |
| 29 | Created by **Brad Groux** — CEO of [Digital Meld](https://digitalmeld.io), and host of the [Start Small, Think Big](https://podcasts.apple.com/us/podcast/start-small-think-big-a-podcast-and-newsletter/id1802232903) podcast · [LinkedIn](https://www.linkedin.com/in/bradgroux/) · [Twitter](https://twitter.com/BradGroux) · [YouTube](https://www.youtube.com/bradgroux) |
| 30 | |
| 31 | --- |
| 32 | |
| 33 | ## ⚡ Quickstart |
| 34 | |
| 35 | Start with the local board. OpenClaw, MCP, Squad Chat webhooks, notifications, workflows, and governance gates are optional layers you can turn on later. See [Setup Paths](docs/SETUP-PATHS.md) for the board-only, CLI, MCP, OpenClaw, and self-hosted paths. |
| 36 | |
| 37 | Want to take the easy way out? Ask your agent: |
| 38 | |
| 39 | ``` |
| 40 | Clone and set up veritas-kanban locally using the board-only setup path first. Install dependencies with pnpm, copy server/.env.example to server/.env, and start the dev server. Verify the UI at localhost:3000 and the API health endpoint at localhost:3001/api/health. Do not configure OpenClaw, MCP, Squad Chat webhooks, workflows, or notifications unless I explicitly ask for that layer. |
| 41 | ``` |
| 42 | |
| 43 | Want to do it yourself? Get up and running in under 5 minutes: |
| 44 | |
| 45 | For the packaged Mac desktop app: |
| 46 | |
| 47 | ```bash |
| 48 | brew tap BradGroux/tap |
| 49 | brew install --cask veritas-kanban |
| 50 | ``` |
| 51 | |
| 52 | For local source development: |
| 53 | |
| 54 | ```bash |
| 55 | git clone https://github.com/BradGroux/veritas-kanban.git |
| 56 | cd veritas-kanban |
| 57 | pnpm install |
| 58 | cp server/.env.example server/.env # Edit to change VERITAS_ADMIN_KEY |
| 59 | pnpm dev |
| 60 | ``` |
| 61 | |
| 62 | Open [http://localhost:3000](http://localhost:3000) for source runs, or install |
| 63 | the signed/notarized Mac app with |
| 64 | `brew tap BradGroux/tap && brew install --cask veritas-kanban`. The board |
| 65 | auto-seeds with example tasks on first run so you can explore right away. |
| 66 | |
| 67 | A working board means the UI loads and `http://localhost:3001/api/health` returns healthy. Agent-ready and external wake/delivery-ready are separate setup levels; use [Setup Paths](docs/SETUP-PATHS.md#readiness-levels) before adding those layers. |
| 68 | |
| 69 | **Do not configure these on day one unless you already know you need them:** |
| 70 | |
| 71 | - OpenClaw gateway or browser relay |
| 72 | - MCP write access |
| 73 | - Squad Chat webhook or external wake behavior |
| 74 | - Notification delivery channels |
| 75 | - Workflow gates or governance policies |
| 76 | |
| 77 | When the board is working, use [Setup Paths](docs/SETUP-PATHS.md) to choose the next layer and run the read/write smoke checks before handing the board to an assistant. |
| 78 | |
| 79 | > **Want a clean slate?** Delete the example tasks: `rm tasks/active/task_example_*.md` and refresh. |
| 80 | > **Want to re-seed?** Run `pnpm seed` to restore the e |