Braid is a hybrid interactive coding agent with a deeply integrated graph workflow system.
  • Python 74.4%
  • TypeScript 22.3%
  • JavaScript 1.9%
  • Shell 0.9%
  • CSS 0.3%
  • Other 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-21 11:29:59 -05:00
.claude chore(openspec): regenerate the OpenSpec skills and commands with 1.14.1 (#155) 2026-10-08 22:59:07 -04:00
.forgejo/workflows feat(sandbox): fail closed, and the deploy's options, packages and self-check (#203) 2026-11-11 17:12:55 -05:00
.osf test: replace the suite with one that runs in a minute (#241) 2026-10-22 17:40:45 -04:00
deploy fix: the first batch from runs 194 and 195 (#506) 2026-11-12 10:10:06 -05:00
docs fix(replay): a step is captured again, and replays on Free in production's sandboxes (#581) 2026-11-21 11:16:09 -05:00
openspec chore(openspec): archive readable-pull-requests-570, step-replays-581 and chain-without-unknown-model-582 (#570, #581, #582) 2026-11-21 11:27:54 -05:00
sim feat(pr): a pull request opens with a short summary and the merge gate's checks, and folds Braid's record (#570) 2026-11-21 11:16:09 -05:00
src/osf fix(free): a model the router does not know leaves the chains (#582) 2026-11-21 11:16:09 -05:00
tests fix(free): a model the router does not know leaves the chains (#582) 2026-11-21 11:16:09 -05:00
tools feat(testing): Midway, the standard brief for a whole run, and the command that starts it (#489) 2026-11-11 17:23:11 -05:00
ui fix(replay): a step is captured again, and replays on Free in production's sandboxes (#581) 2026-11-21 11:16:09 -05:00
.dockerignore test: replace the suite with one that runs in a minute (#241) 2026-10-22 17:40:45 -04:00
.gitignore ci(test): bake git 2.45+, tini, uv and openspec into a braid-ci image 2026-10-21 18:51:06 -04:00
AGENTS.md docs(agents): keep the skip-CI marker out of a pull request's title 2026-11-11 15:11:25 -05:00
CLAUDE.md feat(replay): capture a step of a run and replay it on the laptop (#340) 2026-10-30 13:22:04 -04:00
Dockerfile fix: the first batch from runs 194 and 195 (#506) 2026-11-12 10:10:06 -05:00
LICENSE chore(repo): the public repository shows no network map, carries a licence, and locks a fixed urllib3 (#146) 2026-10-05 15:24:34 -04:00
pyproject.toml test: replace the suite with one that runs in a minute (#241) 2026-10-22 17:40:45 -04:00
README.md docs: the README's acknowledgements as a table again, with GoModel and the rest of what Braid adopts [skip ci] 2026-10-19 14:16:24 -04:00
uv.lock test(lanes): a hung test fails, heavy lanes take turns, and the fast lane runs a smoke sim (braid#227) 2026-10-20 20:17:28 -04:00

Braid: Coding agent + Graph orchestration

🚧 Beta - still under heavy development 🚧

Braid's console on a finished run: phases across the top, steps down the left, and the apply step's summary of the change it implemented

Coding agent: live opencode sessions in an interactive console Graph orchestration: built on OpenSpec and Git flow, with your approvals Remote service: runs as a service, web based, mobile friendly

Deploy with Docker

You need Docker with Compose, and a Forgejo account with an access token (repository, issue and user: read and write).

git clone https://forgejo.underthere.xyz/cmoriarty/braid.git
cd braid
docker build -t braid:latest .

Create deploy/.env:

BRAID_IMAGE=braid:latest
OSF_FORGEJO_URL=https://your-forgejo.example.com
OSF_FORGEJO_TOKEN=<your token>
OSF_UI_BASE_URL=http://<this host>          # where pull requests link back to
OSF_UPSTREAM_URL=http://<model host>/v1     # optional: a local OpenAI-compatible model server

Then start it:

docker compose -f deploy/docker-compose.yml up -d

Open http://<this host>. curl http://<this host>/api/status reports "ready" when it is up.

Braid has no login: anyone who can reach the port can start runs and approve gates. Keep it on a private network.

Free-model provider keys and the other optional settings are listed in deploy/.env.example.

Get started

1 · Pick a backend

Your own model server, a paid API such as Anthropic, or Free, which spreads steps across free model APIs.

Settings, Backend: a local vLLM server being connected

2 · Choose a graph

New Run asks for a repository and a pipeline. thorough explores, proposes, reviews, builds, tests and opens a pull request.

New Run: the pipeline choice, from thorough to quick-fix

3 · Start from an issue

Pick an open issue, or describe a feature in your own words.

New Run: picking an open issue

4 · Approve the gates

The run stops where your judgement counts. Read the diff, then Approve or Request changes. Turn on auto-approve to let it run to a merged pull request on its own.

A run waiting at the proposal review, with the diff and the Approve button

Acknowledgements

Braid stands on the shoulders of these open-source projects.

OpenSpec Spec-driven changes; openspec validate checks every proposal
opencode The agent runtime: each step drives an opencode session
GoModel The router behind the Free backend, spreading steps across free model APIs
Forgejo Issues in, pull requests out
Qwen · vLLM Open-weight models, served on your own hardware
Playwright The browser a judge opens a UI change in
Starlette · Uvicorn · HTTPX The server, its API and its calls out
SQLite The run log
uv Python packaging and the image's build
React · Vite · Tailwind CSS · virtua The console
JetBrains Mono · IBM Plex The console's typefaces

Learn more

  • Guide: running from source, the console, every pipeline in detail
  • Design: the design of record

License

MIT