Claudia

io.github.yuvalsuedePublished by GitHub account yuvalsuedev0.1.3Updated Oct 25, 2026

Task management for AI agents with hierarchical tasks, dependencies, sprints, and coordination.

VerifiedSTDIODesktop onlyProductivity & Workflow Developer Tools

Server details

Identifier: io.github.yuvalsuede/claudia
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account yuvalsuede for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.yuvalsuede%2Fclaudia.svg)](https://sourceweft.com/mcp/io.github.yuvalsuede%2Fclaudia?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Claudia is a local task-management server that lets an AI assistant create, track, coordinate and verify hierarchical tasks, dependencies, sprints and projects.

What you can do: Create, read, update, delete and bulk-edit tasks, with hierarchical trees and state transitions between pending, in progress, verification and completed, plus per-task JSON context storage up to 64KB and acceptance-criteria verification with evidence. Manage dependencies and coordination: add or remove blockers, list blocked and ready tasks, and atomically claim, release, hand off or abandon tasks for multiple agents. Run compound operations that start a task, finish it with a summary, or return the current agent's workspace. Organize work into sprints and isolated projects, including selecting the active project and auto-detecting it from the working directory.
When to use it: Useful when an assistant works through long multi-step jobs and needs durable task state across sessions, or when several agents share one project and must claim work without collisions. Also fits teams that want a kanban-style task store with sprints and acceptance checks behind a CLI and web dashboard.
Requirements: Runs as a local process over stdio, started with bunx from the npm package claudia-cli; the README lists Bun runtime v1.0+ as a prerequisite. A local database file is used, defaulting to a path under the user's home directory and overridable with the CLAUDIA_DB environment variable. No accounts, API keys or headers are declared.

Before you install

The server writes to a local database: tasks, sprints and projects can be created, updated, transitioned and deleted, and deletion is destructive. Task context storage holds up to 64KB of JSON per task, so avoid putting secrets there. The README's quick start clones and builds from source and installs Bun via a shell script; review that before running it.

Installation

In SourceWeft

Open Claudia in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Claudia

[License: GPLv3] [Bun] [MCP]

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.

[Claudia Dashboard Demo]

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

bash

# Install Bun if you haven't alreadycurl -fsSL https://bun.sh/install | bash
# Clone and buildgit clone https://github.com/yuvalsuede/claudia.gitcd claudiabun installbun run build
# Initialize and start using./claudia db init./claudia task create --title "My first task"./claudia task list

# Install Bun if you haven't alreadycurl -fsSL https://bun.sh/install | bash
# Clone and buildgit clone https://github.com/yuvalsuede/claudia.gitcd claudiabun installbun run build
# Initialize and start using./claudia db init./claudia task create --title "My first task"./claudia task list

Try the Demo

See Claudia in action with sample data:

bash

# Seed demo project with sample tasks and sprintsbun run seed:demo
# Open the web dashboard./claudia @@ --port 3333

# Seed demo project with sample tasks and sprintsbun run seed:demo
# Open the web dashboard./claudia @@ --port 3333

Then open http://localhost:3333 in your browser to explore the kanban board and sprint views.

Screenshots

Task Board

[Claudia Tasks View]

Sprint Management

[Claudia Sprints View]

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

bash

# Create a taskclaudia task create --title "Implement feature X" --priority p1
# Create with acceptance criteriaclaudia task create --title "Add login" --acceptance-criteria "Has email field" --acceptance-criteria "Has password field"
# List tasksclaudia task listclaudia task list --status in_progress --priority p0,p1
# Show task detailsclaudia task show <task-id>
# Update a taskclaudia task update <task-id> --title "New title" --priority p0
# Transition statusclaudia task transition <task-id> --to in_progress
# Delete a taskclaudia task delete <task-id> --force

# Create a taskclaudia task create --title "Implement feature X" --priority p1
# Create with acceptance criteriaclaudia task create --title "Add login" --acceptance-criteria "Has email field" --acceptance-criteria "Has password field"
# List tasksclaudia task listclaudia task list --status in_progress --priority p0,p1
# Show task detailsclaudia task show <task-id>
# Update a taskclaudia task update <task-id> --title "New title" --priority p0
# Transition statusclaudia task transition <task-id> --to in_progress
# Delete a taskclaudia task delete <task-id> --force

Task Hierarchy

bash

# Create a subtaskclaudia task create --title "Subtask" --parent <parent-id>
# View task treeclaudia task tree              # Full treeclaudia task tree <task-id>    # Subtree from task

# Create a subtaskclaudia task create --title "Subtask" --parent <parent-id>
# View task treeclaudia task tree              # Full treeclaudia task tree <task-id>    # Subtree from task

Task Context (Agent Memory)

bash

# Set context (overwrites)claudia task context-set <task-id> '{"key": "value"}'
# Merge context (deep merge)claudia task context-merge <task-id> '{"additional": "data"}'
# Get contextclaudia task context-get <task-id>

# Set context (overwrites)claudia task context-set <task-id> '{"key": "value"}'
# Merge context (deep merge)claudia task context-merge <task-id> '{"additional": "data"}'
# Get contextclaudia task context-get <task-id>

Dependencies

bash

# Add dependency (task depends on blocker)claudia task depends <task-id> --on <blocker-id>
# Remove dependencyclaudia task undepends <task-id> --on <blocker-id>
# Show dependenciesclaudia task deps <task-id>
# List blocked tasksclaudia task blocked
# List ready tasks (all deps satisfied)claudia task ready

# Add dependency (task depends on blocker)claudia task depends <task-id> --on <blocker-id>
# Remove dependencyclaudia task undepends <task-id> --on <blocker-id>
# Show dependenciesclaudia task deps <task-id>
# List blocked tasksclaudia task blocked
# List ready tasks (all deps satisfied)claudia task ready

Sprints

bash

# Create a sprintclaudia sprint create --name "Sprint 1" --start 2024-01-15 --end 2024-01-29
# List sprintsclaudia sprint list
# Show sprint with tasksclaudia sprint show <sprint-id>
# Activate a sprintclaudia sprint activate <sprint-id>

# Create a sprintclaudia sprint create --name "Sprint 1" --start 2024-01-15 --end 2024-01-29
# List sprintsclaudia sprint list
# Show sprint with tasksclaudia sprint show <sprint-id>
# Activate a sprintclaudia sprint activate <sprint-id>

Projects

bash

# Create a projectclaudia project create --name "My Project" --path /path/to/project
# List projectsclaudia project list
# Select active projectclaudia project select <project-id>
# Show current projectclaudia project current

# Create a projectclaudia project create --name "My Project" --path /path/to/project
# List projectsclaudia project list
# Select active projectclaudia project select <project-id>
# Show current projectclaudia project current

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:

json

{  "mcpServers": {    "claudia": {      "command": "/path/to/claudia",      "args": ["mcp"]    }  }}

{  "mcpServers": {    "claudia": {      "command": "/path/to/claudia",      "args": ["mcp"]    }  }}

Or for development (without building):

json

{  "mcpServers": {    "claudia": {      "command": "bun",      "args": ["run", "/path/to/claudia/src/mcp/server.ts"],      "cwd": "/path/to/claudia"    }  }}

{  "mcpServers": {    "claudia": {      "command": "bun",      "args": ["run", "/path/to/claudia/src/mcp/server.ts"],      "cwd": "/path/to/claudia"    }  }}

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

Verification

See the full MCP tools reference below for complete documentation.

Task Workflow

┌─────────┐     ┌─────────────┐     ┌──────────────┐     ┌───────────┐│ pending │────▶│ in_progress │────▶│ verification │────▶│ completed │└─────────┘     └─────────────┘     └──────────────┘     └───────────┘     │                │                    │                    │     ▼                ▼                    ▼                    ▼┌─────────┐                         ┌──────────┐│ blocked │                         │ archived │ (terminal)└─────────┘                         └──────────┘

┌─────────┐     ┌─────────────┐     ┌──────────────┐     ┌───────────┐│ pending │────▶│ in_progress │────▶│ verification │────▶│ completed │└─────────┘     └─────────────┘     └──────────────┘     └───────────┘     │                │                    │                    │     ▼                ▼                    ▼                    ▼┌─────────┐                         ┌──────────┐│ blocked │                         │ archived │ (terminal)└─────────┘                         └──────────┘

Valid transitions:

pending → in_progress, blocked, archived
in_progress → pending, verification, completed, blocked, archived
verification → in_progress, completed, blocked, archived
blocked → pending, in_progress, archived
completed → in_progress, archived
archived → (terminal state)

Tasks can skip verification if no acceptance criteria are defined.

Multi-Agent Coordination

Claudia supports multiple AI agents working concurrently on the same project.

Task Claiming

typescript

// Claim before workingconst result = await task_claim({ task_id: "uuid", agent_id: "agent-1" });if (result.success) {  // Task is yours - proceed} else {  // Already claimed by another agent}
// Release when done or on failureawait task_release({ task_id: "uuid", agent_id: "agent-1" });

// Claim before workingconst result = await task_claim({ task_id: "uuid", agent_id: "agent-1" });if (result.success) {  // Task is yours - proceed} else {  // Already claimed by another agent}
// Release when done or on failureawait task_release({ task_id: "uuid", agent_id: "agent-1" });

Optimistic Locking

typescript

// Read task firstconst task = await task_read({ id: "uuid" });
// Update with version checkawait task_update({  id: task.id,  title: "Updated",  version: task.version  // Fails if modified by another agent});

// Read task firstconst task = await task_read({ id: "uuid" });
// Update with version checkawait task_update({  id: task.id,  title: "Updated",  version: task.version  // Fails if modified by another agent});

Recommended Pattern

task_ready - List tasks with satisfied dependencies
task_claim - Atomically reserve a task
task_transition - Move to in_progress
task_context_merge - Save progress
task_transition - Move to completed
On failure: task_release - Let another agent retry

Configuration

Development

Exit Codes

MCP Tools Reference

Compound Operations

task_start

Create and start a task in one operation. Auto-claims for the current agent.

json

{  "title": "Task title",  "description": "Optional description",  "priority": "p0|p1|p2|p3",  "parent_id": "optional-parent-uuid",  "acceptance_criteria": ["criterion 1", "criterion 2"]}

{  "title": "Task title",  "description": "Optional description",  "priority": "p0|p1|p2|p3",  "parent_id": "optional-parent-uuid",  "acceptance_criteria": ["criterion 1", "criterion 2"]}

task_finish

Complete a task with optional summary.

task_workspace

Get current agent's workspace context including claimed tasks.

task_handoff

Transfer task to another agent.

task_abandon

Release task back to pending with reason.

Task CRUD

task_create

json

{  "title": "Required title",  "description": "Optional",  "status": "pending",  "priority": "p0|p1|p2|p3",  "parent_id": "uuid",  "sprint_id": "uuid",  "tags": ["tag1", "tag2"],  "assignee": "name",  "acceptance_criteria": ["criterion"]}

{  "title": "Required title",  "description": "Optional",  "status": "pending",  "priority": "p0|p1|p2|p3",  "parent_id": "uuid",  "sprint_id": "uuid",  "tags": ["tag1", "tag2"],  "assignee": "name",  "acceptance_criteria": ["criterion"]}

task_read

task_update

task_delete

task_list

json

{  "status": ["pending", "in_progress"],  "priority": ["p0", "p1"],  "parent_id": "uuid",  "sprint_id": "uuid",  "assignee": "name",  "limit": 100,  "offset": 0}

{  "status": ["pending", "in_progress"],  "priority": ["p0", "p1"],  "parent_id": "uuid",  "sprint_id": "uuid",  "assignee": "name",  "limit": 100,  "offset": 0}

task_transition

task_tree

Bulk Operations

task_create_many

json

{  "tasks": [    { "title": "Task 1" },    { "title": "Task 2" }  ],  "parent_id": "optional-common-parent",  "sprint_id": "optional-common-sprint"}

{  "tasks": [    { "title": "Task 1" },    { "title": "Task 2" }  ],  "parent_id": "optional-common-parent",  "sprint_id": "optional-common-sprint"}

task_update_many

task_transition_many

Dependencies & Coordination

task_dependency_add

task_dependency_remove

task_dependencies

task_blocked

List all tasks with unsatisfied dependencies.

task_ready

List all tasks ready to work on (dependencies satisfied).

task_claim

task_release

Context Storage

task_context_set

Overwrite task context (max 64KB).

task_context_merge

Deep merge into existing context.

task_context_get

Verification

task_verify

Mark an acceptance criterion as verified.

json

{  "task_id": "task-uuid",  "criterion_id": "criterion-uuid",  "evidence": "Optional verification evidence"}

{  "task_id": "task-uuid",  "criterion_id": "criterion-uuid",  "evidence": "Optional verification evidence"}

task_verification_status

Get verification progress for a task.

Sprints

sprint_create

sprint_list

sprint_show

sprint_update

sprint_delete

sprint_activate

Projects

project_create

project_list

List all projects.

project_read

project_update

project_delete

project_select

project_current

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

License

GPLv3 - see LICENSE for details.

Source: README.md at commit 8898fa8

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.1.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Code	Meaning
0	Success
1	General error
2	Resource not found
3	Conflict (version mismatch)
4	Validation error
5	Storage error