v6.0.2: Desktop recovery hotfix

Veritas Kanban

Task management built for AI agents — not against them

The open-source kanban board that speaks your agent's language. CLI-first, API-native, built for the age of agentic development.

⭐ Star on GitHub Get Started →

~/my-project — vk

❯ vk begin US-42 ✓ Status → in-progress ✓ Timer started ✓ Agent status → working ⋯ work happens ⋯ ❯ vk done US-42 "Added OAuth2 with PKCE flow" ✓ Timer stopped (47m 23s) ✓ Status → done ✓ Comment added ✓ Agent status → idle

The Problem

Your AI agent can write code in seconds.
But managing tasks? That's still 6 API calls and a prayer.

Every project management tool was built for humans clicking buttons. Your agent needs an API-native system that treats task management as code — not an afterthought.

🔗

API Gymnastics

6+ curl commands to move a task through its lifecycle. Status update, timer start, agent status, timer stop, completion comment, status done. Every. Single. Time.

🖱️

Built for Clicks

Jira, Linear, Notion — beautiful UIs for humans. Hostile APIs for agents. Your AI shouldn't need a browser to update a task.

🔒

Vendor Lock-in

Cloud-only, proprietary formats, pay-per-seat. Your task data locked behind someone else's API. No local dev, no file access, no control.

The Solution

Two commands. Full lifecycle.

vk begin and vk done replace 6 API calls with 2 commands.

Before — 6 separate curl calls

The old way

# Start working
curl -X PATCH .../tasks/<id> \
  -d '{"status":"in-progress"}'
curl -X POST .../tasks/<id>/time/start
curl -X POST .../agent/status \
  -d '{"status":"working"}'

# Finish up
curl -X POST .../tasks/<id>/time/stop
curl -X PATCH .../tasks/<id> \
  -d '{"status":"done"}'
curl -X POST .../tasks/<id>/comments \
  -d '{"text":"summary"}'

After — 2 commands

The Veritas way

❯ vk begin US-42
✓ Status → in-progress
✓ Timer started
✓ Agent status → working


❯ vk done US-42 "Added OAuth2"
✓ Timer stopped (47m 23s)
✓ Status → done
✓ Comment added
✓ Agent status → idle

"Automate everything you do twice."

— Boris Cherny, creator of Claude Code

Features

Everything your agent needs.

18 CLI subcommands, full REST API, MCP integration, and a beautiful UI for when you want to look at the board yourself.

🤖

Agent-First Design

Built for AI agents from day one — not retrofitted onto a human tool.

⌨️

CLI Workflow

vk begin, vk done, and 18 subcommands for full lifecycle control.

⏱️

Time Tracking

Automatic timer management. Start, stop, manual entries — all from CLI or API.

📋

Planning Phase

Plan before you execute. Subtasks, dependencies, and verification checklists.

✅

Verification Checklists

Done criteria that enforce quality. Every task has a definition of done.

🔄

GitHub Issues Sync

Bidirectional, label-based. Import issues, push status changes back.

📊

Activity Feed

Real-time, filterable chronological feed. Know what every agent is doing.

🧩

MCP Server

Model Context Protocol for Claude Desktop and any MCP-compatible assistant.

🔌

REST API

Full lifecycle management. If it can make HTTP calls, it can drive the board.

📈

Daily Standups

Auto-generated standup reports. Completed, in-progress, blocked, upcoming.

🏷️

Sprint Management

Time-boxed iterations with auto-archive, velocity tracking, and sprint filtering.

🔒

Security

API key auth, JWT, CORS, rate limiting, CSP headers, XSS prevention. Production-ready.

Compare

Built for agents. Loved by humans.

Veritas Kanban is the only task board built from the ground up for AI agent workflows.

Feature	Veritas Kanban	Jira	Linear	Plane	Planka
Open source	✅ MIT	❌	❌	⚠️ AGPL	⚠️ Fair Use
Local-first	✅	❌	❌	⚠️ Self-host	⚠️ Self-host
AI agent orchestration	✅ Native	❌	❌	❌	❌
MCP server	✅	❌	❌	❌	❌
CLI	✅	❌	✅	❌	❌
Git worktree integration	✅	❌	❌	❌	❌
Code review built-in	✅	❌	❌	❌	❌
Markdown file storage	✅	❌	❌	❌	❌
Local-first data ownership	✅	❌	❌	❌	❌
Time tracking	✅	⚠️ Addon	❌	✅	❌
REST API	✅	✅	✅	✅	✅
Free forever	✅	❌	❌	⚠️ Limits	✅

What's New

v6.0.2 Desktop Recovery And Support

🚀 Latest Release

💬

Bounded Chat Workbench

Board Chat and Squad Chat default to a right dock, switch to Bottom without remounting, clamp to the viewport, and always preserve visible recovery controls.

ℹ️

Exact Native Version Information

About and Copy Version Information expose one authoritative version, release commit, channel, operating system, architecture, and packaged-state record.

🧭

Evidence-Backed Harness Support

Buzz, Grok Build, OpenAI Codex, Claude Code, and GitHub Copilot CLI retain one reviewed support matrix, exact build evidence, and fail-closed dispatch.

⚡

Proportional Verification

Ordinary changes run focused coverage, while shared, storage, manifest, desktop, high-risk, and milestone release changes retain the full gate.

Read the v6 release notes, harness compatibility matrix, and upgrade guide.

Tech Stack

Modern. Minimal. Fast.

Local-first SQLite and file-backed storage share one abstraction, with a React web app, TypeScript API, CLI, MCP server, and native desktop shell.

⚛️

Frontend

React 19 + TypeScript
Vite + Tailwind CSS
Mantine UI foundation

🟢

Backend

Node.js + Express
WebSocket real-time
TypeScript strict mode

📄

Storage

SQLite + file adapters
Local-first by default
Governed backup and restore

🧪

Testing

Vitest unit coverage
Playwright E2E coverage
CI/CD with GitHub Actions

Quick Start

Up and running in 60 seconds.

Clone, install, run. The board auto-seeds with example tasks so you can explore immediately.

Terminal

❯ git clone https://github.com/BradGroux/veritas-kanban.git ❯ cd veritas-kanban ❯ pnpm install && pnpm dev ✓ Board running at http://localhost:3000 ✓ API running at http://localhost:3001

Or ask your AI agent: "Clone and set up veritas-kanban locally."