git404hub

what is pipeline-bus fr?

kohaku4yz/pipeline-bus — explained in plain English

Analysis updated 2026-05-18

6ShellAudience · ops devopsComplexity · 3/5LicenseSetup · moderate

tl;dr

A pure git based CI/CD pipeline that uses GitHub itself as the message bus to route tasks between an AI implementer, an AI reviewer, and a human owner.

vibe map

mindmap
  root((pipeline-bus))
    What it does
      Git as message bus
      Implement then review
      Two round cap
    Tech stack
      Shell
      Git
      Cron
    Use cases
      Automated small tasks
      Cross machine agents
      Audit via git log
    Audience
      DevOps teams
      AI workflow builders

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 make with this?

VIBE 1

Automate a small dev workflow where one AI model implements a ticket and another reviews it before a human merges.

VIBE 2

Coordinate two machines running different AI models without setting up any message queue or webhook infrastructure.

VIBE 3

Use git history as a built in audit trail for every task, review comment, and status change.

what's the stack?

ShellGitCron

how it stacks up fr

kohaku4yz/pipeline-busabhayparolkar/zboydmaynard51/ultima1-ios
Stars666
LanguageShellShellShell
Setup difficultymoderatehardmoderate
Complexity3/54/53/5
Audienceops devopsdevelopergeneral

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

how do i run it?

Difficulty · moderate time til it works · 30min

Requires cron access on both an implementer and reviewer machine, each with its own AI coding agent installed.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice (MIT license).

in plain english

pipeline-bus is a git only continuous integration and delivery pipeline that connects separate machines and AI coding agents into a shared, automated workflow without any dedicated backend server. An owner writes a task file describing what needs to be built along with acceptance criteria that can be checked by running a command, then pushes it to this repository. A cron job on an implementation machine, running a cheaper, high throughput AI model, notices the new task, claims it, writes the code into its own working branch, and pushes that branch back. A separate cron job on a review machine, running a mid tier model, then reviews the change against the acceptance criteria and leaves comments. The human owner does the final review and merges the finished work into the real target repository. The only communication layer in the whole system is GitHub itself: there is no webhook, no message queue, and no process talking directly to another process. Each side simply polls its own state and pushes commits, and git's own atomic push and commit history double as both the coordination mechanism and the audit trail. The review step only ever returns one of two verdicts, approved or needs changes, so the state machine that drives the whole pipeline can be a single line of logic, and any needs changes verdict must include specific direction on what to change so tasks do not stall on vague feedback. To limit runaway costs, a task gets at most two rounds of review before it is marked stuck and a human is notified to look at it directly, rather than letting the two models argue back and forth indefinitely. The project estimates a typical task costs well under a dollar in total model usage across both rounds. It is intended for small, well scoped tasks such as one patch, one document, or one small tool, not for large open ended engineering work. The project is written mainly in Shell script, is released under the MIT license, and is not meant to be opened up as a public marketplace for untrusted task submitters, since anyone who can push to the repository can effectively make the implementation agent run arbitrary commands.

prompts (copy fr)

prompt 1
Write a task file and status file for pipeline-bus and push a new job to the queue.
prompt 2
Explain how pipeline-bus's cron poller claims a task and avoids two machines claiming the same one.
prompt 3
Help me set up the reviewer side of pipeline-bus with an allowlisted set of tools.
prompt 4
Walk me through what happens in pipeline-bus when a task gets stuck after two review rounds.

Frequently asked questions

what is pipeline-bus fr?

A pure git based CI/CD pipeline that uses GitHub itself as the message bus to route tasks between an AI implementer, an AI reviewer, and a human owner.

What language is pipeline-bus written in?

Mainly Shell. The stack also includes Shell, Git, Cron.

What license does pipeline-bus use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice (MIT license).

How hard is pipeline-bus to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is pipeline-bus for?

Mainly ops devops.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.