freshcrate
Home > AI Agents > ai-task-manager

ai-task-manager

Task management for AI coding assistants

agentsaiclaude-codecode-generationcodexcoding-assistantgemini-cliopencodetypescript

Description

Task management for AI coding assistants

README

🤖 AI Task Manager

npm version License

Dashboard

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

# Initialize for your preferred AI assistant
npx @e0ipso/ai-task-manager init --assistants claude
npx @e0ipso/ai-task-manager init --assistants cursor
npx @e0ipso/ai-task-manager init --assistants gemini
npx @e0ipso/ai-task-manager init --assistants opencode
npx @e0ipso/ai-task-manager init --assistants codex
npx @e0ipso/ai-task-manager init --assistants github

# Or configure multiple assistants
npx @e0ipso/ai-task-manager init --assistants claude,cursor,gemini,opencode,codex,github

✨ 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

Automated Workflow (Recommended for Beginners):

/tasks:full-workflow Create user authentication system

Manual Workflow (Full Control):

  1. 📝 Create a plan → /tasks:create-plan Create user authentication system
  2. 🔍 Refine the plan → /tasks:refine-plan 1 (have a second assistant review the plan, ask clarifying questions, and update the document before tasks are created)
  3. 📋 Generate tasks → /tasks:generate-tasks 1
  4. 🚀 Execute blueprint → /tasks:execute-blueprint 1
  5. 📊 Monitor progress → npx @e0ipso/ai-task-manager status
  6. 🗂️ Manage plans → npx @e0ipso/ai-task-manager plan show 1

🤖 Supported Assistants

Assistant 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.

Release History

