Skip to main content
command CX Codex

todo-branch — Claude Code command: what it does, how to install

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

no license ★ 1,357 updated 2026-03-01

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/todo-branch.md
Open on GitHub

What todo-branch 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.

What it helps with

  • 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 for the agent

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

How to install todo-branch

Manually: put the files in place

.claude/commands/todo-branch.md

Call it with /todo-branch. For all projects use ~/.claude/commands/

Questions about todo-branch

How to install todo-branch in Claude Code?

Place the command definition file into .claude/commands/todo-branch.md within your project repository.

Does todo-branch require git worktrees?

No, it deliberately works directly on your current branch and bundles all changes into a single commit at the end.

How does the command handle interrupted runs?

It inspects task folders inside todos/work/, checks whether the recorded process ID is still alive, and lets you resume from the exact phase where it stopped.

Similar slash commands

All slash commands for Notes, tasks and projects →

From the same set112

The whole set →
python-pro python-pro is a Claude Code subagent for Python refactoring, performance work, and complex features. It joins these coding tasks and includes tests with its changes. CX Codex ★ 1,357repo stars ai-engineer ai-engineer designs RAG pipelines, configures vector databases, and writes agent workflows for LLM applications. Built for developers adding AI features. CX Codex ★ 1,357repo stars project-health-check project-health-check is a Claude Code command that reviews Git activity, dependencies, security findings, and Linear task metrics in a project health report. It helps identify risks to investigate. CX Codex +1 ★ 1,357repo stars setup-agent-tail setup-agent-tail is a Claude Code skill that deploys agent-tail in a project, detects its framework, installs the CLI and plugins, and routes server and browser logs to files for an agent. CX Codex +1 ★ 1,357repo stars graphql-architect The graphql-architect subagent designs and improves GraphQL APIs, covering schemas, resolvers, federation, and subscriptions. Use it for new APIs, performance audits, or refactoring. CX Codex ★ 1,357repo stars bidirectional-sync bidirectional-sync — a slash command that pairs GitHub issues with Linear tasks and copies edits both ways, settling the ones that landed on both sides. CX Codex +1 ★ 1,357repo stars dx-optimizer dx-optimizer configures developer environments, project automation scripts, and Git hooks to eliminate workflow friction and speed up onboarding. CX Codex ★ 1,357repo stars clean-branches clean-branches — a command that systematically removes merged and inactive branches from Git. Keeps your repository clean by deleting obsolete branches and syncing local state with the remote. CX Codex +1 ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open