Releases

Stay up-to-date with the latest Terraphim AI releases.

Latest Release: v1.21.9

Released: 6 July 2026

Self-Update (recommended)

If you already have a Terraphim client installed, update it with a single command — no GitHub credentials, no rate limiting:

terraphim-agent update
terraphim-grep update

The self-update backend is served from our R2 bucket (downloads.terraphim.ai) with Ed25519 signature verification. GitHub Releases is an automatic fallback if R2 is unreachable.

Quick Install

curl -fsSL https://raw.githubusercontent.com/terraphim/terraphim-ai/main/scripts/install.sh | bash

Direct Downloads

Binaries are distributed via Cloudflare R2 with zero-egress CDN. Browse the manifests:

Download the latest archive for your platform directly:

curl -fsSLO "https://downloads.terraphim.ai/terraphim-agent/terraphim-agent-1.21.9-x86_64-unknown-linux-gnu.tar.gz"
tar -xzf terraphim-agent-1.21.9-*.tar.gz
sudo mv terraphim-agent /usr/local/bin/

Available Binaries

v1.21.9 ships across three client tools:

terraphim-agent — full CLI + REPL + TUI
terraphim-grep — intelligent hybrid search with RLM fallback
terraphim-cli — lightweight command-line toolkit

Platforms:

Platform	Agent	Grep	CLI
Linux x86_64 (GNU)	✓	✓	✓
Linux x86_64 (MUSL)	✓	✓	✓
Linux ARM64 (MUSL)	✓	✓	✓
macOS Apple Silicon	✓	✓	✓
macOS Intel	✓	✓	✓
macOS Universal	✓	✓	—
Windows x64	✓	✓	✓

All Linux and macOS archives are Ed25519-signed and verified on install by the self-updater. macOS universal binaries are additionally notarised by Apple.

What's New

R2 binary distribution — no rate limits, no GitHub token

Client binaries served from Cloudflare R2 via downloads.terraphim.ai (free global CDN egress)
JSON manifest backend — version discovery is a single HTTP GET (sub-second, edge-cached)
terraphim-agent update and terraphim-grep update work out of the box with no credentials
GitHub Releases retained as an automatic fallback

Archive signing (Ed25519 / zipsign)

Every .tar.gz archive is now signed and verified on install
Multi-key verifier supports key rotation (2026-07 clients key + 2025-01 legacy key)
Unsigned archives are rejected — MissingSignature is a hard failure, not a warning

Self-update robustness

Install-path fix: updates now install to the running binary's location (no more ~/.cargo/bin shadowing /usr/local/bin)
Atomic-rename install: can replace the currently-running binary without ETXTBSY
Backend selector: TERRAPHIM_UPDATE_BACKEND=r2|github env override

Installation

# Already have terraphim-agent?  Update in-place.
terraphim-agent update
terraphim-grep update

curl -fsSL https://raw.githubusercontent.com/terraphim/terraphim-ai/main/scripts/install.sh | bash

cargo install terraphim_agent --features repl-full

brew tap terraphim/terraphim && brew install terraphim-agent

Installation Guide

All Releases

View complete release history on GitHub Releases (terraphim-clients).

Release Channels

Stable

Stable releases are recommended for production use. They are thoroughly tested and signed. The self-updater fetches signed archives from downloads.terraphim.ai by default.

Latest Stable: v1.21.9

Development

Development releases contain the latest features and improvements. Use these for testing.

Check the main branch for development builds.

Upgrade Guide

From Any Version to Latest

# Self-update (recommended, no GitHub token needed)
terraphim-agent update

# Or via the universal installer
curl -fsSL https://raw.githubusercontent.com/terraphim/terraphim-ai/main/scripts/install.sh | bash

Configuration Compatibility

Terraphim maintains backward compatibility for configuration files across minor versions. Major version bumps may require configuration updates.

Verify Your Installation

terraphim-agent --version
terraphim-agent check-update

Security & Integrity

Every archive is Ed25519-signed with zipsign. The self-updater verifies the signature before installing; tampered or unsigned archives are rejected.
Archives are served over TLS 1.2+ from Cloudflare's CDN.
Public keys are embedded in the binary at compile time; no runtime key-download trust-on-first-use.
See ADR-001 for the key rotation design.

Beta Testing

Want to test new features before they're released?

Join our Discord server and look for #beta-testing channel. Beta testers get early access to new features and help shape the product.

Need Help?

If you encounter issues with a release:

Previous Release: v1.20.5

Released: 14 June 2026

The final release distributed exclusively through GitHub Releases before the R2 migration. v1.20.5 binaries remain available on GitHub and will continue to be served as the GitHub fallback. From v1.21.9 onward, all releases are published to both GitHub and R2.