Repository navigation
Releases
Forge v1.2.0
Forge no longer ships JavaScript starter projects. forge init is now control-files-only: it adds Forge's config, goal, schema, AGENTS.md, and .gitignore to an existing project or an empty directory, in any language.
Breaking changes
--template cliand--template log-aggregatorare removed.--template noneis still accepted and is now the default.- A new workspace requires
--goal, because there is no template goal to fall back on.forge init . --forcewithout--goalpreserves the existing goal. forge initno longer scaffolds application code or reports copied template files.
Why
The starter templates were the last language-specific part of Forge. The harness is language- and project-agnostic: it detects the project's native commands and leaves project structure and tooling choices to you.
Use your own tooling to create the project, then let Forge add the control files and run its gates.
Install
go install github.com/soub4i/forge/cmd/forge@v1.2.0Or download the binary for your platform below and verify it with checksums.txt.
Forge v1.1.0
Forge is now language- and project-agnostic. Give it a goal in a Go, Rust, Python, Java, .NET, Ruby, PHP, C/C++, Swift, Dart/Flutter, Elixir, Scala, Haskell, Zig, Deno, Lua, R, Julia, Node.js, or task-runner-driven project, and it detects the native commands instead of assuming package.json.
Highlights
- Broad ecosystem detection — Node.js (npm, pnpm, Yarn, Bun), Deno, Go, Rust, Python (pip, uv, Poetry, Pipenv, tox), Java/Kotlin (Maven, Gradle), .NET, Ruby, PHP, C/C++ (CMake, Meson, Autotools, vcpkg), Swift, Dart/Flutter, Elixir, Scala, Haskell (Cabal, Stack), Zig, Lua, R, and Julia.
- Task runners and scripts —
Makefile,justfile,Taskfile.yml, Bazel, Nix, and executabletest.sh/build.sh/coverage.shfallbacks, including Windows wrappers. - Multi-ecosystem projects — Forge chooses the primary ecosystem from source-file counts and fills missing gates from other ecosystems, task runners, and scripts. Explicit
commandsin config remain authoritative. - Source-only projects get a language profile without invented commands.
- Coverage — Cobertura XML, JaCoCo XML, LCOV, Go coverage profiles, and additional text summaries from PHPUnit, SimpleCov, Elixir, tarpaulin, and others.
- Security scanners — auto-detected pnpm, Yarn, Composer, Bundler, .NET, and OSV scanners with parsers. An explicit scanner replaces an auto-detected scanner with the same name.
- Generic context and prompts — manifests, languages, package manager, task runners, and detected commands replace Node/Go/Rust/Python-specific fields. Prompts, write scopes,
forge init,forge doctor, and generatedAGENTS.mdare ecosystem-neutral. - Release tagging reads the project version from common manifests across ecosystems, not only
package.json.
Compatibility
- Existing v1.0.0 configs keep working. Config commands still win; detection only fills gaps.
- The embedded
cliandlog-aggregatorstarter templates remain JavaScript by design.
Install
go install github.com/soub4i/forge/cmd/forge@v1.1.0Or download the binary for your platform below and verify it with checksums.txt.
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