Overview

iKanban AI is a macOS app for running a project with a terminal agent. The agent (Claude Code or any other) does its work in the repository; the app renders that same repository for you, the owner: the kanban board, the plans, the skills and tools, the project actions. Nothing lives only in the app — every ticket, plan, and setting is a plain file under .agent/, committed with your code.

The division of labor

You decide what gets built, answer the agent’s questions, and review the results — from the app.
The agent slices plans into tickets, works them one at a time, and writes down what it did — from the terminal.
The repository is the single shared state. The app picks up file changes on its own: when the agent moves a ticket, your board moves; when you answer a question in a ticket, the agent’s next run sees it.

The contract between the two sides is .agent/AGENT.md — written and versioned by the app, read by every agent. Files like CLAUDE.md and AGENTS.md just point to it, so any agent product lands in the same workflow.

What the app shows

The board — tickets in Backlog, Doing, Done; per-ticket history; badges for tickets that wait on you.
Plans — the markdown plans under .agent/plans/, with exactly one active at a time; work is sliced from it.
Skills & tools — what the agent can do here, including skills expanded from Speccify sources.
Actions — project commands you can run from the toolbar, executed by a local, allowlisted exec server.

Start with the board — it is where a normal day happens.