Private Beta

Get Predictable Code

Download the CLI and follow the installation guide below to get started. If you don't have an access token, contact us at hello@predictablemachines.com.

Download Predictable Code

Enter your access token to get started

Installation Guide

Get Predictable Code running on your machine

Supported platforms

Platform	Identifier
macOS Apple Silicon (M1/M2/M3)	darwin-arm64
macOS Intel	darwin-x64
Linux x86_64	linux-x64
Windows x64	win-x64

Linux ARM64 is not yet supported.

Option 1 — One-line installer

Downloads the latest release, verifies its SHA256 checksum, installs the binary to your PATH, and also installs the bundled opencode binary.

curl -fsSL https://code.predictablemachines.com/install.sh | bash

Install a specific version:

curl -fsSL https://code.predictablemachines.com/install.sh | bash -s -- --version 0.2.0

Skip automatic PATH modification:

curl -fsSL https://code.predictablemachines.com/install.sh | bash -s -- --no-modify-path

What the installer does

Downloads predictable and opencode binaries for your platform from GitHub Releases
Verifies SHA256 checksums against manifest.json
Installs to ~/.local/bin/ (macOS/Linux) or %LOCALAPPDATA%\predictable\bin\ (Windows)
Adds the install directory to your PATH in ~/.zshrc, ~/.bashrc, or ~/.profile

Option 2 — Manual installation

If you downloaded the binary directly using the form above:

Make the binary executable (adjust filename for your platform):

chmod +x predictable-darwin-arm64

Move it to a directory on your PATH:

mv predictable-darwin-arm64 ~/.local/bin/predictable

If ~/.local/bin is not on your PATH, add this to your shell profile:

export PATH="$HOME/.local/bin:$PATH"

Then reload your shell:

source ~/.zshrc   # or source ~/.bashrc

Verify the installation

predictable --help

predictable --version

First run

Most commands require an Anthropic API key. Set it in your environment before running agent commands:

export ANTHROPIC_API_KEY="sk-ant-..."

Add that line to your shell profile to make it permanent.

Ask a single question:

predictable ask 'What is Lean 4?'

List specs in a project:

predictable specs list --path /path/to/your/project

Updating

Re-run the installer to update to the latest version. It overwrites the existing binary in place:

curl -fsSL https://code.predictablemachines.com/install.sh | bash