whatisgithub

What is orchflows?

danmcinerney/orchflows — explained in plain English

Analysis updated 2026-05-18

11PythonAudience · developerComplexity · 3/5Setup · easy

In one sentence

A library of small, composable AI agent skills that routes any request, from a one line question to a full feature build, to the smallest workflow that can prove it is done.

Mindmap

mindmap
  root((orchflows))
    What it does
      Auto routes requests to workflows
      Composable skill bricks
      Self improving over time
    Tech stack
      Python
      Claude Code
      Codex
    Use cases
      Ship a feature end to end
      Fix a flaky test
      Visualize a codebase
    Audience
      Developers
      Power agent users
    Install
      Shell install script
      Auto detects harness

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let an agent automatically pick the right sized workflow for a request instead of chaining commands manually

USE CASE 2

Ship a feature with a frozen spec, ticket breakdown, and parallel subagent execution

USE CASE 3

Mine past agent session logs for recurring friction and turn it into workflow improvements

USE CASE 4

Turn a workflow, codebase, or process into a verified Mermaid diagram

What is it built with?

PythonClaude CodeCodex

How does it compare?

danmcinerney/orchflows2arons/llm-cliabe238/claude-video-plus
Stars111111
LanguagePythonPythonPython
Setup difficultyeasyeasyeasy
Complexity3/52/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

So what is it?

Orchflows is a set of composable skills for Claude Code and Codex that decides how much process a task actually needs. Instead of manually chaining separate commands or memorizing skill names, you just describe what you want in plain language, and the system routes the request to the smallest workflow that can prove it finished the job. A one line question gets a one line answer, while a large feature build gets a frozen specification, tickets broken into pieces, work split across parallel subagents, and a review step at the end. There are 37 small skills in total, and each one is kept intentionally short so it does not clutter the model's context with unnecessary instructions. The project is built around small reusable pieces called bricks, each doing one job. For example, orch-deliver ships work, orch-critique attacks it looking for flaws, orch-judge scores it without bias, orch-loop repeats a step until a condition passes, and orch-fix proves the cause of a bug before attempting a repair. These bricks connect through a small number of shared data formats, so a piece built for one kind of project, such as writing code, can be reused for another, such as a research report, just by swapping which pack of settings is active. A notable feature is self-improvement: a skill called orch-self-improve reads logs of past runs, including retries and workarounds, and turns recurring friction points into proposals the user can accept or reject, such as adding a missing documentation step to a workflow. There is also orch-visualize, which turns a workflow, codebase, or process into a Mermaid diagram that is checked against a real renderer before being returned. Installation is a git clone followed by a shell script that detects Python and configures whichever of Claude Code or Codex is present on the machine, and works on both Windows and POSIX systems. The README does not state a license in the portion available.

Copy-paste prompts

Prompt 1
Install orchflows and set it up for both Claude Code and Codex on my machine
Prompt 2
Build me a custom orchflows workflow that reads documentation then writes a spec
Prompt 3
Run orch-self-improve on my recent sessions and show me what it proposes
Prompt 4
Use orch-visualize to diagram how my current codebase is structured

Frequently asked questions

What is orchflows?

A library of small, composable AI agent skills that routes any request, from a one line question to a full feature build, to the smallest workflow that can prove it is done.

What language is orchflows written in?

Mainly Python. The stack also includes Python, Claude Code, Codex.

How hard is orchflows to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is orchflows for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.