dodo-runner 🦤

Intent-to-Execution background agent runner for DoDo. Turn your todos into autonomous, verified code commits.

Quick Start

Run this command inside any Git repository:

npx dodo-runner

Then open your DoDo app (or https://dodo.day) and add a task tagged with #ai:

Add session expiration modal #ai

The runner will automatically:

1. Detect the #ai task.
2. Create an isolated Git branch (agent/dodo-xxx).
3. Run the coding agent and verify with npm test.
4. Commit the changes and mark the todo completed in DoDo with Git reference & focus duration badges.

Safety & Rollbacks

• Zero-Pollution Sandbox: All changes happen on temporary agent/dodo-* branches. Your main branch is never touched directly.
• Verification Gatekeeper: If npm test fails after 2 self-healing attempts, changes are completely rolled back (git reset --hard) and discarded.
• Mid-Flight Abort: If you edit or delete the todo in DoDo while the agent is working, the runner immediately kills the process and resets the branch.
• Undo: Run npx dodo-runner --undo to delete the agent branch and return to main.

Options

npx dodo-runner --test-cmd "npm run test:unit"  # Custom test command
npx dodo-runner --poll 2000                     # Polling interval in ms (default 1500)
npx dodo-runner --undo                          # Discard current agent branch
npx dodo-runner --once                          # Process 1 pending task and exit

License

MIT © DoDo