PHPackages                             voku/agent-kanban - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. voku/agent-kanban

ActiveLibrary[Utility & Helpers](/categories/utility)

voku/agent-kanban
=================

Markdown TODO Kanban parser, renderer, and verifier for coding-agent workflows.

0.2.1(1w ago)03061MITPHPPHP ^8.3CI passing

Since Jun 9Pushed 1w agoCompare

[ Source](https://github.com/voku/agent-kanban)[ Packagist](https://packagist.org/packages/voku/agent-kanban)[ Docs](https://github.com/voku/agent-kanban)[ RSS](/packages/voku-agent-kanban/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (8)Versions (6)Used By (1)

agent-kanban
============

[](#agent-kanban)

A strict PHP library and CLI for **Git-native, coding-agent Kanban boards**: human-readable and human-editable Markdown card files, one file per task, deterministic parsing and verification, safe conflict-aware mutations, and machine-readable (JSON) output for coding agents and CI.

Local-first, offline-capable, auditable through Git, and independent of any specific LLM or coding-agent provider.

What this is
------------

[](#what-this-is)

- A typed PHP API (`docs/php-api.md`) plus a standalone CLI (`vendor/bin/agent-kanban`, `docs/cli.md`) for reading, verifying, rendering, and safely mutating a Kanban board made of Markdown card files.
- A normative card format (`docs/card-format.md`): one Markdown file per card, `- **Field:** value` bullet metadata, deterministic serialization.
- A configurable board policy (`docs/configuration.md`): lanes, statuses, WIP limits, required fields, transitions — nothing project-specific is hard-coded into the engine.
- Optional, credential-free comparison against an external tracker like Jira (`docs/external-issues.md`) — bring your own adapter, no network code shipped in this package.
- A stable foundation to build on: a UI, `voku/agent-loop`'s session orchestration, or your own tooling, all consuming the same typed contracts (`docs/agent-loop-integration.md`).

What this is not
----------------

[](#what-this-is-not)

- Not an agent execution platform: it does not start, run, or talk to LLMs or coding agents.
- Not a UI: no browser, desktop app, or drag-and-drop board.
- Not a database: no SQLite/Postgres/server, no event sourcing, no WebSockets, no terminal streaming.
- Not Git worktree orchestration or PR automation.
- Not session memory, recall compilation, learning extraction, or cross-package workflow governance — that's `voku/agent-loop`'s job.

See `docs/architecture.md` for the full design and `docs/PLAN.md` for the reasoning behind these boundaries.

Installation
------------

[](#installation)

```
composer require voku/agent-kanban
```

Requires PHP 8.3+.

Five-minute setup
-----------------

[](#five-minute-setup)

```
mkdir -p todo/cards
cat > todo/cards/ABC-1.md