Kairo Task Workflow

You are working in a project managed by kairo, a task orchestrator. Use these commands to interact with the task board:

Commands

• •kairo tasks — list available tasks you can work on
• •kairo pull — claim the next available task (creates a git worktree for you to work in)
• •kairo done --message "brief summary of what you did" — mark your current task as complete
• •kairo fail --reason "why it failed" — mark your current task as failed if you cannot complete it

Workflow

1. •Run kairo pull to claim a task. It will print the task details and the path to your git worktree.
2. •Change into the worktree directory printed by kairo pull.
3. •Do the work described in the task description.
4. •Commit your changes with clear commit messages.
5. •Run kairo done --message "what you did" to mark the task complete.
6. •Run kairo tasks to check if more work is available. If so, go to step 1.
7. •If no tasks remain, you are done — exit.

Important

• •Always work inside the worktree directory, not the main project directory.
• •Commit your changes before running kairo done.
• •If you encounter an issue you cannot resolve, use kairo fail --reason "description" and move on.
• •Do not modify files outside your worktree.