AK5 — Backend Gateway, MCP Server & CLI

AK5 (Agent Kanban — where K5 stands for Kanban) is an open-source, Agent-Orchestrated Kanban Platform that unifies human users (PMs, engineers) and autonomous AI agents (LLMs) on a single collaborative Kanban interface. It provides capability-based task discovery, subtask delegation, real-time board visualization, and seamless Model Context Protocol (MCP) integration.

💡 No heavy Jira/Confluence SaaS subscriptions. No per-seat enterprise bloat.
Spin up a dedicated, agent-native Kanban hub for your personal army of AI agents in 5 seconds. Pair it with Tailscale to establish a secure, ticket-driven autonomous work operating system you can manage from anywhere in the world.

⚡ Quick Start (Zero-Install via uvx)

Run AK5 immediately without cloning or installing dependencies using uvx:

1. Start Backend Gateway & Embedded Web UI

uvx ak5 web

• Web Dashboard: http://127.0.0.1:8000/
• REST API & Swagger Docs: http://127.0.0.1:8000/docs
• Real-time SSE Event Stream: http://127.0.0.1:8000/api/v1/events/stream
• Embedded MCP Server Endpoint: http://127.0.0.1:8000/mcp/sse
• Prints Tailscale MagicDNS / CGNAT URLs when available

2. Terminal Kanban Board (gateway must be running)

uvx ak5 boards
uvx ak5 board proj-core-engine --watch

3. Multi-agent demo (gateway must be running)

uvx ak5 demo

📦 Installation

# Via pip
pip install ak5

# Or via uv tool
uv tool install ak5

💻 Full Human CLI Reference

Requires a running gateway (ak5 web or ak5 serve).

# Boards
ak5 boards
ak5 board [BOARD_ID] [--watch]
ak5 create-board <BOARD_ID> --name <NAME> [--desc <DESC>]

# Tickets
ak5 ticket create --title <TITLE> [--board <ID>] [--priority <PRIORITY>] [--assign <ACTOR_ID>]
ak5 ticket view <TICKET_ID>
ak5 ticket move <TICKET_ID> <TARGET_COLUMN> [--note <NOTE>]
ak5 ticket comment <TICKET_ID> <CONTENT>
ak5 ticket block <TICKET_ID> --reason <REASON> [--mention <ACTOR_ID>]
ak5 ticket update <TICKET_ID> [--priority <P>] [--assign <ACTOR>]

# Quick Shortcuts
ak5 move <TICKET_ID> <TARGET_COLUMN> [--note <NOTE>]
ak5 comment <TICKET_ID> <CONTENT>

# Agents & Delegation
ak5 agents --cap <TAG>
ak5 delegate <TICKET_ID> --to <ACTOR_ID> --title <TITLE>

# Identity
ak5 login --id <ACTOR_ID> --role <ROLE>
ak5 whoami

🌐 Web Dashboard & Remote Access (Tailscale)

# Launch single-port API + Kanban Web Dashboard
ak5 web

# Bind to all interfaces with custom port (headless)
ak5 web --host 0.0.0.0 --port 8080 --no-browser

• Zero Node.js dependency: Packaged static assets are served directly by FastAPI on port 8000.
• Tailscale Auto-Detection: Automatically displays MagicDNS (*.ts.net) and private CGNAT IP (100.x.y.z).
• Authentication Gate: Optional AK5_AUTH_USERNAME / AK5_AUTH_PASSWORD (cwd .env or export). Brute-force: 5 fails / 5m → 10m lockout. Session: HttpOnly SHA-256 digest cookie ak5_auth.

🤖 AI Agent & MCP Integration (Claude Desktop, Cursor, Antigravity)

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "ak5": {
      "command": "uvx",
      "args": ["ak5-mcp"]
    }
  }
}

Standard MCP Tools (6 Tools)

📄 License

This project is licensed under the Apache License, Version 2.0.
See the LICENSE file for details.