The TODO list feature enables Kiro to automatically create and modify task lists, while providing you with commands to view and manage existing TODO lists.
TODO lists are automatically created when Kiro breaks down complex tasks. You can then manage these lists using the /todos command.
kiro-cli settings chat.enableTodoList true
/todos view # View existing TODO lists /todos resume # Resume a TODO list
Kiro automatically creates TODO lists when:
Example:
> Make a todo list with 3 read-only tasks. I'll create a todo list with 3 read-only tasks for you. 🛠️ Using tool: todo_list (trusted) ⋮ ● TODO: [ ] Review project documentation [ ] Check system status [ ] Read latest updates ⋮ ● Completed in 0.4s
Kiro can:
You can:
Display and select a TODO list to view its contents, showing task descriptions and completion status.
/todos view
Interactive selection shows:
Example:
> /todos view ? Select a to-do list to view: › ❯ ✗ Unfinished todo list (0/3) ✔ Completed todo list (3/3)
Show an interactive menu of available TODO lists with their current progress status. Selecting a list loads it back into your chat session, allowing Kiro to continue where it left off.
/todos resume
Example:
> /todos resume ⟳ Resuming: Read-only tasks for information gathering 🛠️ Using tool: todo_list (trusted) ⋮ ● TODO: [x] Review project documentation [ ] Check system status [ ] Read latest updates ⋮ ● Completed in 0.1s
Remove all completed TODO lists from storage. This helps clean up your workspace by removing lists where all tasks have been completed.
/todos clear-finished
Delete specific TODO lists or all lists at once.
/todos delete # Interactive selection to delete one list /todos delete --all # Delete all TODO lists
Options:
--all - Delete all TODO lists without interactive selectionTODO lists are stored locally in .kiro/cli-todo-lists/ directory within your current working directory.
Each list is saved as a JSON file with:
my-project/ ├── .kiro/ │ └── cli-todo-lists/ │ ├── 1234567890-task-list.json │ └── 1234567891-another-list.json └── src/ └── main.py
All commands use interactive selection allowing you to:
> I need to migrate our database from MySQL to PostgreSQL Let me create a TODO list for this migration: 🛠️ Using tool: todo_list ● TODO: Database Migration [ ] Backup current MySQL database [ ] Set up PostgreSQL instance [ ] Create schema migration scripts [ ] Test migration on staging [ ] Perform production migration [ ] Verify data integrity
> Help me implement user authentication I'll break this down into manageable steps: 🛠️ Using tool: todo_list ● TODO: User Authentication Implementation [ ] Set up authentication library [ ] Create user model and database schema [ ] Implement registration endpoint [ ] Implement login endpoint [ ] Add password hashing [ ] Create JWT token generation [ ] Add authentication middleware [ ] Write tests for auth flow
> /todos resume ? Select a to-do list to resume: › ❯ ✗ User Authentication Implementation (3/8) ✗ Database Migration (1/6) ✔ Code Refactoring (5/5) # Select "User Authentication Implementation" ⟳ Resuming: User Authentication Implementation Let's continue with the authentication implementation. We've completed the first 3 tasks. Next up is implementing the login endpoint...
clear-finished regularly to remove completed listsview to see progress without resumingresume to pick up where you left off in previous sessionsview to see what tasks remain before resuming workIf commands show "No to-do lists available":
.kiro/cli-todo-lists/ directoryIf lists exist but won't load:
.kiro/cli-todo-lists/If task completion isn't being tracked:
todo_list toolThe todo_list tool is for Kiro to call. Kiro can:
/todos commandThe /todos command is for you to manage existing TODO lists. You can:
> I need to set up CI/CD for our project
🛠️ Using tool: todo_list ● TODO: CI/CD Setup [ ] Choose CI/CD platform [ ] Create pipeline configuration [ ] Set up build stage [ ] Add test stage [ ] Configure deployment stage [ ] Set up environment variables [ ] Test pipeline
Kiro works through tasks, marking them complete as you go.
> /todos resume ? Select a to-do list to resume: › ❯ ✗ CI/CD Setup (4/7) # Continue where you left off
> /todos clear-finished
TODO lists