MAIN BRANCH
GitHub
GitHub ...
Runs in
  • Claude CodeClaude Code
  • CodexCodex

A business harness for AI agents.

Stop renting your business. Run it from a folder Claude and Codex already know how to read.

Install Main Branch View on GitHub
Install
pipx install mainbranch

Runs from your computer. Memory in GitHub GitHub. Free and open source.

Why this exists

Context scatters fast.

A Notion page for the offer. Looms for voice. Google Docs for research. A few chats with good ideas. A launch plan somewhere. Decisions no one can find when the next AI session starts.

Main Branch turns one folder on your computer into business memory your agent reads before it answers, then saves approved decisions, launches, bets, pages, ads, research, and lessons back into files you own.

Built for revenue-producing work. Not another SaaS dashboard. Not another rented memory.

Six jobs, one order.

Practical workflows for the next session, the next push, and the next checkpoint.

  1. 01

    Starts every session from business facts

    mb-start reads status, MoneyPath, recent work, drift, provider readiness, and ranked actions before the agent gives advice.

  2. 02

    Saves long AI sessions as readable history

    mb checkpoint previews and saves approved progress with plain-English subjects. Pause Friday. Scan Monday. Nothing lost.

  3. 03

    Runs real business workflows

    mb-think, mb-ads, mb-organic, mb-site, mb-end. Multi-step skills, not prompt snippets. Approval-gated where it matters.

  4. 04

    Builds a graph of your business

    mb graph maps how decisions, research, bets, pushes, and provider refs connect. See what the agent reads from instead of trusting a black box.

  5. 05

    Keeps the business folder healthy

    mb doctor, mb validate, and repair plans check structure, links, runtime wiring, and provider state so the agent does not have to guess.

  6. 06

    Connects real tools safely

    GitHub, Cloudflare, Meta Ads, hledger, optional Apify. Curated rails. Secrets stay outside tracked files. Publishing and spend stay your call.

Sense, decide, ship, reflect.

A compact loop for one operator or a small team sharing the same business repo.

Sense

What's true right now?

Read repo health, recent activity, context freshness, provider readiness, and open work.

Decide

What should we wager?

Choose the next business move: bet, research, decision, push, repair, or playbook.

Ship

What goes into the world?

Produce pages, ads, content, reports, provider setup, saved checkpoints, and releases.

Reflect

What changed because of it?

Record verdicts, lessons, updated core files, outcomes, and next-session memory.

What changes with owned context.

Just AI Main Branch + agent
Context lives in chats, projects, docs, and memory you manage manually. Business truth lives in a folder the agent reads every session.
Output drifts away from your offer, voice, proof, or latest decision. The agent reads current files and Main Branch facts before acting.
Decisions disappear into conversation history. Decisions become plain files future sessions can cite.
Long workflows are hard to pause and resume. Checkpoints preserve approved progress in readable history.
Tool setup breaks silently. Main Branch checks health and shows the repair path.
Provider access can leak secrets or blur authority. Secrets stay outside tracked files. Provider changes stay approval-gated.

Bundled skills

Skill routes with a job.

Multi-step workflows with approval gates where the work can touch spend, publishing, or customer contact.

mb-start

Sense + Decide

Daily entry. Reads repo facts and routes the next move.

mb-think

Sense + Decide

Research, decide, and codify durable business context.

mb-ads

Decide + Ship

Plan ad copy or scripts with review before spend.

mb-organic

Decide + Ship

Draft posts, newsletters, and queues from owned strategy.

mb-site

Decide + Ship

Brief, build, check, and publish pages from context.

mb-doctor

Sense

Inspect setup, runtime drift, and repair readiness.

mb-end

Reflect

Close the session, crystallize lessons, and checkpoint.

Install

Start in the folder you own.

The first run creates the structure. After that, the agent reads before it answers.

No hosted account required.

bash 
pipx install mainbranch
mb onboard --name "My Business" \
  --path my-business
cd my-business
mb status --json --peek

FAQ

Plain answers.

What it is, who it is for, and how private context stays under your control.

What is Main Branch?

Main Branch is a free, open-source CLI and skill system that gives AI coding agents an owned business memory folder to read before they answer.

Who is Main Branch for?

Main Branch is for solo founders, agency owners, productized-service operators, indie SaaS builders, course creators, and small teams that want AI help grounded in current business context.

Does Main Branch store private business data in a SaaS account?

No. Main Branch is local-first. Your offers, research, decisions, bets, launches, outcomes, and checkpoints live in files you own.

How is Main Branch different from ChatGPT memory?

ChatGPT memory is an app feature. Main Branch is an inspectable folder and workflow layer that Claude Code, Codex, and humans can read, cite, edit, and version.

Is Main Branch open source?

Yes. The Main Branch engine is MIT-licensed and published at github.com/noontide-co/mainbranch.