Kanban

Overview

The Kanban plugin provides a Kanban board for organizing work as tasks with statuses like Todo, In Progress, and Done. It integrates with the agent system so agents can manage tasks directly from chat, and the platform automatically monitors task activity for follow-up alerts.

Installation

The Kanban plugin is installed and managed through the Skills page (/skills in the web UI). Once installed, the Kanban skill appears in the skill registry and can be enabled for any agent.

Permission Settings

The Kanban plugin supports fine-grained permission controls. For each agent, you can toggle the following permissions:

Permission	Description
Create	Whether the agent can create new tasks on the board
Edit	Whether the agent can modify existing tasks (title, description, priority, status)
Delete	Whether the agent can delete tasks from the board

These permissions are configured per-agent in the agent’s Tools tab (or equivalent skill assignment interface). A disabled permission prevents the agent from performing the corresponding action.

Skill-Based Notifications

Changed in v0.2.0

Previously, notifications were configured via a manual ELIGIBLE_AGENTS list in the plugin config. Starting from v0.2.0, eligibility is automatically determined by the kanban skill.

Agent notifications (stale task reminders, follow-up alerts, new task assignments) are now sent to agents that have the Kanban skill assigned. No manual configuration needed:

• Kanban skill assigned → agent receives notifications
• Kanban skill removed → agent stops receiving notifications
• Super agent → always eligible regardless of skill assignment

This replaces the old ELIGIBLE_AGENTS config field, which is now deprecated and kept only for backward compatibility.

Comment Follow-up Monitor

When the Kanban plugin is active, the platform automatically monitors comments on tasks for follow-up activity:

• Auto-clear on task pick: When a task is moved to In Progress, its prior comment context is automatically cleared so the agent starts fresh when picking up the task.
• Follow-up alerts: If a task receives a new comment after being picked up, the monitor detects the follow-up and triggers a notification to eligible agents (those with the kanban skill).

This ensures agents don’t get stale context when starting work on a task, and that new discussion on tasks doesn’t go unnoticed.

Kanban Tools

Agents with the Kanban skill can use the following tools to interact with the board programmatically:

Task Management Tools

Tool	Description
kanban_search_tasks	Search and list tasks with filters (assignee, status, query)
kanban_get_task	Retrieve a single task by its ID
kanban_create_task	Create a new task on the board
kanban_update_task	Update a task’s status, assignee, title, description, or priority
kanban_delete_task	Delete a task (super agents can delete directly; regular agents need approval)

Changed in v1.5.6

Tasks now require an assignee before they can be started. A task with no assignee can’t be moved to In Progress — assign it to an agent (or yourself) first. This keeps the board from accumulating unowned work that silently goes in-progress.

Comment Tools

Tool	Description
kanban_add_comment	Add a progress note or comment to a task
kanban_get_comments	Retrieve paginated comments from a task

kanban_add_comment

Adds a progress note, sub-step result, or finding to a Kanban task. Comments are visible on the board and can trigger follow-up notifications.

kanban_add_comment(task_id: "183", content: "Started data collection phase")

Parameters:

Parameter	Required	Description
task_id	Yes	The ID of the task to comment on
content	Yes	The comment content (text)

kanban_get_comments

Introduced in v0.2.6.

Retrieves comments from a Kanban task with pagination support. Comments are ordered newest first.

kanban_get_comments(task_id: "183", limit: 10, offset: 0)

Parameters:

Parameter	Required	Default	Description
task_id	Yes	—	The ID of the task to retrieve comments from
limit	No	10	Maximum number of comments to return (max: 100)
offset	No	0	Number of comments to skip (for pagination)

Example — first page:

kanban_get_comments(task_id: "183", limit: 5, offset: 0)

Returns:

{
  "comments": [
    {
      "id": 441,
      "task_id": 183,
      "content": "Started data collection phase",
      "author": "adit",
      "created_at": "2026-05-11T10:00:00Z"
    },
    {
      "id": 440,
      "task_id": 183,
      "content": "Task assigned for review",
      "author": "system",
      "created_at": "2026-05-11T09:55:00Z"
    }
  ],
  "total": 12,
  "limit": 5,
  "offset": 0
}

Example — next page:

kanban_get_comments(task_id: "183", limit: 5, offset: 5)

Table View

Introduced in v1.6.0.

Cards are great for a dozen tasks and painful for three hundred. The board header now has a view switch: Board for the familiar columns, Table for a dense grid of every task.

The table is built for bulk work:

• Column filters — filter by Status (including an Active (no archived) default), Priority, Assignee, and Dependencies (Blocked (deps unmet) or No unmet deps). Reset filters clears them all.
• Pagination — choose 10, 25, 50, or 100 rows per page, with a summary line above the pager.
• Selection — click a row’s checkbox; hold Shift to select a range, Ctrl/⌘ to add one row, or drag across checkboxes to toggle several.
• Bulk actions — with rows selected, a bar appears above the table: Move to (Todo / In Progress / Done), Priority, Assign to, Archive, Unarchive, and Delete. Selection survives pagination — the bar tells you how many selected tasks sit on other pages.

Example: reviewing a backlog after a sprint.

1. Switch to Table.
2. Set Status: Active (no archived) and Dependencies: Blocked (deps unmet).
3. Tick the tasks that are stuck, then use Assign to to hand them to one agent.
4. Clear the filters and switch back to Board to watch the cards move.

Nothing is table-only: creating, editing, and commenting on a task works the same in both views.

Attachments

Introduced in v1.1.2.

Kanban tasks now support image and comment attachments. When creating or updating a task, agents and users can attach files directly to the task card for richer context.

Image Attachments

The task image picker has been modernized with a clean UI for uploading and previewing images attached to tasks. Images appear inline on the task card and are viewable from the board.

Comment Attachments

Files can also be attached to individual comments. This is useful for sharing screenshots, logs, or reference documents as part of a progress update — keeping all task-related artifacts in one place.

AI Task Enhancer

The built-in AI task enhancer now outputs in English by default, helping standardize task descriptions across multi-language teams. It analyzes the task title and description to suggest a clearer, better-structured version.

Live Activity Feedback

Introduced in v1.3.0.

Every time the agent assigned to a task calls a tool, the task’s title flashes — yellow by default, for about a second, then fading back. This gives you at-a-glance confirmation on the board that an agent is actively working on a task, without opening the task to see progress.

The flash is driven by the durable kanban realtime (SSE) channel, so it updates live while you’re viewing the board. The flash color and duration are plugin defaults (yellow, ~1 second).

API Endpoints

The Kanban plugin exposes REST endpoints for programmatic access. See the Plugin SDK for details on available endpoints and request/response formats.