@e0ipso/ai-task-manager 1.7.1 → 1.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +28 -94
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,121 +1,55 @@
|
|
|
1
1
|
# 🤖 AI Task Manager
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/@e0ipso/ai-task-manager)
|
|
4
|
-
[](https://opensource.org/licenses/MIT)
|
|
5
5
|
|
|
6
|
-
AI-powered task management that creates structured workflows within your existing AI subscriptions
|
|
6
|
+
**AI-powered task management that creates structured workflows within your existing AI subscriptions.**
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
Transform chaotic AI prompts into organized, executable development workflows through custom slash commands for Claude Code, Gemini CLI, and Open Code.
|
|
9
9
|
|
|
10
|
-
##
|
|
11
|
-
|
|
12
|
-
This tool creates custom slash commands (like `/tasks:create-plan`, `/tasks:generate-tasks`) that integrate directly into:
|
|
13
|
-
- **Claude Code**: Works with your Claude Pro/Max subscription via [claude.ai/code](https://claude.ai/code)
|
|
14
|
-
- **Gemini CLI**: Uses your existing Gemini subscription
|
|
15
|
-
- **Open Code**: Leverages your preferred open-source setup
|
|
16
|
-
|
|
17
|
-
## ✨ Features
|
|
18
|
-
|
|
19
|
-
- 🤝 **Multi-Assistant Support**: Configure support for Claude, Gemini, and Open Code
|
|
20
|
-
- 📋 **Template System**: Built-in templates for different project types (basic, development, research)
|
|
10
|
+
## 💰 No Additional Costs
|
|
21
11
|
|
|
12
|
+
Unlike Plandex, Claude Task Master, and Conductor Tasks that require API keys with pay-per-token pricing, **AI Task Manager works within your existing AI subscriptions** - no API keys or additional costs required.
|
|
22
13
|
|
|
23
14
|
## 🚀 Quick Start
|
|
24
15
|
|
|
25
|
-
### 🏗️ Initialize a New Workspace
|
|
26
|
-
|
|
27
|
-
The `--assistants` flag is **required** when initializing a workspace. You must specify which coding assistant(s) you want to configure support for.
|
|
28
|
-
|
|
29
|
-
AI Task Manager supports multiple coding assistants. You **must** specify which assistant(s) to use during initialization using the `--assistants` flag.
|
|
30
|
-
|
|
31
|
-
🤖 Supported Assistants are
|
|
32
|
-
|
|
33
|
-
- 🎭 **Claude**: Anthropic's Claude AI assistant
|
|
34
|
-
- 💎 **Gemini**: Google's Gemini AI assistant
|
|
35
|
-
- 📝 **Open Code**: Open source code assistant
|
|
36
|
-
|
|
37
|
-
The `--destination-directory` flag allows you to specify an alternative directory for the workspace. By default, the workspace is initialized in the current working directory.
|
|
38
|
-
|
|
39
16
|
```bash
|
|
40
|
-
#
|
|
17
|
+
# Initialize for your preferred AI assistant
|
|
41
18
|
npx @e0ipso/ai-task-manager init --assistants claude
|
|
42
|
-
|
|
43
|
-
# Gemini only
|
|
44
|
-
npx @e0ipso/ai-task-manager init --assistants gemini
|
|
45
|
-
|
|
46
|
-
# Open Code only
|
|
19
|
+
npx @e0ipso/ai-task-manager init --assistants gemini
|
|
47
20
|
npx @e0ipso/ai-task-manager init --assistants opencode
|
|
48
21
|
|
|
49
|
-
#
|
|
50
|
-
npx @e0ipso/ai-task-manager init --assistants claude,gemini
|
|
51
|
-
npx @e0ipso/ai-task-manager init --assistants claude,opencode
|
|
22
|
+
# Or configure multiple assistants
|
|
52
23
|
npx @e0ipso/ai-task-manager init --assistants claude,gemini,opencode
|
|
53
24
|
```
|
|
54
25
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
### 📂 Directory Structure
|
|
58
|
-
|
|
59
|
-
When you initialize with assistant selection, the following directory structure is created:
|
|
60
|
-
|
|
61
|
-
```
|
|
62
|
-
project-root/
|
|
63
|
-
├── .ai/
|
|
64
|
-
│ └── task-manager/ # Shared configuration files
|
|
65
|
-
│ ├── plans
|
|
66
|
-
│ ├── TASK_MANAGER.md # General information to operate the task manager
|
|
67
|
-
│ └── POST_PHASE.md # Validation gates for phase completion
|
|
68
|
-
├── .claude/ # Claude files (if selected)
|
|
69
|
-
│ └── commands/ # Custom slash commands for Claude
|
|
70
|
-
│ └── tasks/
|
|
71
|
-
│ ├── create-plan.md
|
|
72
|
-
│ ├── execute-blueprint.md
|
|
73
|
-
│ └── generate-tasks.md
|
|
74
|
-
├── .gemini/ # Gemini files (if selected)
|
|
75
|
-
│ └── commands/ # Custom slash commands for Gemini
|
|
76
|
-
│ └── tasks/
|
|
77
|
-
│ ├── create-plan.toml
|
|
78
|
-
│ ├── execute-blueprint.toml
|
|
79
|
-
│ └── generate-tasks.toml
|
|
80
|
-
├── .opencode/ # Open Code files (if selected)
|
|
81
|
-
│ └── commands/ # Custom slash commands for Open Code
|
|
82
|
-
│ └── tasks/
|
|
83
|
-
│ ├── create-plan.md
|
|
84
|
-
│ ├── execute-blueprint.md
|
|
85
|
-
│ └── generate-tasks.md
|
|
86
|
-
└── project files...
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
## 💡 Suggested Workflow
|
|
90
|
-
|
|
91
|
-
### 📋 One-time Setup
|
|
92
|
-
|
|
93
|
-
Review and tweak the `.ai/task-manager/TASK_MANAGER.md` and `.ai/task-manager/config/hooks/POST_PHASE.md`. These files are yours to edit and should reflect your project's tech stack and goals.
|
|
26
|
+
## 📖 Documentation
|
|
94
27
|
|
|
95
|
-
|
|
28
|
+
**For complete setup instructions, features, and workflow guides, visit:**
|
|
96
29
|
|
|
97
|
-
|
|
98
|
-
2. 💬 Provide additional context if the assistant needs it.
|
|
99
|
-
3. ⚠️ Manually review the plan and make the necessary edits. You might be tempted to skip this step, **do not skip this step**. Find the plan document in `.ai/task-manager/plans/01--authentication-workflow/plan-01--authentication-workflow.md`
|
|
100
|
-
4. 📋 Create the tasks for the plan: `/tasks:generate-tasks 1`
|
|
101
|
-
5. 👀 Review the list of tasks. This step is important to avoid scope creep and ensure the right things are to be built. Again, **do not skip this step**. Find the tasks in the folder `.ai/task-manager/plans/01--authentication-workflow/tasks/`
|
|
102
|
-
6. 🚀 Execute the tasks: `/tasks:execute-blueprint 1`
|
|
103
|
-
7. ✅ Review the implementation and the generated tests.
|
|
30
|
+
### 🌐 **[Documentation Site →](https://mateuaguilo.com/ai-task-manager/)**
|
|
104
31
|
|
|
105
|
-
|
|
32
|
+
The documentation includes:
|
|
33
|
+
- Detailed installation and setup instructions
|
|
34
|
+
- Complete workflow guides with examples
|
|
35
|
+
- Feature overview and capabilities
|
|
36
|
+
- Troubleshooting and best practices
|
|
37
|
+
- Architecture and customization details
|
|
106
38
|
|
|
107
|
-
|
|
108
|
-
<summary>🚫 Permission Errors</summary>
|
|
39
|
+
## 💡 Quick Workflow Preview
|
|
109
40
|
|
|
110
|
-
|
|
41
|
+
1. **📝 Create a plan**: `/tasks:create-plan Create user authentication system`
|
|
42
|
+
2. **📋 Generate tasks**: `/tasks:generate-tasks 1`
|
|
43
|
+
3. **🚀 Execute blueprint**: `/tasks:execute-blueprint 1`
|
|
111
44
|
|
|
112
|
-
|
|
113
|
-
- Ensure you have write permissions to the target directory
|
|
114
|
-
- On Unix systems, check directory ownership: `ls -la`
|
|
115
|
-
- Try running with appropriate permissions or in a user-owned directory
|
|
45
|
+
## 🤖 Supported Assistants
|
|
116
46
|
|
|
117
|
-
|
|
47
|
+
| Assistant | Interface | Cost Model |
|
|
48
|
+
|-----------|-----------|------------|
|
|
49
|
+
| 🎭 **Claude** | [claude.ai/code](https://claude.ai/code) | Your existing subscription |
|
|
50
|
+
| 💎 **Gemini** | Gemini CLI | Your existing subscription |
|
|
51
|
+
| 📝 **Open Code** | Open source | Free |
|
|
118
52
|
|
|
119
53
|
## 📄 License
|
|
120
54
|
|
|
121
|
-
|
|
55
|
+
MIT License - Open source and free to use.
|