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:
Latest release

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.5.1.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.5.1-py3-none-any.whl (1.4 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mainbranch-0.5.1.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.5.1.tar.gz
Algorithm Hash digest
SHA256 b6e7f32000b007d99f16b39224a86bad8a3de5f76619d4ecbab7c538072485c3
MD5 5986990bc3b24233c7ee36a19a626e05
BLAKE2b-256 1566794239f6f75051b8871790423ec12f74527787274d6cfd8e9205fe7ee833

See more details on using hashes here.

Provenance

The following attestation bundles were made for mainbranch-0.5.1.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.5.1-py3-none-any.whl.

File metadata

  • Download URL: mainbranch-0.5.1-py3-none-any.whl
  • Upload date:
  • Size: 1.4 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.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 295c0b6b330019bdd672abc8bddd8d848be9702604f9a5f8f25f4607ebf581b9
MD5 fd0dca1fb7c14dd82404600f5616ca96
BLAKE2b-256 749d3fc7a478ea9fdeaf7722bbb78fa335df4820660d67bd36467ed8b24078c2

See more details on using hashes here.

Provenance

The following attestation bundles were made for mainbranch-0.5.1-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