Open-source developer tools for teams that work across multiple Git repositories.
Base Foundry makes local development more explicit and repeatable. Base coordinates repository setup, readiness, trusted execution, onboarding, and handoff, while companion libraries provide reusable foundations for Python CLIs and reliable Bash automation.
Read Why Base for the short explanation, or inspect Base Demo to see the workflow in a small working project. When the problem fits, start with Base.
| If you want to... | Start with |
|---|---|
| Coordinate setup, readiness, trust, and handoff across repositories | Base — the local operating contract for GitHub-centered workspaces |
| See Base applied to a working project | Base Demo — the compact reference project and interactive walkthrough |
| Build a production Python CLI with Click or Typer | base-cli — reusable lifecycle, configuration, logging, cleanup, and machine-readable contracts |
Learn base-cli from a working consumer |
base-cli-demo — an offline reference application |
| Keep operational scripts in reliable Bash | base-bash-libs — sourceable libraries for execution, logging, files, Git, strings, and cleanup |
Learn base-bash-libs from a working consumer |
base-bash-libs-demo — an offline support-bundle collector |
Base (workspace operating contract)
├── base-cli Python CLI foundation
├── base-bash-libs Bash automation foundation
└── reference consumers base-demo, base-cli-demo, base-bash-libs-demo
Base coordinates repository-owned setup, verification, trust, and handoff without turning independent projects into a monorepo. The companion libraries stay reusable outside Base, and the demo repositories show those boundaries in working applications.
Across the ecosystem, we favor explicit contracts over hidden workstation state, inspection before mutation, composable tools with narrow ownership, and pull requests backed by reproducible evidence.
- Homebrew Base packages Base and its reusable Bash libraries.
- Base Platform Tools houses optional platform and operations utilities.
- Base Workspace contains an example workspace manifest.
- Banyan Labs is the hands-on platform engineering and SRE lab.
- Browse all Base Foundry repositories.
- Follow roadmaps and active work in the public GitHub Projects.
- Ask questions or share ideas in Discussions.
- Report an issue or propose a change in the repository that owns the relevant behavior.
Each repository documents its own setup, support, contribution, release, and license contracts. Start with that repository's README before making changes.