Repolode
Submit
BradGroux

BradGroux/veritas-kanban

Local-first Kanban task board with optional AI agent orchestration, Markdown storage, Git worktrees, and a CLI and MCP server.

Open-source alternative to:JiraLinear

View on GitHubWebsite
Stars
844
Forks
100
Open issues
49
Last commit
19 hours ago

What is it?

Veritas Kanban is a task management board that runs locally and stores tasks as Markdown files with YAML frontmatter, settings as JSON, and workflows as YAML. A visual drag-and-drop Kanban board works on its own, and agent orchestration, a CLI, an MCP server, Squad Chat webhooks, workflows and governance gates can be enabled as separate layers when needed.

For teams running AI coding agents, the project tracks agent runs in real time, assigns multiple agents to a task, and gives each task its own Git worktree with a built-in diff viewer, approval flow and GitHub PR creation. A YAML workflow engine supports sequential, parallel, loop and gate steps, and a policy engine can allow, deny or require approval for agent actions. Codex, OpenClaw, Claude Code and other runtimes are supported through provider profiles.

The backend is an Express server with a REST API and WebSocket updates, and the frontend is React 19 with Vite. The project is written in TypeScript, licensed under MIT, and can be installed as a Homebrew cask on macOS or run from source with pnpm.

Key features

  • 01Drag-and-drop Kanban board with tasks stored as Markdown files
  • 02Per-task Git worktrees with diff review, approvals and GitHub PR creation
  • 03Multi-agent orchestration with live run status and Squad Chat messaging
  • 04YAML workflow engine with sequential, parallel, loop and gate steps
  • 05Policy engine for allow, deny and approval rules on agent actions
  • 06MCP server, CLI and REST API for driving the board from other tools

Use cases

  • Tracking tasks on a single developer machine without a hosted service
  • Coordinating several AI coding agents working on different tickets in separate worktrees
  • Reviewing and approving agent-generated code before it is merged
  • Building multi-step agent pipelines that need human approval gates

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/BradGroux/veritas-kanban.git
  2. 2

    Enter the project folder

    cd veritas-kanban
  3. 3

    Install dependencies with pnpm

    pnpm install
  4. 4

    Start the dev server and open localhost:3000

    pnpm dev

Things to know

  • Requires Node.js tooling and pnpm for source setup.
  • The packaged desktop app is distributed via Homebrew for Mac.

Topics

#kanban#task-management#ai-agents#agent-orchestration#local-first#typescript#react#mcp#agents#codex

FAQ

What is veritas-kanban?
Local-first Kanban task board with optional AI agent orchestration, Markdown storage, Git worktrees, and a CLI and MCP server. Veritas Kanban is a task management board that runs locally and stores tasks as Markdown files with YAML frontmatter, settings as JSON, and workflows as YAML. A visual drag-and-drop Kanban board works on its own, and agent orchestration, a CLI, an MCP server, Squad Chat webhooks, workflows and governance gates can be enabled as separate layers when needed.
Is veritas-kanban free to use? What license does it have?
veritas-kanban is open source under the MIT license. Check the license terms before using it in commercial products.
Is veritas-kanban still maintained?
Actively maintained. The last commit to veritas-kanban was on Oct 21, 2026.
What can I use veritas-kanban for?
Tracking tasks on a single developer machine without a hosted service Coordinating several AI coding agents working on different tickets in separate worktrees Reviewing and approving agent-generated code before it is merged Building multi-step agent pipelines that need human approval gates
How do I install veritas-kanban?
Clone the repository: git clone https://github.com/BradGroux/veritas-kanban.git Enter the project folder: cd veritas-kanban Install dependencies with pnpm: pnpm install Start the dev server and open localhost:3000: pnpm dev
Where can I get veritas-kanban?
The source code and installation instructions are on GitHub: https://github.com/BradGroux/veritas-kanban

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects