Main Branch
noontide-co/mainbranch
Memória de negócio estruturada em arquivos para agentes Claude
Ver no GitHubSistema operacional baseado em arquivos para negócios internet que centraliza pesquisa, decisões, apostas e outputs em markdown/git. Integra-se com Claude Code e agentes para automatizar workflows de negócio, mantendo contexto estruturado e legível.
Instalação
npx convez-ai noontide-co/mainbranch1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Centralizar contexto de negócio (ofertas, provas, decisões, lançamentos)
- Automatizar workflows de validação de hipóteses e rastreamento de apostas
- Manter histórico de aprendizados e checkpoints em git
Veredito

Solução bem pensada para fundadores que precisam de memória de negócio estruturada legível por IA. CLI maduro com workflows nomeados, mas curva de aprendizado moderada para adotar a mentalidade de 'arquivos primeiro'.
README
A tradução para o português deste README ainda está na fila.
Why this exists
Your business context is probably scattered: a Notion page for the offer, Looms for voice, Google Docs for research, a few chats with good ideas, a launch plan somewhere, and 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.
It is built for revenue-producing work: sharpening offers, building proof, planning launches, writing ads, creating organic content, checking pages, tracking bets, and turning what you learn into the next decision.
Open the folder. Run /mb-start. Tell the agent what you want help with. Main
Branch checks what changed, what matters, and what to do next.
| Step | What you do | What happens |
|---|---|---|
| 01 | Open the business folder | Your offer, audience, voice, proof, research, bets, pushes, logs, and documents live there. |
| 02 | Run /mb-start | The agent checks current Main Branch facts before giving advice: status, MoneyPath, recent work, connected tools, drift, checkpoints, and next actions. |
| 03 | Pick the next move | The agent routes the work into an offer, bet, decision, push, playbook, research note, outcome, or checkpoint. |
| 04 | Approve the work | Writing files, publishing, spending, account changes, and customer contact stay your call. |
| 05 | Keep the lesson | Approved work becomes durable memory for the next session. |
If you want AI business memory that stays yours, star this repo so more business owners find it.
Set up with AI (recommended)
Open your strongest model — Claude Fable with the 1M context window works great; on Codex, pick the strongest model with extra reasoning — and paste this:
I want Main Branch: AI business memory I own as files in one folder
(https://github.com/noontide-co/mainbranch). First read the entire README (fetch the raw file if your tools summarize),
then explore the repo enough to understand the architecture (the mb CLI is
the deterministic control plane; skills are the judgment layer; my business
lives in its own folder, never in the engine; bets, research, decisions,
pushes, playbooks, outcomes, and checkpoints are the primitives; writing
files, publishing, spending, and customer contact stay my call). Then
interview me briefly about my business, my offer, and my audience. Then:
install the engine, run `mb onboard` to create my business folder,
then run `mb doctor` inside that folder and fix anything it flags, seed my
core files from the interview using the templates the folder ships with,
save the first checkpoint, and teach me the daily loop — /mb-start to
open, /mb-end to close. If I decline GitHub, treat local-only as a valid
choice, not something to repair. Get me to a business folder with offer,
audience, and voice drafted and a clean `mb status`, then stop and show me
what you set up.
Prefer to drive it yourself? Everything below is the manual path.
Quickstart
Start with the folder that should become your business brain:
Tell the agent what you are setting up. It should create or connect the business folder, not save your note as another document.
pipx install mainbranch
mb onboard --name "My Business" --path my-business
mb onboard creates the folder, prepares Claude Code and Codex, and shows the next step.
/mb-start reads the folder and Main Branch facts, then tells you what to do.
Daily use
- Open or select the business folder in Claude Code or Codex.
- Run
/mb-start. - Tell the agent what you want help with: an offer, page, ad, launch, research question, decision, or cleanup.
You do not need to make terminal commands your daily workflow.
Use either Claude Code or Codex. Both start from the same business folder. Step-by-step walkthrough: docs/beginner-setup.md.
Backup and sync
GitHub backup/sync is strongly recommended. It gives the business brain cloud backup, readable saved history, shared tasks/proposals, and a repo that AI tools with GitHub connectors can read. Before using the GitHub-backed path, confirm GitHub is signed in on your computer:
gh auth status
gh api user --jq .login
To create the folder, save the first scaffold, create a private GitHub repo, and push it in one pass:
mb onboard --yes --name "My Business" --path my-business --github owner/my-business --github-visibility private --push
Tested on macOS and Linux. Windows is experimental; use WSL2 for the closest supported path.
What changes
| 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 can drift 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 repair paths. |
| Connected accounts can leak secrets or blur authority. | Secrets stay outside tracked files, and account changes stay approval-gated. |
What it actually does
The short version: Main Branch makes AI business work durable, inspectable, and grounded in the business you are actually running.
1. Starts every session from business facts
/mb-start is the daily entry point. It checks:
- what changed since last time;
- what is unsaved or needs a checkpoint;
- whether offer, proof, CTA, page, channel, push, playbook, and outcome feedback are connected;
- whether content strategy, bookkeeping setup, connected tools, updates, or folder health need attention;
- the ranked next actions with the signals behind them.
You ask the agent. Main Branch runs the checks underneath the conversation.
2. Saves long AI sessions as readable history
Pause a four-hour research, offer, ad, or site session. Come back Monday. Scan your history in plain English.
When you ask to save progress, Main Branch previews the changed files, proposes
a readable checkpoint, blocks obvious secrets and scratch files, and waits for
approval. /mb-end uses the same save path to close a session.
This is not noisy autosave and not blanket automatic pushing. It is approved business memory at meaningful boundaries.
3. Runs real business workflows
Main Branch skills run multi-step workflows, not prompt snippets:
/mb-thinkresearches, sharpens offers, turns source material into decisions, analyzes sales videos, and cleans up stale claims./mb-adscreates paid creative: hooks, static ads, image prompts, video scripts, long-form paid creative, launch plans, optional read-only account checks, and 6-lens P1/P2/P3 compliance review./mb-organiccreates Reels, TikToks, carousels, static posts, and sales-video repurposing drafts from your voice and content strategy./mb-sitesupports landers, minisites, websites, Cloudflare Pages, concept variations, pitch scripts, VSL-style work, and paid-traffic measurement checks./mb-betopens, updates, closes, lists, and narrates business bets with appetite, metrics, deadlines, evidence, kill/double-down thinking, and graduation paths./mb-endcloses a session with summary, crystallization, and approved checkpoint options.
Playbooks and push records turn repeatable work into durable business memory. They record plans, approval gates, connected-account boundaries, manual steps, and outcomes without giving the agent hidden authority to publish, spend, DM, or mutate accounts.
4. Builds a graph of your business
Main Branch can map how decisions, research, bets, launches, pages, files, and connected tools relate. Use the graph to see what the agent is reading from instead of trusting a black box.
5. Keeps the business folder healthy
Main Branch checks structure, links, setup, updates, connected tools, saved history, and business relationships so the agent does not have to guess.
It can show what changed, what needs repair, what is ready to ship, what still needs approval, and where the next useful action is.
6. Connects real tools safely
Main Branch is not a connect-every-SaaS hub. It connects to real tools only where that makes daily business work clearer and safer.
The choices are deliberate. GitHub is for saved history and proposals. Cloudflare is the launch rail for domains, DNS, websites, ad landing pages, and small always-on tools. Bookkeeping uses plain files so owners have an exit path from QuickBooks-style software. Social and ad tools stay narrow until posting, spend, or account changes can be handled safely.
| Tool | What Main Branch does |
|---|---|
| GitHub | Backup, saved history, tasks/proposals, folder detection, and privacy-scrubbed public issue drafting. First-run setup can create and push a GitHub repo when you choose that path. |
| Cloudflare | The default web launch path: domain and DNS work, websites, ad landing pages, Cloudflare Pages, and future Workers for small always-on business tasks. Tokens stay out of saved files, and deploys or account changes require approval. |
| Google / Workspace | Planned optional connection for source material and metadata; durable summaries belong back in the folder. |
| Google Ads / GTM | Checks whether a site is ready to measure paid traffic. Publishing tags, creating conversions, uploading data, changing budgets, or launching campaigns requires separate approval. |
| Meta Ads | Read-only account summaries after setup. No campaign editing, budget changes, or launch claim. |
| Bookkeeping | Plain-file bookkeeping for owners who want to stop depending on QuickBooks-style software. Uses hledger under the hood, keeps raw ledgers private, tracks bet exposure, and can show sample monthly reports. |
| Apify | Optional read-only research path. No official X integration, no posting, no DMs, no guaranteed scrape coverage. |
| Postiz | Future path for scheduling and automatically posting approved content to social channels. Today, treat social posting as a draft-and-approve workflow, not an automatic publishing promise. |
Secrets stay out of saved business files. Publishing, spend, customer contact, account changes, GTM publication, Google Ads changes, Meta campaign changes, and DM automation stay approval-gated or out of scope until there is tested support.
The operating loop
Main Branch is built around four loops every business owner runs whether they name them or not.
Sense -> Decide -> Ship -> Reflect.
| Loop | The question | What it looks like |
|---|---|---|
| Sense | What's true right now? | /mb-start and /mb-status read folder health, recent work, MoneyPath, content strategy, connected-account status, and tasks/proposals. |
| Decide | What do we do next? | /mb-think, bets, decisions, and ranked actions help choose the next business move. |
| Ship | What goes out the door? | /mb-ads, /mb-organic, /mb-site, /mb-bet, pushes, playbooks, issue drafts, updates, and checkpoints move work forward. |
| Reflect | What sticks? | /mb-end, bet close/narrate, outcomes, retros, decisions, and checkpoint history turn lessons into future context. |
Each loop reads your folder before it speaks. Each loop writes back only when you approve.
Named workflows
Things you can ask for this week:
- Start the business day from facts. Main Branch reads status, MoneyPath, recent work, drift, connected tools, and ranked actions before advice.
- Turn research into a decision. Ask it to turn source material, transcripts, market context, and business files into research, decisions, offer updates, proof context, or stale-source cleanup.
- Create paid creative with review gates. Ask it to draft hooks, static ads, image prompts, video scripts, long-form paid creative, and launch plans, then run 6-lens P1/P2/P3 compliance review before approval.
- Create organic content in your voice. Ask for Reels, TikToks, carousels, static posts, and sales-video repurposing from your content strategy and source material.
- Plan and check a landing page. Ask for a lander, minisite, site pass, pitch script, or paid-traffic measurement check.
- Open a bet with a real exit path. Record the hypothesis, appetite, metric, target, deadline, evidence, and linked work.
- Save a long session as readable history. Close the session, review what happened, preview the checkpoint, and save only after approval.
- Draft a public GitHub issue safely. Turn confusing friction into a scrubbed issue draft you review before anything posts.
- See your business as a graph. Map how decisions, research, bets, pushes, and connected tools relate.
- Repair a folder that drifted. Ask for a repair plan before changing files.
Who it is for
Main Branch is for solo founders, small agencies, course creators, productized-service owners, indie SaaS founders, small ecom teams, and small teams that want AI help without surrendering their operating memory to another SaaS.
It is a good fit if:
- your offer, voice, research, proof, and launch context are scattered;
- you want AI help with offers, pages, ads, content, launches, and decisions;
- you want history you can inspect instead of chat output you have to trust;
- you want private business truth to stay in files you own;
- you want the system to get sharper the longer you use it.
Common objections
| Objection | Reality |
|---|---|
| "I'm not technical enough." | Install once. Then open the folder in Claude Code and run /mb-start, or open it in Codex and use the global mb-start skill. Answer plain-language questions. |
| "I'll set it up wrong." | Main Branch checks the folder, explains what is wrong, and shows the repair path. |
| "I'll lose work." | Approved checkpoints and GitHub backup give you readable history and reviewable changes. |
| "I need someone to walk me through it." | Open the folder in Claude Code and run /mb-start, or open it in Codex and use the global mb-start skill. The agent explains the next step. |
| "I won't maintain it." | Run /mb-update when asked. Repair checks tell you if anything needs fixing. |
Works with
| App | Current support |
|---|---|
| Claude Code | Open or select the business folder, run /mb-start, and use the bundled Main Branch skills. |
| Codex | Open or select the business folder and use the global Main Branch mb-* skills. |
Account writes, publishing, spend, customer contact, and account changes remain approval-gated everywhere.
Cursor, OpenClaw, Hermes, Paperclip-adjacent orchestration, Windows native, and local-only agent setups are not documented as supported until the exact path is tested.
See docs/compatibility.md for the current support list.
What Main Branch is not
| Not a chat app. | Use it inside Claude Code or Codex. Main Branch gives them durable context to read from. |
| Not a SaaS dashboard. | Your business does not live on our servers. It lives in your folder. |
| Not a connect-every-tool hub. | We pick boring, inspectable connections: GitHub, Cloudflare, Meta Ads, bookkeeping, and a few optional tool paths. Curated, not sprawl. |
| Not an ad manager or publisher. | Paid creative and site checks are supported; spend, publishing, account changes, and customer contact require explicit approval and tested support. |
| Not a model host. | mb does not run models. It gives the agent the right context so the model you already use is sharper. |
| Not magic. | The work is still real. Main Branch makes the memory and workflow durable. |
FAQ
Do I need to know how to code? No. Open the folder in Claude Code and run
/mb-start, or open it in Codex and use the global mb-start skill. Answer
questions. The beginner walkthrough shows each setup step.
Do I need to know git? No. Main Branch uses git as the hidden save/history layer and speaks in business language: checkpoints, saved history, tasks, and proposals.
Does it push to GitHub automatically? No. Checkpoints save accepted work into local git history. GitHub backup/sync is recommended, and first-run onboarding can create and push a GitHub repo when you choose that path.
What if I have multiple products under one brand? Use one folder with
core/offers/ when products share brand, team, voice, and access. Move an
offer into its own folder if it grows its own team, accounts, site, finance
boundary, or operating history.
What's a bet vs. an offer? A bet is a time-boxed hypothesis: what you will try, why, by when, and how you will know. An offer is a durable thing you sell. A winning bet can graduate into an offer through an accepted decision.
How do I update? Type /mb-update in Claude Code, or use the global
mb-update skill in Codex.
Can Claude or Codex migrate an old setup for me? Yes. Open the folder in Claude Code or Codex and follow the migration prompt in docs/migrating.md.
Can I edit the skills? You can. You usually do not need to.
What makes this different from ChatGPT or project memory? Main Branch is not only memory text. It is a structured folder, health checks, validation, graphing, repair paths, connected-tool checks, checkpoints, and agent workflows that write approved business artifacts back into files you own.
I'm stuck. Type /mb-start again.
Open source and optional community
The command-line tool, bundled skills, schema, framework, docs, and any future local dashboard are MIT-licensed and usable without joining anything. The Skool community is the live narration on top: watch us build companies with Main Branch in real time.
For contributors and power users
The agent runs mb for normal users. If you want to inspect, script, debug, or
build on it, here is the command list.
| Command | What it does |
|---|---|
mb onboard | Human setup flow: create or connect a business folder, prepare Claude/Codex setup, show next steps. |
mb init | Quiet scriptable primitive underneath mb onboard. |
mb status | Local-first daily briefing with ranked next actions, MoneyPath readiness, recent activity, GitHub tasks/proposals, updates, and drift. |
mb doctor | Check environment, repo shape, frontmatter, settings, app setup, provider state, and repair paths. |
mb connect | Register connected-account metadata/credentials, test health where supported, inspect repair-safe integration status without committing secrets. |
mb books | Plain-file bookkeeping setup checks, bookkeeping engine health, safe repair plans, bet exposure, and fake-data sample monthly reporting. |
mb site check | Local paid-traffic measurement readiness: GTM install, dataLayer events, consent posture, Google Ads metadata, approval gates. |
mb ads meta summary | Read-only Meta Ads account context through the official Meta CLI path after setup. |
mb issue draft / open | Draft a privacy-scrubbed GitHub issue locally, review it, then submit through gh. |
mb validate | Frontmatter and cross-reference checks across business repo files. |
mb graph | Build a folder graph from links, tags, connected-tool refs, and repo topology. DOT, JSON, and PNG outputs. |
mb suggest links | Suggest likely connections for a file without editing it. |
mb checkpoint | Plan or save a readable git checkpoint during long agent runs. |
mb workflow list | List workflow surfaces by support level (supported, read-only planning, shared-source, pending, unsupported). |
mb skill list / path / validate / link / repair | Inspect, validate, link, and repair bundled skills and generated app guidance. |
mb update | Update Main Branch in place. |
| Skill | What it does |
|---|---|
/mb-start | Daily entry point: figure out what you need and route there. |
/mb-status | Daily briefing facts and ranked next actions. |
/mb-setup | First-time setup with business-type routing. |
/mb-think | Research, decide, codify, keyword-gate, sharpen offers, and source cleanup. |
/mb-bet | Open, update, close, list, and narrate business bets. |
/mb-end | Close the session: summary, crystallization, checkpoint options. |
/mb-ads | Paid creative: hooks, ads, image prompts, video scripts, launch plans, compliance review. |
/mb-organic | Organic content: Reels, TikToks, carousels, static posts, and sales-video repurpose. |
/mb-site | Lander, minisite, website, Cloudflare Pages, pitch scripts, and measurement checks. |
/mb-wiki | Specialty personal atomic-notes wiki on Cloudflare Pages. |
/mb-update | Update Main Branch. |
/mb-help | Q&A, troubleshooting, and system help. |
Full list: mb --help. JSON output contract:
docs/json-output-contract.md. Connected-tool
choices: docs/dependency-choices.md.
Reading order
- AGENTS.md - shared operating contract for Codex, Claude Code, and other agents
- CLAUDE.md - Claude Code-specific guidance
- CONTRIBUTING.md - branch, commit, and validation discipline
- docs/ethos.md - product principles
- docs/operator-loops.md - Sense -> Decide -> Ship -> Reflect taxonomy
- docs/roadmap.md - release direction
- docs/compatibility.md - runtime support matrix
Community
- Skool community - watch us build with Main Branch
- GitHub Issues - bugs and feature requests
- GitHub Discussions - ideas
License
MIT (c) 2026 Noontide