# todo-branch

todo-branch executes backlog items on your active Git branch through guided phases, step-by-step approvals, and a single final commit.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/commands/project/todo-branch.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/todo-branch

## What it does

This command converts items from `todos/todos.md` into functional code without switching branches or setting up git worktrees. The lifecycle follows five sequential phases: initialization, selection, codebase exploration, implementation, and commit. The assistant pauses at designated checkpoints, requiring explicit confirmation before proceeding.

Under the hood, parallel sub-agents inspect the codebase to map build scripts, entry points, and test frameworks into `todos/project-description.md`. When you pick a task, it generates an isolated directory inside `todos/work/` containing an architecture analysis and an actionable checklist.

The process relies on a Git repository and local markdown files. Every file change gets staged as tasks finish, culminating in one unified Git commit that bundles your code updates with updated task logs.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/todo-branch.md` — Call it with /todo-branch. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/todo-branch.md` — Call it with /prompts:todo-branch. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/todo-branch.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/todo-branch.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/commands/project/todo-branch.md

## When to use it
- Convert rough items in `todos/todos.md` into verified features
- Recover abandoned implementation sessions using background process checks
- Enforce step-by-step manual sign-off before modifying code
- Keep branch history clean by bundling task notes and code into one commit

## Example prompts
- /todo-branch
- Run /todo-branch to pick up the next task from the backlog
- Check for unfinished tasks using /todo-branch

## Similar
- [todo-archive](https://affpapa.org/en/nevibecode/skills/todo-archive.md) — skill · 130 installs
- [todo](https://affpapa.org/en/nevibecode/commands/todo.md) — command · 2723 installs
- [glab-todo](https://affpapa.org/en/nevibecode/skills/glab-todo.md) — skill · 115 installs
- [todo-tracker](https://affpapa.org/en/nevibecode/skills/sundial-org-todo-tracker.md) — skill · 176 installs
- [create-branch](https://affpapa.org/en/nevibecode/skills/create-branch.md) — skill · 4400 installs
- [new-branch-and-pr](https://affpapa.org/en/nevibecode/skills/new-branch-and-pr.md) — skill · 2300 installs

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
