v1.16.8

Release Assets

macOS Universal Binaries (Intel + Apple Silicon)

Signed and Notarized - No Gatekeeper warnings

• terraphim_server-universal-apple-darwin: Server binary for all Macs
• terraphim-agent-universal-apple-darwin: TUI binary for all Macs

Server Binaries

• terraphim_server-*: Server binaries for various platforms

TUI Binaries

• terraphim-agent-*: Terminal UI binaries for various platforms

Desktop Applications

Desktop applications are now built and released separately in the terraphim-ai-desktop repository.

• *.dmg: macOS desktop installer
• *.AppImage: Linux portable desktop app
• *.msi, *.exe: Windows desktop installers

Debian Packages

• *.deb: Debian/Ubuntu packages for easy installation

Docker Images

• ghcr.io/terraphim/terraphim-server:latest: Multi-arch server image

Installation

# Install via Homebrew (macOS/Linux)
brew tap terraphim/terraphim
brew install terraphim-server
brew install terraphim-agent

# Install Debian package (Ubuntu/Debian)
sudo dpkg -i terraphim-server_*.deb

# Run with Docker
docker run ghcr.io/terraphim/terraphim-server:latest

See checksums.txt for file integrity verification.

v1.16.7

Release Assets

macOS Universal Binaries (Intel + Apple Silicon)

Signed and Notarized - No Gatekeeper warnings

• terraphim_server-universal-apple-darwin: Server binary for all Macs
• terraphim-agent-universal-apple-darwin: TUI binary for all Macs

Server Binaries

• terraphim_server-*: Server binaries for various platforms

TUI Binaries

• terraphim-agent-*: Terminal UI binaries for various platforms

Desktop Applications

Desktop applications are now built and released separately in the terraphim-ai-desktop repository.

• *.dmg: macOS desktop installer
• *.AppImage: Linux portable desktop app
• *.msi, *.exe: Windows desktop installers

Debian Packages

• *.deb: Debian/Ubuntu packages for easy installation

Docker Images

• ghcr.io/terraphim/terraphim-server:latest: Multi-arch server image

Installation

# Install via Homebrew (macOS/Linux)
brew tap terraphim/terraphim
brew install terraphim-server
brew install terraphim-agent

# Install Debian package (Ubuntu/Debian)
sudo dpkg -i terraphim-server_*.deb

# Run with Docker
docker run ghcr.io/terraphim/terraphim-server:latest

See checksums.txt for file integrity verification.

v1.16.6

Release Assets

macOS Universal Binaries (Intel + Apple Silicon)

Signed and Notarized - No Gatekeeper warnings

• terraphim_server-universal-apple-darwin: Server binary for all Macs
• terraphim-agent-universal-apple-darwin: TUI binary for all Macs

Server Binaries

• terraphim_server-*: Server binaries for various platforms

TUI Binaries

• terraphim-agent-*: Terminal UI binaries for various platforms

Desktop Applications

Desktop applications are now built and released separately in the terraphim-ai-desktop repository.

• *.dmg: macOS desktop installer
• *.AppImage: Linux portable desktop app
• *.msi, *.exe: Windows desktop installers

Debian Packages

• *.deb: Debian/Ubuntu packages for easy installation

Docker Images

• ghcr.io/terraphim/terraphim-server:latest: Multi-arch server image

Installation

# Install via Homebrew (macOS/Linux)
brew tap terraphim/terraphim
brew install terraphim-server
brew install terraphim-agent

# Install Debian package (Ubuntu/Debian)
sudo dpkg -i terraphim-server_*.deb

# Run with Docker
docker run ghcr.io/terraphim/terraphim-server:latest

See checksums.txt for file integrity verification.

v1.17.0: KG-boosted file search

What's New

KG-Boosted File Search

• terraphim_file_search crate: New crate providing KgPathScorer that uses Aho-Corasick automata from the knowledge graph to boost file search results matching domain terms
• MCP integration: find_files and grep_files tools in the MCP server now support KG-boosted scoring
• Directory watcher: KgWatcher monitors thesaurus directories and hot-reloads the scorer when files change
• Benchmarks: Criterion benchmarks for KG scoring performance

Usage Tracking

• terraphim_usage and terraphim_ccusage crates for token tracking
• CLI commands for querying token usage statistics

Agent Orchestration

• MentionDetector for @agent: mention dispatch
• OutputPoster and drain-before-drop in poll_agent_exits
• Wall-clock timeout with fallback respawn

Improvements

• ID types reverted from String/UUID to u64 integer for consistency
• Custom SQLite store replaced with terraphim_persistence
• zlob feature flag enabled in CI for faster glob matching (Zig 0.15.2)

Full Changelog: v1.16.0...v1.17.0

v1.15.0

Release v1.15.0

Added

• New nightwatch active hours window for drift evaluation
• Dual-panel evaluation for drift detection
• Terraphim Symphony orchestrator improvements with spawn_with_fallback
• QualityScore metadata (K/L/S) to IndexedDocument
• Terraphim-agent learn auto-extract subcommand for session transcripts
• Layered search output for token efficiency
• ReasoningCertificate type for audit events
• Rolegraph trigger-based contextual KG retrieval

Fixed

• Release builds now exclude firecracker crates with private dependencies
• Various improvements and fixes

Assets

