yuvalsuede/claudia

**A task management system built for AI agents.**
Official website: https://claudiacli.com/
Claudia provides structured task tracking with a Model Context Protocol (MCP) server, enabling AI assistants like Claude to manage their own work through hierarchical tasks, dependencies, sprints, and acceptance criteria verification.
Why Claudia?
AI agents need a way to:
- **Track progress** across complex, multi-step tasks
- **Coordinate** when multiple agents work on the same project
- **Remember context** between sessions (64KB JSON storage per task)
- **Verify work** against acceptance criteria before completion
- **Organize work** into sprints and project hierarchies
Claudia provides all of this through both a CLI and MCP server interface.
Quick Start
Try the Demo
See Claudia in action with sample data:
Then open http://localhost:3333 in your browser to explore the kanban board and sprint views.
Screenshots
Task Board
Sprint Management
Features
| Feature | Description |
|---------|-------------|
| **Hierarchical Tasks** | Parent-child relationships with tree visualization |
| **State Machine** | Validated transitions: pending → in_progress → verification → completed |
| **Dependencies** | Block tasks until prerequisites complete, with cycle detection |
| **Sprints** | Group tasks into time-boxed work periods |
| **Multi-Project** | Isolated task namespaces with auto-detection from working directory |
| **Agent Memory** | 64KB JSON context storage per task |
| **Acceptance Criteria** | Define and verify requirements before task completion |
| **Multi-Agent Coordination** | Atomic task claiming, optimistic locking, conflict detection |
| **Web Dashboard** | Visual kanban board with project/sprint filtering |
| **MCP Server** | Drop-in integration with Claude Code and other MCP clients |
Installation
Prerequisites
- Bun runtime (v1.0+)
From Source
Build Standalone Binary
Usage
CLI Commands
Task Management
Task Hierarchy
Task Context (Agent Memory)
Dependencies
Sprints
Projects
Web Dashboard
The dashboard provides:
- **Tasks View**: Kanban board with drag-and-drop columns
- **Sprints View**: Sprint cards with progress indicators
- **Project Filter**: Scope views to specific projects
- **Clear Completed**: Archive finished tasks
MCP Server Integration
Start the MCP server for use with Claude Code:
Claude Code Configuration
Add to .mcp.json in your project root:
Or for development (without building):
After adding the config, restart Claude Code to connect.
Available MCP Tools
**Compound Operations** (Recommended for agents)
| Tool | Description |
|------|-------------|
| task_start | Create and start a task in one operation |
| task_finish | Complete a task with optional summary |
| task_workspace | Get current agent's workspace context |
| task_handoff | Transfer task to another agent |
| task_abandon | Release task back to pending |
**Task Management**
| Tool | Description |
|------|-------------|
| task_create | Create a new task |
| task_read | Get task by ID |
| task_update | Update task fields |
| task_delete | Delete a task |
| task_list | Query tasks with filters |
| task_transition | Change task status |
| task_tree | Get hierarchical task view |
**Coordination**
| Tool | Description |
|------|-------------|
| task_claim | Atomically claim a task |