Skip to content
tobihagemannPublic

About

Ship changes of any size with confidence. An agentic software factory for Claude Code and Codex.

Topics

Resources

Contributing

Stars

424 stars

Watchers

9 watching

Forks

Repository files navigation

Turbo lightning hammer

Turbo

Ship changes of any size with confidence.
An agentic software factory for Claude Code and Codex.


Bring your agent any idea or problem, big or small, and it asks you questions until you agree on what to build. From there it runs on its own. Every change goes through your project's checks and a multi-agent review, with Codex checking Claude's work or the other way around. UI changes also get a smoke test in the live app. Your agent comes back to you so you can judge the result, sign off before anything ships, and settle any call that's yours to make. At the end of each change, your agent saves what it learned to instructions, memory, or skills, ready for the next session.

Claude Code: production-tested · Codex: experimental, with skill parity but less real-world use

Get started · The factory · What you can do · Browse the guides

The Factory

Start with a change you want to make:

/turbo:plan add password reset to the app

The change moves through six stages. You decide at Shape and judge at Try and Ship. The skills run the rest.

Stage What happens Skill
Shape Settle what to build and how. You approve the shape or the plan before any code is written. /turbo:plan
Build Make the change and verify it runs, with a smoke test in the live app for user-facing changes. /turbo:implement
Try You try a user-facing change in the live app and say whether it's right. /turbo:preview
Polish Run the project's checks, review with parallel agents and the other model as peer, fix, and repeat until stable. /turbo:polish-code
Learn Carry corrections and conventions into instructions, memory, and skills. /turbo:self-improve
Ship Commit, push, and open the pull request once you approve. Then resolve AI review feedback and failing checks until it's green, and merge when you say so. /turbo:ship, /turbo:land-pr

Examples use Claude Code's /turbo:skill-name syntax. In Codex, use $turbo:skill-name:

$turbo:plan add password reset to the app

Get Started

What you'll need:

  • A Claude Code or Codex plan with headroom. Pipeline workflows are context-heavy, so higher-tier plans work best.
  • Codex (for the Claude Code edition) or Claude Code (for the Codex edition), which /finalize uses for peer review. You can swap in your own review setup.
  • The GitHub CLI.

See requirements for what setup changes on your machine and what your project should have.

Claude Code: install the plugin, then open /plugin → Marketplaces and switch on auto-update for turbo.

/plugin marketplace add tobihagemann/turbo
/plugin install turbo@turbo

Codex: install the plugin, then trust Turbo's hook when Codex asks at its next start.

codex plugin marketplace add tobihagemann/turbo
codex plugin add turbo@turbo

Then paste this into Claude Code or Codex for the remaining one-time steps (prerequisites, settings, and optional extras):

Walk me through the Turbo setup. Read SETUP.md from the tobihagemann/turbo repo and follow the guide for your edition.

Prefer to read the steps first? Open the Claude Code setup or Codex setup guide.

Installed Turbo before it shipped as a plugin? Run /update-turbo (or $update-turbo) once. It moves you to the plugin and keeps your edited skills unless you choose otherwise.

What You Can Do

You can start with any of these skills; you don't need to learn the whole pipeline first.

I want to… Claude Code Codex
Plan and build a change /turbo:plan $turbo:plan
Understand a failing test or bug /turbo:investigate $turbo:investigate
Review a pull request /turbo:review-pr $turbo:review-pr
Finish and ship a change /turbo:finalize $turbo:finalize

Skills also work naturally in a request: tests are failing in the auth module, can you please /turbo:investigate?

See more prompt examples for dependency updates, UI testing, PR feedback, and other everyday tasks.

Why Turbo

  • A process you can repeat. Planning, investigation, review, and shipping workflows are written down as skills, so you can invoke them without rebuilding the prompt each time. They use your project's existing tests, linters, formatters, and hooks.
  • Pieces you can swap. Use individual skills or compose them into larger workflows. A skill of your own with the same name takes over that piece, inside Claude Code pipelines too. The skills are plain Markdown using the harness's native tools.
  • Lessons carried forward. /self-improve captures corrections and project conventions in instructions, memory, and skills, so future sessions can build on what you've learned.

You stay involved in choosing the approach and reviewing the result. Turbo works best alongside the checks and engineering judgment you already bring to a project.

Go Deeper

  • Workflow guide — the six stages from your side, then the plan and finalize pipelines, self-improvement, and browser testing.
  • Prompt examples — requests you can copy into your next session.
  • Requirements — accounts, what setup changes, and the project infrastructure Turbo builds on.
  • Claude Code mod — open items above the prompt, the status line, compaction that continues on its own, and clearing that continues from a finished plan or a handoff.
  • Customization — override skills, update the plugin, and work on Turbo or a fork.
  • All skills: Claude Code index · Codex index — descriptions and dependencies for every skill.

If Turbo helps you ship, consider sponsoring my open source work.

Distributed under the MIT License.

About

Ship changes of any size with confidence. An agentic software factory for Claude Code and Codex.

Topics

Resources

Contributing

Stars

424 stars

Watchers

9 watching

Forks

Sponsor this project

Contributors

Languages