• Linux: x86_64 (GNU/MUSL), ARM64 (MUSL), ARMv7 (MUSL)
• macOS: Universal signed & notarized binaries
• Debian packages for amd64

v1.14.0

Release Assets

macOS Universal Binaries (Intel + Apple Silicon)

Signed and Notarized - No Gatekeeper warnings

• terraphim_server-universal-apple-darwin: Server binary for all Macs
• terraphim-agent-universal-apple-darwin: TUI binary for all Macs

Server Binaries

• terraphim_server-*: Server binaries for various platforms

TUI Binaries

• terraphim-agent-*: Terminal UI binaries for various platforms

Desktop Applications

Desktop applications are now built and released separately in the terraphim-ai-desktop repository.

• *.dmg: macOS desktop installer
• *.AppImage: Linux portable desktop app
• *.msi, *.exe: Windows desktop installers

Debian Packages

• *.deb: Debian/Ubuntu packages for easy installation

Docker Images

• ghcr.io/terraphim/terraphim-server:latest: Multi-arch server image

Installation

# Install via Homebrew (macOS/Linux)
brew tap terraphim/terraphim
brew install terraphim-server
brew install terraphim-agent

# Install Debian package (Ubuntu/Debian)
sudo dpkg -i terraphim-server_*.deb

# Run with Docker
docker run ghcr.io/terraphim/terraphim-server:latest

See checksums.txt for file integrity verification.

v1.11.0

Release Assets

macOS Universal Binaries (Intel + Apple Silicon)

Signed and Notarized - No Gatekeeper warnings

• terraphim_server-universal-apple-darwin: Server binary for all Macs
• terraphim-agent-universal-apple-darwin: TUI binary for all Macs

Server Binaries

• terraphim_server-*: Server binaries for various platforms

TUI Binaries

• terraphim-agent-*: Terminal UI binaries for various platforms

Desktop Applications

• *.dmg: macOS desktop installer
• *.AppImage: Linux portable desktop app
• *.msi, *.exe: Windows desktop installers

Debian Packages

• *.deb: Debian/Ubuntu packages for easy installation

Docker Images

• ghcr.io/terraphim/terraphim-server:latest: Multi-arch server image

Installation

# Install via Homebrew (macOS/Linux)
brew tap terraphim/terraphim
brew install terraphim-server
brew install terraphim-agent

# Install Debian package (Ubuntu/Debian)
sudo dpkg -i terraphim-server_*.deb

# Run with Docker
docker run ghcr.io/terraphim/terraphim-server:latest

See checksums.txt for file integrity verification.

v1.10.1 - Dependency Updates

• Bump uuid from 1.19.0 to 1.21.0
• Bump regex from 1.12.2 to 1.12.3
• Bump futures-util from 0.3.31 to 0.3.32
• Bump clap from 4.5.53 to 4.5.60
• Bump napi from 2.16.17 to 3.8.3
• Bump toml from 0.8.23 to 0.9.12
• Add session persistence for CLI usage
• Add sessions command to terraphim-agent CLI
• Fix search with robot output mode and TerraphimGraph lexical fallback
• Fix learn/check-update/update commands no longer require TuiService
• Fix CI scope publish script version sed to package section only

v1.10.0

Release Assets

macOS Universal Binaries (Intel + Apple Silicon)

Signed and Notarized - No Gatekeeper warnings

• terraphim_server-universal-apple-darwin: Server binary for all Macs
• terraphim-agent-universal-apple-darwin: TUI binary for all Macs

Server Binaries

• terraphim_server-*: Server binaries for various platforms

TUI Binaries

• terraphim-agent-*: Terminal UI binaries for various platforms

Desktop Applications

• *.dmg: macOS desktop installer
• *.AppImage: Linux portable desktop app
• *.msi, *.exe: Windows desktop installers

Debian Packages

• *.deb: Debian/Ubuntu packages for easy installation

Docker Images

• ghcr.io/terraphim/terraphim-server:latest: Multi-arch server image

Installation

# Install via Homebrew (macOS/Linux)
brew tap terraphim/terraphim
brew install terraphim-server
brew install terraphim-agent

# Install Debian package (Ubuntu/Debian)
sudo dpkg -i terraphim-server_*.deb

# Run with Docker
docker run ghcr.io/terraphim/terraphim-server:latest

See checksums.txt for file integrity verification.

Dynamic Ontology v1.9

Dynamic Ontology v1.9

Schema-first knowledge graph construction with coverage governance signals.

New Features

• GroundingMetadata - Canonical URIs for normalized entities
• CoverageSignal - Quality governance signals
• SchemaSignal - Entity extraction with confidence scores
• HgncNormalizer - Gene normalization (EGFR, TP53, KRAS, etc.)

Feature Gates

Feature	Description
ontology	Core generic types (default)
medical	Medical entity types
hgnc	HGNC gene normalization

No Vector Embeddings Required

Uses existing Aho-Corasick automata + fuzzy matching. Fast, deterministic, explainable.

Published to crates.io

terraphim_types = "1.6.0"

Install with:

cargo add terraphim_types

Documentation

See docs/src/dynamic-ontology.md

Test It

cargo run --example kg_normalization -p terraphim_types
cargo run --example ontology_usage -p terraphim_types --features hgnc

Source Code

The multi-agent workflow code is in the repository. Clone and build:

git clone https://github.com/terraphim/terraphim-ai.git
cd terraphim-ai
cargo build -p terraphim_multi_agent