Repository navigation
Forge v1.0.0
Forge v1.0.0
First public release of Forge, a reusable multi-model coding harness written in Go. Forge runs a goal-driven loop until deterministic gates and an independent reviewer pass.
Highlights
- Pure Go, standard library only
- Stage pipeline: architect, designer, implementer, tester, benchmarker, fixer, triage, security, reviewer, release
- Machine gates: install, lint, typecheck, build, tests, coverage, benchmarks, secret scan, external scanners
- Independent review and security report contracts
- Anti-tamper config fingerprinting
- Model routing with fallbacks, pricing, token accounting, and budgets
- Embedded JavaScript
cliandlog-aggregatorstarter templates - Commands:
init,run,gates,status,doctor,models,version,help - Detailed run artifacts, prompt archives, event logs, command logs, and reports
Validation
- Go tests pass across all packages
- Self-gating run passes with 76.2% statement coverage
- Parser benchmark around 390k events/sec on the development machine
- Secret scan and external scanner checks are clean
- Generated JavaScript starter workspaces pass their own gates
Install
git clone git@github.com:soub4i/forge.git
cd forge
go build -o forge ./cmd/forge
./forge versionOr install directly:
go install github.com/soub4i/forge/cmd/forge@v1.0.0Quick start
forge init my-cli --template cli --goal "Build a dependency-free line counter"
cd my-cli
forge doctor
forge gates
forge runFull documentation: README.md
Release assets
Prebuilt binaries are attached for Linux, macOS, and Windows on amd64 and arm64, plus checksums.txt.
| Platform | File |
|---|---|
| Linux amd64 | forge_linux_amd64 |
| Linux arm64 | forge_linux_arm64 |
| macOS amd64 | forge_darwin_amd64 |
| macOS arm64 | forge_darwin_arm64 |
| Windows amd64 | forge_windows_amd64.exe |
| Windows arm64 | forge_windows_arm64.exe |
License: MIT