Sombra is an open-source command-line tool that helps you automate project scaffolding by turning production-ready repositories into reusable, version-controlled templates.
Built for developers, consultants, and teams who want to:
- ⚡ Quickly start new projects with consistent setup
- 🧱 Reuse real, tested code without changing it
- 🔄 Keep projects up to date with shared boilerplate
- ✅ Use any Git repository as a template source
- ⚙️ Define flexible rules using Go templates + YAML
- ♻️ Reuse code without modifying production files
- 🔍 Match and transform paths, filenames, and content
- 🏷 Semantic versioning with Git tags
go install github.com/sombrahq/sombra-cli@latest
Download from GitHub Releases
git clone https://github.com/sombrahq/sombra-cli.git
cd sombra-cli
make build WHAT=sombra
See Installation Guide for more details.
Convert a production repo into a template:
sombra template init ./my-app
This creates .sombra/default.yaml.
In a new repo, create a sombra.yaml:
branch: main
templates:
- name: https://github.com/your-org/your-template
vars:
project: New API
Then run:
sombra local update --tag v1.0.0 --method copy
Full docs available at 👉 https://sombrahq.github.io/sombra-cli/
Key topics:
Issues and PRs welcome! Start with the Contact page or open an Issue.
MIT licensed. Made with ❤️ by @yunier
.png)


