mainbranch (mb)

Engine umbrella for Main Branch — scaffolds, validates, and graphs business-as-files repos.

This package is the Python entry point. Workflows, playbooks, educational content, and consumer-repo templates ship as bundled package data. Today, the day-to-day "do work" surfaces are Claude Code skills and global Codex mb-* skills grounded in the same deterministic mb facts. The mb CLI stays runtime-agnostic by design so future adapters can operate against the same business-as-files repo.

The source tree keeps the engine payload in one place: repo-root .claude/. During sdist/wheel builds, setup.py copies that tree into mb/_engine/.claude/ inside the build artifact so installed wheels can resolve skills, playbooks, reference materials, lenses, and educational prompts without a source checkout.

Install

pipx install mainbranch

That puts mb on your PATH. Verify:

mb --version

Subcommands

Command What it does
mb onboard Human setup flow. Creates or connects a business repo, explains the local files/git/GitHub model, wires Claude Code and Codex guidance, verifies discovery, and prints the next start step. Supports --yes and --json for smoke tests.
mb init Scaffold a new business repo (business folders, CLAUDE.md, AGENTS.md, CODEOWNERS, git init) and wire bundled runtime guidance. One question only: business name.
mb doctor Diagnostic. Checks Claude Code, gh auth, network, librsvg, runtime wiring, and package freshness. Warns on cloud-backed finance paths and offers educational triage.
mb status Daily briefing. Summarizes repo shape, install/runtime readiness, recent brain files, recent git activity, and GitHub tasks/proposals when gh is authenticated. Supports --json.
mb start Runtime handoff. Verifies the current business repo, git, Claude Code, Codex guidance, and start-skill wiring, then prints the exact next step. Supports --json.
mb validate Frontmatter shape check across current business repo folders, with compatibility reads for old migrated surfaces where needed. Exit 1 on any fail.
mb graph Walk linked_research / linked_decisions / supersedes; emit Graphviz DOT to stdout. --open shells to dot + open.
mb similar-bets Find similar past bets and offer outcomes from repo truth.
mb checkpoint Plan or save a business-readable git checkpoint.
mb update Refresh the Main Branch engine according to install mode (pipx upgrade or clone git pull) and repair skill links. --check dry-runs; --json emits an envelope.
mb pulse install Install an operator-owned daily pulse wrapper.
mb leads grade Grade lead batches and calculate eligible-lead CPL beside raw CPL.
mb ledger init Create the what's-working creative ledger structure.
mb automation init Create an inspectable steered-loop automation contract.
mb production plan Inspect launch/production readiness without mutating providers or repos.
mb migrate Inspect and apply numbered repo schema migrations. status, --check, and --apply support --json; --check prints privacy-safe summaries by default, with full diffs behind --diff.
mb connect Connect provider credentials without committing secrets, test provider health, inspect hygiene/identity, and report repair-safe integration status.
mb site Inspect site readiness for launch-adjacent workflows.
mb issue Draft and open privacy-safe GitHub issues from local friction.
mb think <topic> Print the /mb-think workflow invocation hint for the currently supported runtime.
mb resolve <key> Resolve a reference key from the curated library, local core files, or bundled stubs.
mb skill path <name> Print the on-disk path to a bundled skill.
mb skill validate <name> Validate bundled skill frontmatter, local references, and line-count gates.
mb skill link --repo <path> Wire or repair Claude Code skill discovery for a business repo. Future runtime adapters should get equivalent wiring commands.
mb skill repair --repo <path> Detect personal Claude Code skills that shadow Main Branch and safely back up stale Main Branch symlinks with --apply.
mb educational <topic> Print an educational triage file. Powers mb doctor's "tell me more" prompts.

Users on early 0.1.x installs must bootstrap once with pipx upgrade mainbranch before mb update exists locally. Existing business repos should run mb skill link --repo ., then mb skill repair --repo . after upgrading.

If you installed Main Branch as a Claude Code plugin, package updates do not change the plugin that Claude Code has already loaded. After updating, re-add the Main Branch plugin (claude plugin marketplace add noontide-co/mainbranch) and restart Claude Code.

Status

Main Branch is Claude Code first with supported Codex CLI guidance through generated AGENTS.md and global mb-* skills. mb onboard, mb status, mb start, and mb update are public package surfaces. Cursor, OpenClaw, Hermes, and local runtimes remain roadmap work. The schema is v1 and will evolve. The runtime boundary decision lives at decisions/2026-05-01-mb-cli-vs-agent-workflows-boundary.md; the engine master decision lives at decisions/2026-04-29-mb-vip-v0-1-0-master.md.

License

MIT.

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.5.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for dmthepm from gravatar.com dmthepm

Credits

Author: Devon Meadows

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Provides Extra

ogrender dev

Tags

cli business-as-files claude-code skills scaffolding

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mainbranch-0.4.2.tar.gz (1.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mainbranch-0.4.2-py3-none-any.whl (1.3 MB view details)

Uploaded Python 3

File details

Details for the file mainbranch-0.4.2.tar.gz.

File metadata

  • Download URL: mainbranch-0.4.2.tar.gz
  • Upload date:
  • Size: 1.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for mainbranch-0.4.2.tar.gz
Algorithm Hash digest
SHA256 f4d1768818db57925c459b2909af0e247174fe37311dc0d1bacaa9a4951717fa
MD5 bffe293c9d4b0f48455a50ebe9df2b27
BLAKE2b-256 15619ba9dbb08969f907a79accc7573cb4ed31fd678dbfc02687bbf4a3a67968

See more details on using hashes here.

Provenance

The following attestation bundles were made for mainbranch-0.4.2.tar.gz:

Publisher: publish-pypi.yml on noontide-co/mainbranch

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mainbranch-0.4.2-py3-none-any.whl.

File metadata

  • Download URL: mainbranch-0.4.2-py3-none-any.whl
  • Upload date:
  • Size: 1.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for mainbranch-0.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 beab84193b3fbd82abf5bce3e54d5706b6193b14867f6304e2dce7f26813c228
MD5 89e4b5fad7ca447348b09f27848d81bd
BLAKE2b-256 c64eb106a9f1ebb616331512d1afcb7bd0aea2f5e0c3e18496f1b59debb5ff76

See more details on using hashes here.

Provenance

The following attestation bundles were made for mainbranch-0.4.2-py3-none-any.whl:

Publisher: publish-pypi.yml on noontide-co/mainbranch

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page