The todo command and --todo flag help you manage task lists and automatically generate todos from agent responses.
Quick Start
# Generate todo from task
praisonai "Plan the project" --todo
# Add a todo manually
praisonai todo add "Implement feature X"
# List all todos
praisonai todo list
Commands
Add Todo
praisonai todo add "Implement user authentication"
✅ Added: Implement user authentication
📋 Todo List:
--------------------------------------------------
1. ⬜ 🟡 Implement user authentication
--------------------------------------------------
0/1 completed
List Todos
Expected Output:
📋 Todo List:
--------------------------------------------------
1. ⬜ 🔴 Fix critical bug in payment system
2. ⬜ 🟡 Implement user authentication
3. ⬜ 🟡 Write API documentation
4. ✅ 🟢 Set up CI/CD pipeline
5. ⬜ 🟢 Add unit tests
--------------------------------------------------
1/5 completed
Legend: 🔴 High 🟡 Medium 🟢 Low
⬜ Pending ✅ Completed
Complete Todo
praisonai todo complete 2
✅ Completed: Implement user authentication
📋 Todo List:
--------------------------------------------------
1. ⬜ 🔴 Fix critical bug in payment system
2. ✅ 🟡 Implement user authentication
3. ⬜ 🟡 Write API documentation
4. ✅ 🟢 Set up CI/CD pipeline
5. ⬜ 🟢 Add unit tests
--------------------------------------------------
2/5 completed
Delete Todo
Expected Output:
🗑️ Deleted: Write API documentation
📋 Todo List:
--------------------------------------------------
1. ⬜ 🔴 Fix critical bug in payment system
2. ✅ 🟡 Implement user authentication
3. ✅ 🟢 Set up CI/CD pipeline
4. ⬜ 🟢 Add unit tests
--------------------------------------------------
2/4 completed
Clear Todos
Expected Output:
⚠️ Clear all todos? (y/N): y
🗑️ All todos cleared.
Help
Expected Output:
Todo Commands:
praisonai todo add <task> - Add a new todo item
praisonai todo list - List all todos
praisonai todo complete <id> - Mark todo as complete
praisonai todo delete <id> - Delete a todo
praisonai todo clear - Clear all todos
praisonai todo help - Show this help
Using --todo Flag:
praisonai "task" --todo - Generate todos from response
Using —todo Flag
Generate Todos from Task
praisonai "Plan the implementation of a REST API" --todo
╭─ Agent Info ─────────────────────────────────────────────────────────────────╮
│ 👤 Agent: DirectAgent │
│ Role: Assistant │
│ 📋 Todo Generation: Enabled │
╰──────────────────────────────────────────────────────────────────────────────╯
╭────────────────────────────────── Response ──────────────────────────────────╮
│ Here's a plan for implementing the REST API: │
│ │
│ 1. Design the API schema and endpoints │
│ 2. Set up the project structure │
│ 3. Implement authentication middleware │
│ 4. Create CRUD endpoints for resources │
│ 5. Add input validation │
│ 6. Implement error handling │
│ 7. Write unit tests │
│ 8. Add API documentation │
╰──────────────────────────────────────────────────────────────────────────────╯
📋 Generated Todos:
--------------------------------------------------
1. ⬜ 🟡 Design the API schema and endpoints
2. ⬜ 🟡 Set up the project structure
3. ⬜ 🟡 Implement authentication middleware
4. ⬜ 🟡 Create CRUD endpoints for resources
5. ⬜ 🟡 Add input validation
6. ⬜ 🟡 Implement error handling
7. ⬜ 🟢 Write unit tests
8. ⬜ 🟢 Add API documentation
--------------------------------------------------
0/8 completed
✅ 8 todos generated from response
Combine with Planning
praisonai "Plan a machine learning project" --todo --planning
📋 PLANNING PHASE
Creating implementation plan...
[Planning output...]
📋 Generated Todos from Plan:
--------------------------------------------------
1. ⬜ 🔴 Define problem statement and success metrics
2. ⬜ 🔴 Collect and prepare training data
3. ⬜ 🟡 Perform exploratory data analysis
4. ⬜ 🟡 Feature engineering
5. ⬜ 🟡 Model selection and training
6. ⬜ 🟡 Hyperparameter tuning
7. ⬜ 🟢 Model evaluation
8. ⬜ 🟢 Deploy model to production
--------------------------------------------------
0/8 completed
Use Cases
Project Planning
praisonai "Plan the development of a mobile app" --todo
Sprint Planning
praisonai "Break down the user story: As a user, I want to reset my password" --todo
Learning Path
praisonai "Create a learning plan for Kubernetes" --todo
Bug Triage
praisonai "Analyze this error and suggest fixes" --todo --fast-context ./src
Todo Storage
Todos are stored locally in .praison/todos.json:
{
"todos": [
{
"id": 1,
"task": "Implement user authentication",
"priority": "medium",
"completed": false,
"created": "2024-12-16T15:30:00Z"
}
]
}
Priority Levels
| Priority | Icon | Description |
|---|
| High | 🔴 | Critical tasks, blockers |
| Medium | 🟡 | Standard priority |
| Low | 🟢 | Nice-to-have, can wait |
Best Practices
Use --todo with --planning for comprehensive project breakdowns with actionable tasks.
Regular Review
Use praisonai todo list regularly to track progress
Clear Completed
Periodically clear completed todos to keep list manageable
Combine with Planning
Use --planning --todo for detailed task breakdowns
Project-Specific
Consider using different workspaces for different projects
Workflow Example
# 1. Generate todos from project plan
praisonai "Plan the API implementation" --todo --planning
# 2. View todos
praisonai todo list
# 3. Work on first task
praisonai "Help me design the API schema" --fast-context ./src
# 4. Mark as complete
praisonai todo complete 1
# 5. Continue with next task
praisonai todo list
