Kanban Board

A beautiful, local web interface for tracking and managing your issues.

←Back to Kanban Board feature page

Sometimes you need a visual representation of your project state. Kanbus includes a fast, local Kanban board interface powered by React and Rust. It reads directly from your local JSON files and updates in real-time as you make changes via the CLI or UI.

Starting the Console

You can start the Kanban console easily from your terminal. It will open a local web server (usually at http://127.0.0.1:5174/).

Terminal
# If you are developing locally:
./dev.sh

# Using the pre-compiled binary:
kanbus console

UI Interactions

Once the board is running, you can open your browser to view it. The interface supports a variety of interactions:

  • Filtering: Click on user avatars, toggle issue types (e.g., Bugs, Epics), or filter by priority.
  • Editing: Click on any issue card to open the detail panel, where you can modify the description, assignee, status, and more.
  • Real-time Sync: The board leverages Server-Sent Events (SSE). If you update an issue using the CLI, the board instantly reflects the changes.

Note: Drag-and-drop between columns is not currently implemented. Status changes are made via the detail panel or CLI commands, and cards automatically sort into the correct columns.

CLI Console Helpers

Kanbus provides special CLI commands to interact with the console UI programmatically, which is exceptionally useful for automation or AI agents.

Terminal
# Force the UI to focus/open a specific issue
kanbus console focus <issue-id>

# Trigger a reload of the console page
kanbus console reload

# Check the active state/status of the console
kanbus console status