🤖 AI Task Manager

Extensible AI-powered task management with customizable workflows and structured development processes.

Transform complex AI prompts into organized, executable workflows through customizable hooks, templates, and progressive refinement. Works seamlessly within your existing AI subscriptions for Claude Code, Gemini CLI, and Open Code.

🚀 Quick Start

This project ships in two parts: the skills (installed by vercel-labs/skills) and the workspace (initialized by this CLI). Run both:

# 1. Install the task skills for your assistant
npx skills add e0ipso/ai-task-manager

# 2. Initialize the .ai/task-manager/ workspace
npx @e0ipso/ai-task-manager init --harnesses claude --destination-directory .

The skills give your assistant the planning, decomposition, and execution workflow; the CLI bootstraps .ai/task-manager/ with hooks, templates, and the hash-tracked diff-on-conflict UX. Each step is independently re-runnable. See the migration guide for upgrade flows from 1.x.

The CLI's init emits the shared workspace plus harness-specific agents (e.g., .claude/agents/ for Claude). Other harnesses rely entirely on the installed skills.

✨ Key Benefits

• 🔧 Fully Customizable: Tailor hooks, templates, and workflows to your project's specific needs
• 🎯 Extensible Architecture: Add custom validation gates, quality checks, and workflow patterns
• 📋 Structured Workflows: Three-phase progressive refinement with validation gates
• 🔄 Plan Mode Integration: Enhance existing AI assistant features with structured task management
• 📊 Plan Inspection & Management: View progress, archive completed work, and manage plans via CLI
• 💰 Works Within Subscriptions: No additional API keys or costs required

📖 Documentation

🌐 Complete Documentation →

Comprehensive guides covering:

• Installation and configuration
• Customization with hooks and templates
• Workflow patterns and best practices
• Architecture and design principles

🔄 Workflow Preview

Once the skills are installed, invoke the workflow by intent — the assistant auto-loads the matching skill. There are no slash commands to memorize.

Automated end-to-end run:

"Run the full workflow to create a user authentication system."

The task-full-workflow skill handles plan creation, task generation, and blueprint execution in a single pass.

Step-by-step (for manual review between phases):

1. 📝 Create a plan → "Create a plan for a user authentication system" (task-create-plan skill)
2. 🔍 Refine the plan → "Refine plan 1" (task-refine-plan skill — useful when a second assistant should red-team the plan)
3. 📋 Generate tasks → "Generate tasks for plan 1" (task-generate-tasks skill)
4. 🚀 Execute blueprint → "Execute the blueprint for plan 1" (task-execute-blueprint skill)
5. 📊 Monitor progress → npx @e0ipso/ai-task-manager status
6. 🗂️ Manage plans → npx @e0ipso/ai-task-manager plan show 1

🤖 Supported Harnesses

| Harness | Interface | Setup Time | |-----------|-----------|------------| | 🎭 Claude | claude.ai/code | < 30 seconds | | 🖱️ Cursor | Cursor IDE | < 30 seconds | | 💎 Gemini | Gemini CLI | < 30 seconds | | 📝 Open Code | Open source | < 30 seconds | | 🔮 Codex | Codex CLI | < 30 seconds | | 🐙 GitHub Copilot | VS Code / JetBrains IDEs | < 30 seconds |

📄 License

MIT License - Open source and free to use.