Download the PHP package voku/agent-kanban without Composer
On this page you can find all versions of the php package voku/agent-kanban. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download voku/agent-kanban
More information about voku/agent-kanban
Files in voku/agent-kanban
Package agent-kanban
Short Description Markdown TODO Kanban parser, renderer, and verifier for coding-agent workflows.
License MIT
Homepage https://github.com/voku/agent-kanban
Informations about the package 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
- 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:** valuebullet 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
- 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
Requires PHP 8.3+.
Five-minute setup
That's a complete, working board: no todo/board.md, no config file
required (the project prefix ABC is inferred from the card filename).
Add a todo/kanban.config.json once you want to customize lanes, WIP
limits, or required fields — see docs/configuration.md.
Card file example
Full field reference, escaping rules, and invalid-input behavior:
docs/card-format.md.
Main CLI commands
Full command reference, options, and exit codes: docs/cli.md.
Small JSON for coding agents
A full card object carries every field a card file holds, including the
unbounded task brief. When the reader is a language model, --fields= and
--compact cut a board listing down to what the caller actually reads:
The reduced document is a documented subset of the same card shape — same
schemaVersion, same envelope, same key order, id always present — so one
parser handles both. See docs/cli.md and docs/json-format.md.
Basic PHP usage
Mutating a card:
Full API tour: docs/php-api.md.
Compatibility
todo/cards/(preferred) andtodo/jira/(legacy) are both read;todo/cards/wins in full when both exist. Existing 0.x card files — including the legacyFitfield andNext pull rankfield — keep parsing without any migration.- No card file is ever silently rewritten into a new format by reading it.
- The pre-1.0
TodoBoardSource/TodoBoardVerifier/TodoBoardCliPHP classes and their generated-Markdown-based CLI are removed, not deprecated — this project has one known consumer (voku/agent-loop) and the maintainer chose a clean break over carrying that implementation forward. SeeUPGRADING.mdfor the direct replacement for each removed class and CLI command.
Documentation
docs/architecture.md— data flow and designdocs/card-format.md— the card file specificationdocs/configuration.md—BoardConfigreferencedocs/cli.md— full CLI command/option/exit-code referencedocs/php-api.md— PHP API tourdocs/json-format.md— versioned JSON output shapesdocs/concurrency.md— transitions, claims, atomic writesdocs/external-issues.md— optional Jira-style syncdocs/agent-loop-integration.md— integrating withvoku/agent-loopdocs/legacy-operating-prompt.md— the removed pre-1.0 operating-prompt prose, preserved foragent-recall-compilerdocs/troubleshooting.md— common errors and fixesUPGRADING.md— migrating from 0.xSECURITY.md
Development
All versions of agent-kanban with dependencies
ext-mbstring Version *