Download LaForge
LaForge 0.1.0 is a single binary, la. The installer is the quickest way to get it; everything it does, you can also do by hand.
Install#
macOS and Linux, Apple Silicon and Intel, arm64 and x86-64:
curl -fsSL https://getlaforge.com/install | sh
That fetches the installer attached to the latest release on GitHub and runs it. To go to GitHub directly instead:
curl -fsSL https://github.com/RunOutcome/laforge/releases/latest/download/install.sh | sh
Then, from the folder you want to work in:
la up
la up starts the forge on 127.0.0.1:4646 (or the next free port), prints a link and opens it. la status shows the forge and its panes, la open gives a fresh link, la down stops it.
What the installer checks#
Before anything lands on your machine, install.sh:
- downloads
checksums.txt, its signaturechecksums.txt.sig, and the archive for your OS and CPU into a private temporary folder; - verifies the signature on
checksums.txtwith the LaForge release public key, which is embedded in the installer and never fetched (withopenssl, orcosignifopensslis missing); - verifies the archive's SHA-256 against
checksums.txt; - only then installs
laas~/.local/bin/la-v0.1.0, with~/.local/bin/lapointing at it.
Any failed check stops it with nothing installed. It needs no root, starts nothing, and refuses to replace an la it did not install unless you pass --force. Other options: --version vX.Y.Z for a specific release, --prefix DIR for another folder. To read it first:
curl -fsSLO https://github.com/RunOutcome/laforge/releases/latest/download/install.sh
less install.sh
sh install.sh
To uninstall, remove ~/.local/bin/la and ~/.local/bin/la-v*; the forge keeps its layout and settings in ~/.laforge/forge.
Verify by hand#
Every release carries checksums.txt (SHA-256 of every asset), its signature checksums.txt.sig, and the public key cosign.pub. Download those and your archive from the release page, then:
openssl base64 -d -A -in checksums.txt.sig -out checksums.txt.sig.der
openssl dgst -sha256 -verify cosign.pub -signature checksums.txt.sig.der checksums.txt
sha256sum -c --ignore-missing checksums.txt
The second line prints Verified OK when the signature matches; the third checks each archive you downloaded. On a Mac without sha256sum, use shasum -a 256 -c --ignore-missing checksums.txt. Check cosign.pub against the copy in the repository rather than trusting the one next to the archive.
Archives#
Each archive holds la, the licence, README, changelog and third-party notices, with an SPDX SBOM (.sbom.json) beside it.
| Platform | Archive |
|---|---|
| macOS, Apple Silicon | laforge_0.1.0_darwin_arm64.tar.gz |
| macOS, Intel | laforge_0.1.0_darwin_amd64.tar.gz |
| Linux, x86-64 | laforge_0.1.0_linux_amd64.tar.gz |
| Linux, arm64 | laforge_0.1.0_linux_arm64.tar.gz |
| Windows, x86-64 (experimental) | laforge_0.1.0_windows_amd64.zip |
| Windows, arm64 (experimental) | laforge_0.1.0_windows_arm64.zip |
Plus checksums.txt, checksums.txt.sig, cosign.pub and install.sh. Every release, with its notes: github.com/RunOutcome/laforge/releases.
In a container#
With Docker or Podman (rootless works), and la installed:
la up --container
That runs ghcr.io/runoutcome/laforge:0.1.0 with the current folder at /workspace, and opens the link. The image carries the forge, a shell toolbox (zsh, git, ripgrep, fd, jq, Python, make) and Codex, Qwen Code and opencode. Claude Code, Copilot and Antigravity have proprietary licences, so the image never carries them: on first start the container installs them into its home volume as your own install. Logins, history and settings live in the laforge-home volume and survive restarts and new images. la down --container stops it.
The port is published on 127.0.0.1 only, and the forge still needs its token. To pull the image yourself:
docker pull ghcr.io/runoutcome/laforge:0.1.0
Windows (experimental)#
Unzip la.exe from the Windows archive onto your PATH and run la up; panes run PowerShell. The Windows build compiles and passes the unit tests but has had little hands-on use, and agent panes do not yet drop to a shell when the agent exits. Reports are welcome on GitHub.
Build from source#
Go 1.26 or newer:
git clone https://github.com/RunOutcome/laforge
cd laforge
make build # bin/la
make install # ~/.local/bin/la
LaForge is Apache-2.0. Copyright 2026 COR Holdings, LLC.