VersionChangesUrgencyDate
v1.36.0## 1.36.0 (2026-04-21) * feat(init): create archive directory on init ([944f0cb](https://github.com/e0ipso/ai-task-manager/commit/944f0cb)) High4/21/2026
v1.35.0## 1.35.0 (2026-04-15) * feat(exec): spawn CLI with stream-json output (#17) ([e818ec6](https://github.com/e0ipso/ai-task-manager/commit/e818ec6)), closes [#17](https://github.com/e0ipso/ai-task-manager/issues/17) High4/15/2026
v1.34.0## 1.34.0 (2026-03-27) * feat: add PRE_TASK_EXECUTION hook (#16) ([e86a386](https://github.com/e0ipso/ai-task-manager/commit/e86a386)), closes [#16](https://github.com/e0ipso/ai-task-manager/issues/16) [#15](https://github.com/e0ipso/ai-task-manager/issues/15) Medium3/27/2026
v1.33.0## 1.33.0 (2026-03-26) * feat: enforce scope discipline guardrails ([ce6758b](https://github.com/e0ipso/ai-task-manager/commit/ce6758b)) * chore: simplify template metadata ([2ff5d76](https://github.com/e0ipso/ai-task-manager/commit/2ff5d76)) * chore: style updates ([b06ac3c](https://github.com/e0ipso/ai-task-manager/commit/b06ac3c)) * docs: list correct post-install list ([fd9ff66](https://github.com/e0ipso/ai-task-manager/commit/fd9ff66)) Medium3/26/2026
v1.32.0## 1.32.0 (2026-03-09) * feat: parallelize exec remediation (#14) ([e7a19d2](https://github.com/e0ipso/ai-task-manager/commit/e7a19d2)), closes [#14](https://github.com/e0ipso/ai-task-manager/issues/14) Low3/9/2026
v1.31.0## 1.31.0 (2026-03-09) * feat: add Self Validation section to plan template (#13) ([b3c65c3](https://github.com/e0ipso/ai-task-manager/commit/b3c65c3)), closes [#13](https://github.com/e0ipso/ai-task-manager/issues/13) Low3/9/2026
v1.30.1## <small>1.30.1 (2026-03-06)</small> * fix: allow running commands ([a8a9ede](https://github.com/e0ipso/ai-task-manager/commit/a8a9ede)) Low3/6/2026
v1.30.0## 1.30.0 (2026-03-06) * feat: enhance single task execution (#12) ([0dcbb88](https://github.com/e0ipso/ai-task-manager/commit/0dcbb88)), closes [#12](https://github.com/e0ipso/ai-task-manager/issues/12) Low3/6/2026
v1.29.0## 1.29.0 (2026-03-06) * feat: add non-interactive commands (#11) ([1148cc9](https://github.com/e0ipso/ai-task-manager/commit/1148cc9)), closes [#11](https://github.com/e0ipso/ai-task-manager/issues/11) Low3/6/2026
v1.28.0## 1.28.0 (2026-03-06) * feat: introduce `claude-exec` command (#10) ([688d860](https://github.com/e0ipso/ai-task-manager/commit/688d860)), closes [#10](https://github.com/e0ipso/ai-task-manager/issues/10) Low3/6/2026
v1.27.2## <small>1.27.2 (2026-02-27)</small> * fix: template typos and broken refs (#9) ([cbf1d85](https://github.com/e0ipso/ai-task-manager/commit/cbf1d85)), closes [#9](https://github.com/e0ipso/ai-task-manager/issues/9) [#8](https://github.com/e0ipso/ai-task-manager/issues/8) Low2/27/2026
v1.27.1## <small>1.27.1 (2026-02-27)</small> * fix: improve tool guidance in templates (#7) ([c495a1b](https://github.com/e0ipso/ai-task-manager/commit/c495a1b)), closes [#7](https://github.com/e0ipso/ai-task-manager/issues/7) Low2/27/2026
v1.27.0## 1.27.0 (2026-02-02) * Merge remote-tracking branch 'origin/main' ([0ac8f6b](https://github.com/e0ipso/ai-task-manager/commit/0ac8f6b)) * refactor: simplify hooks and fix findRoot traversal in command templates ([9acf66a](https://github.com/e0ipso/ai-task-manager/commit/9acf66a)) * feat: add POST_EXECUTION hook file ([18bbf5e](https://github.com/e0ipso/ai-task-manager/commit/18bbf5e)) * feat: integrate POST_EXECUTION hook into templates and docs ([c2591f8](https://github.com/e0ipso/ai-task-maLow2/2/2026
v1.26.11## <small>1.26.11 (2026-01-30)</small> * fix: remove deps on non-core ([fc649ea](https://github.com/e0ipso/ai-task-manager/commit/fc649ea)) Low1/30/2026
v1.26.10## <small>1.26.10 (2026-01-30)</small> * fix: use binary exit codes in create-feature-branch script ([118c637](https://github.com/e0ipso/ai-task-manager/commit/118c637)) Low1/30/2026
v1.26.9## <small>1.26.9 (2026-01-26)</small> * Merge remote-tracking branch 'origin/main' ([610daff](https://github.com/e0ipso/ai-task-manager/commit/610daff)) * fix: avoid BC spam ([1ffb97c](https://github.com/e0ipso/ai-task-manager/commit/1ffb97c)) Low1/26/2026
v1.26.8## <small>1.26.8 (2026-01-21)</small> * fix: find the generate-tasks.md file first ([08e4d5f](https://github.com/e0ipso/ai-task-manager/commit/08e4d5f)) Low1/21/2026
v1.26.7## <small>1.26.7 (2026-01-21)</small> * fix: prevent auto-responses in refine-plan ([9f7da42](https://github.com/e0ipso/ai-task-manager/commit/9f7da42)) Low1/21/2026
v1.26.6## <small>1.26.6 (2026-01-09)</small> * Merge remote-tracking branch 'origin/main' ([fa9e7d9](https://github.com/e0ipso/ai-task-manager/commit/fa9e7d9)) * fix(commands): update root script filename ([f0bea2c](https://github.com/e0ipso/ai-task-manager/commit/f0bea2c)) Low1/9/2026
v1.26.5## <small>1.26.5 (2026-01-09)</small> * fix(commands): improve configuration handling ([db51b05](https://github.com/e0ipso/ai-task-manager/commit/db51b05)) Low1/9/2026
v1.26.4## <small>1.26.4 (2026-01-08)</small> * fix: trigger release ([4217652](https://github.com/e0ipso/ai-task-manager/commit/4217652)) * test: add comprehensive unit tests for scripts and utilities ([e4fde03](https://github.com/e0ipso/ai-task-manager/commit/e4fde03)) Low1/8/2026
v1.26.3## <small>1.26.3 (2026-01-06)</small> * fix: streamline task and plan ID retrieval scripts ([0368e94](https://github.com/e0ipso/ai-task-manager/commit/0368e94)) * Merge remote-tracking branch 'origin/main' ([4f6e77f](https://github.com/e0ipso/ai-task-manager/commit/4f6e77f)) * chore: update semantic-release packages to latest major versions ([b2a9cc8](https://github.com/e0ipso/ai-task-manager/commit/b2a9cc8)) Low1/6/2026
v1.26.2## <small>1.26.2 (2026-01-04)</small> * chore: update semantic-release packages to latest major versions ([54c7996](https://github.com/e0ipso/ai-task-manager/commit/54c7996)) * fix: update PRE_PLAN.md and PLAN_TEMPLATE.md for improved documentation ([17c956a](https://github.com/e0ipso/ai-task-manager/commit/17c956a)) Low1/4/2026
v1.26.1## <small>1.26.1 (2026-01-03)</small> * refactor: delete obsolete assistant detection scripts ([3029f51](https://github.com/e0ipso/ai-task-manager/commit/3029f51)) * refactor: remove assistant detection scripts from command templates ([d4e8162](https://github.com/e0ipso/ai-task-manager/commit/d4e8162)) * refactor: remove detection script references from hooks and documentation ([87676d4](https://github.com/e0ipso/ai-task-manager/commit/87676d4)) * chore: update node base image ([839b672](https:Low1/3/2026
v1.26.0## 1.26.0 (2025-12-03) * feat: add support for Cursor ([a62cc68](https://github.com/e0ipso/ai-task-manager/commit/a62cc68)) Low12/3/2025
v1.25.0## 1.25.0 (2025-12-01) * feat: engage Claude Skills ([3ae7f20](https://github.com/e0ipso/ai-task-manager/commit/3ae7f20)) Low12/1/2025
v1.24.0## 1.24.0 (2025-11-23) * Merge remote-tracking branch 'origin/main' ([903b9f1](https://github.com/e0ipso/ai-task-manager/commit/903b9f1)) * docs: add GitHub Copilot and Codex support references ([44484c6](https://github.com/e0ipso/ai-task-manager/commit/44484c6)) * docs: add GitHub Copilot documentation to AGENTS.md and README.md ([387f56c](https://github.com/e0ipso/ai-task-manager/commit/387f56c)) * test: add integration tests for GitHub Copilot support ([5257d23](https://github.com/e0ipso/ai-Low11/23/2025
v1.23.1## <small>1.23.1 (2025-11-23)</small> * Merge remote-tracking branch 'origin/main' ([174096f](https://github.com/e0ipso/ai-task-manager/commit/174096f)) * fix: uppercase vars trips codex ([ec664de](https://github.com/e0ipso/ai-task-manager/commit/ec664de)) Low11/23/2025
v1.23.0## 1.23.0 (2025-11-23) * Merge remote-tracking branch 'origin/main' ([51fbd08](https://github.com/e0ipso/ai-task-manager/commit/51fbd08)) * chore: improve devcontainer ([b0307a4](https://github.com/e0ipso/ai-task-manager/commit/b0307a4)) * docs(codex): add comprehensive codex documentation ([9d9efee](https://github.com/e0ipso/ai-task-manager/commit/9d9efee)) * test(codex): add integration tests for codex support ([cd53527](https://github.com/e0ipso/ai-task-manager/commit/cd53527)) * feat(codex)Low11/23/2025
v1.22.0## 1.22.0 (2025-11-22) * fix: address test failures ([8cd7a96](https://github.com/e0ipso/ai-task-manager/commit/8cd7a96)) * feat: add plan refinement feature ([18d86a0](https://github.com/e0ipso/ai-task-manager/commit/18d86a0)) * chore: remove unnecessary file ([1a4bae1](https://github.com/e0ipso/ai-task-manager/commit/1a4bae1)) Low11/22/2025
v1.21.0## 1.21.0 (2025-11-22) * Merge remote-tracking branch 'origin/main' ([aa280d5](https://github.com/e0ipso/ai-task-manager/commit/aa280d5)) * Merge remote-tracking branch 'origin/main' ([b0aa1c6](https://github.com/e0ipso/ai-task-manager/commit/b0aa1c6)) * feat: add support for codex ([3242bb3](https://github.com/e0ipso/ai-task-manager/commit/3242bb3)) * feat: implement agent conflict detection and console output ([c1020dc](https://github.com/e0ipso/ai-task-manager/commit/c1020dc)) * feat: implemLow11/22/2025
v1.20.0## 1.20.0 (2025-11-05) * feat: improve full workflow command ([288db8b](https://github.com/e0ipso/ai-task-manager/commit/288db8b)) * chore: add command example ([c072d21](https://github.com/e0ipso/ai-task-manager/commit/c072d21)) * chore: restore full-workflow command ([99d7506](https://github.com/e0ipso/ai-task-manager/commit/99d7506)) * chore: the full workflow is no longer ([0464568](https://github.com/e0ipso/ai-task-manager/commit/0464568)) * chore: the full workflow will be again ([90a29dfLow11/5/2025
v1.19.0## 1.19.0 (2025-10-30) * refactor: enhance workflow help display formatting ([83521d1](https://github.com/e0ipso/ai-task-manager/commit/83521d1)) * feat: modernize init command aesthetics - phase 1 ([f9009e9](https://github.com/e0ipso/ai-task-manager/commit/f9009e9)) Low10/30/2025
v1.18.7## <small>1.18.7 (2025-10-28)</small> * fix: avoid issue with formatters and bash ([2c04062](https://github.com/e0ipso/ai-task-manager/commit/2c04062)) Low10/28/2025
v1.18.6## <small>1.18.6 (2025-10-22)</small> * refactor: split approval method into plan and tasks fields ([f84cc42](https://github.com/e0ipso/ai-task-manager/commit/f84cc42)) * fix: make full-workflow continue through commands (3) ([c399ba7](https://github.com/e0ipso/ai-task-manager/commit/c399ba7)) Low10/22/2025
v1.18.5## <small>1.18.5 (2025-10-20)</small> * fix: make full-workflow continue through commands (2) ([1f48854](https://github.com/e0ipso/ai-task-manager/commit/1f48854)) Low10/20/2025
v1.18.4## <small>1.18.4 (2025-10-20)</small> * fix: avoid bash error during execution ([5c81ee3](https://github.com/e0ipso/ai-task-manager/commit/5c81ee3)) Low10/20/2025
v1.18.3## <small>1.18.3 (2025-10-17)</small> * fix: attempt to not pause after auto-generated tasks ([bd9dd1a](https://github.com/e0ipso/ai-task-manager/commit/bd9dd1a)) Low10/17/2025
v1.18.2## <small>1.18.2 (2025-10-17)</small> * fix: make full-workflow continue through commands (1) ([6720978](https://github.com/e0ipso/ai-task-manager/commit/6720978)) * docs: update documentation with latest features ([0b1dbf3](https://github.com/e0ipso/ai-task-manager/commit/0b1dbf3)) Low10/17/2025
v1.18.1## <small>1.18.1 (2025-10-17)</small> * fix: make full-workflow continue through commands ([6653a40](https://github.com/e0ipso/ai-task-manager/commit/6653a40)) * fix: update devcontainer ([78375d3](https://github.com/e0ipso/ai-task-manager/commit/78375d3)) * chore: fix devcontainer issues ([e74d820](https://github.com/e0ipso/ai-task-manager/commit/e74d820)) Low10/17/2025
v1.18.0## 1.18.0 (2025-10-17) * Merge branch 'chore/worktrees-out-repo' ([e50994a](https://github.com/e0ipso/ai-task-manager/commit/e50994a)) * Merge branch 'feat/auto-create-tasks-if-missing' ([04d11a5](https://github.com/e0ipso/ai-task-manager/commit/04d11a5)) * Merge branch 'main' into feat/auto-create-tasks-if-missing ([a4dea1d](https://github.com/e0ipso/ai-task-manager/commit/a4dea1d)) * Merge remote-tracking branch 'origin/main' ([e3e25c9](https://github.com/e0ipso/ai-task-manager/commit/e3e25c9Low10/17/2025
v1.17.1## <small>1.17.1 (2025-10-17)</small> * fix: replace Jekyll link tags with relative paths in documentation ([51ef602](https://github.com/e0ipso/ai-task-manager/commit/51ef602)) Low10/17/2025
v1.17.0## 1.17.0 (2025-10-16) * feat: add plan remove subcommand ([61eeae3](https://github.com/e0ipso/ai-task-manager/commit/61eeae3)) * fix: ensure full-workflow does not do pit stops ([33ac8f8](https://github.com/e0ipso/ai-task-manager/commit/33ac8f8)) * docs: complete Phase 1 - Foundation Setup ([6e631e7](https://github.com/e0ipso/ai-task-manager/commit/6e631e7)) * docs: complete Phase 2 - Core Content Restructure ([2fffe32](https://github.com/e0ipso/ai-task-manager/commit/2fffe32)), closes [#1](htLow10/16/2025
v1.16.0## 1.16.0 (2025-10-16) * chore: archive AI plan ([b69cd9d](https://github.com/e0ipso/ai-task-manager/commit/b69cd9d)) * chore: improve .gitignore ([7b1d5aa](https://github.com/e0ipso/ai-task-manager/commit/7b1d5aa)) * Merge branch 'feat/plan-35-full-workflow-command' ([be6c1b0](https://github.com/e0ipso/ai-task-manager/commit/be6c1b0)) * docs: add full-workflow option to init help text ([a4880c9](https://github.com/e0ipso/ai-task-manager/commit/a4880c9)) * docs: document status command (#5) ([3Low10/16/2025
v1.15.0## 1.15.0 (2025-10-16) * feat: add status command for dashboard ([15d191d](https://github.com/e0ipso/ai-task-manager/commit/15d191d)) * chore: add README.md file to inform what the folder is about ([14f0f49](https://github.com/e0ipso/ai-task-manager/commit/14f0f49)) Low10/16/2025
v1.14.0## 1.14.0 (2025-10-16) * feat: mount Claude folders and files ([5dc987d](https://github.com/e0ipso/ai-task-manager/commit/5dc987d)) Low10/16/2025
v1.13.0## 1.13.0 (2025-10-09) * docs: document file conflict detection feature ([3ccc98d](https://github.com/e0ipso/ai-task-manager/commit/3ccc98d)) * docs: document overwrite protection ([66c9e52](https://github.com/e0ipso/ai-task-manager/commit/66c9e52)) * feat: add hash-based file conflict detection to init command ([2f3c2fa](https://github.com/e0ipso/ai-task-manager/commit/2f3c2fa)) * feat: add npm dependencies for conflict detection ([ffb506f](https://github.com/e0ipso/ai-task-manager/commit/ffb5Low10/9/2025
v1.12.0## 1.12.0 (2025-10-09) * fix: improve devcontainer ([f24f2cf](https://github.com/e0ipso/ai-task-manager/commit/f24f2cf)) * chore: archive AI plan ([14d7645](https://github.com/e0ipso/ai-task-manager/commit/14d7645)) * refactor: remove debug logging from config scripts ([515f1ff](https://github.com/e0ipso/ai-task-manager/commit/515f1ff)) * docs: add comparison section with plan mode ([91187aa](https://github.com/e0ipso/ai-task-manager/commit/91187aa)) * docs: add execution summary to plan 29 ([6Low10/9/2025
v1.11.1## <small>1.11.1 (2025-10-03)</small> * fix: improve execution todo list ([0694923](https://github.com/e0ipso/ai-task-manager/commit/0694923)) * ci: update the devcontainer ([0c7c381](https://github.com/e0ipso/ai-task-manager/commit/0c7c381)) * docs: update path file in docs ([3557b65](https://github.com/e0ipso/ai-task-manager/commit/3557b65)) Low10/3/2025
v1.11.0## 1.11.0 (2025-09-27) * docs: remove unnecessary artifact ([e90438c](https://github.com/e0ipso/ai-task-manager/commit/e90438c)) * docs: rename docs ([8bba9c8](https://github.com/e0ipso/ai-task-manager/commit/8bba9c8)) * docs: update site to include the new command ([5ba4399](https://github.com/e0ipso/ai-task-manager/commit/5ba4399)) * feat(docs): complete Phase 1 audit and research tasks ([ead4870](https://github.com/e0ipso/ai-task-manager/commit/ead4870)) * feat(docs): complete Phase 3 - restLow9/27/2025

Dependencies & License Audit

Loading dependencies...

Similar Packages

voratiqAgent ensembles to design, generate, and select the best code for every task.main@2026-04-21
cc-sddTurn approved specs into long-running autonomous implementation. A minimal, adaptable SDD harness with Agent Skills for Claude Code, Codex, Cursor, Copilot, Windsurf, OpenCode, Gemini CLI, and Antigrav3.0.2
skillctrlCLI to manage and deploy AI agent skills1.3.0
skillcamTurn successful AI agent runs into reusable markdown skills0.4.3
vulykPackage manager for AI agent skills and agents0.7.10