tasuku
By iheanyi
Manage project tasks via CLI: add prioritized tasks with blockers/subtasks/tags, time-track with start/stop, list ready ones sorted by priority, complete with guided learnings capture. Record decisions/insights scoped to files, reflect on git changes to extract patterns, promote to docs like CLAUDE.md.
Component Overview
Install
npx claudepluginhub iheanyi/tasuku --plugin tasukuComponent Details
Commands (18)
Create a new task
Mark a task as blocked by other tasks
Complete a task with guided learning capture. Use after finishing work to mark done, document learnings, and see what's unblocked.
Get full project context including tasks, learnings, and decisions
Record an architectural decision with reasoning
Mark a task as completed
Show all available Tasuku skills organized by workflow. Use to discover what skills exist and when to use them.
Record a learning or insight
List all tasks with optional filtering
Add a note to a task for context or progress
Pick up the next task to work on. Shows ready tasks, helps select one, and starts it with full context.
Promote a learning to permanent documentation
Show tasks ready to work on, sorted by priority
Guided reflection to extract learnings from recent work. Use after bug fixes, feature completion, or when prompted by hooks.
Show detailed information about a task
Start working on a task
Show project statistics and progress
Task management for AI agents. Overview and quick reference for all /tasuku:* commands.
MCP Servers (1)
README
Tasuku
Agent-first task management for codebases. Designed for AI agents working alongside humans.
Why Tasuku?
- Pull over push: Agents query when needed, no constant context injections
- Parallel-safe: Per-file locking for multiple agents working simultaneously
- Minimal context: Only load what's needed for the current task
- Human-readable: Markdown files with YAML frontmatter, editable by hand
- Git-friendly: One file per task means clean diffs and fewer merge conflicts
Installation
go install github.com/iheanyi/tasuku/cmd/tk@latest
Or build from source:
git clone https://github.com/iheanyi/tasuku.git
cd tasuku && go build -o tk ./cmd/tk
sudo mv tk /usr/local/bin/
Quick Start
1. Initialize and integrate
cd your-project
tk init # Create .tasuku/ directory
tk mcp install # Enable tk_* tools in your AI editor
tk hooks install # Context at session start, reminders at end
git add .tasuku/ # Tasks travel with your code
Works with Claude Code, Cursor, Copilot CLI, Codex, and OpenCode. Restart your editor after installing.
2. Your AI agent now has access to
MCP Tools (40+ tools, see docs/mcp.md):
tk_add/tk_list/tk_done- Task managementtk_learn/tk_decide- Knowledge capturetk_context- Load full project state
Slash Commands (Claude Code with plugin):
/tasuku:pickup- Select and start a task/tasuku:complete- Mark done, capture learnings/tasuku:reflect- Extract learnings from recent work
3. CLI and TUI for humans
tk task list # See all tasks
tk task add "New feature" # Add a task
tk task start <id> # Start working
tk task done <id> # Mark complete
tk learn "insight" # Record a learning
tk ui # Terminal UI (j/k to navigate, ? for help)
CLI Reference
| Command | Description |
|---|---|
tk task list | List tasks (--status, --tag, --tree) |
tk task add "desc" | Add task (--id, --parent, --priority) |
tk task start/done/block <id> | Lifecycle management |
tk task archive <id> | Archive completed task |
tk task restore <id> | Restore from archive |
tk learn "insight" | Record a learning |
tk decide --id X --chose Y --over Z --because "..." | Record decision |
tk task claim/release <id> | Multi-agent coordination |
tk task timer start/stop <id> | Time tracking |
tk plugin install | Install slash commands to AI tools |
tk rules sync | Sync learnings to editor rules |
Full reference: docs/cli.md
Data Format
Tasks are Markdown files with YAML frontmatter:
.tasuku/
├── tasks/task-id.md # One file per task
├── archive/ # Archived tasks
├── context/
│ ├── learnings.md # Recorded insights
│ └── decisions.md # Architectural decisions
└── index.json # Auto-generated for fast queries
Migration from Beads
tk migrate beads # Convert .beads/ to .tasuku/
tk migrate beads --dry-run # Preview first
Documentation
Detailed docs in docs/:
cli.md- Complete CLI commandsmcp.md- MCP tools and TUI keybindingshooks.md- Hook configurationplugins.md- Slash commands for AI toolsstorage.md- Storage format
Development
go test ./... # Run tests
go test -race ./... # With race detector
go build -o tk ./cmd/tk # Build
License
MIT
Similar Plugins
team-skills-platform
Team-oriented workflow plugin with role agents, 27 specialist agents, ECC-inspired commands, layered rules, and hooks skeleton.