Skip to content

Latest commit

 

History

41 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

Homebrew Tap for Terraphim AI

This is the official Homebrew tap for Terraphim tools.

Installation

# Add the tap
brew tap terraphim/terraphim

# Install tools
brew install terraphim-server   # HTTP API server
brew install terraphim-agent    # Agent memory, learning, and session commands
brew install terraphim-grep     # Local code and documentation search

Available Formulas

Formula Description
terraphim-server Privacy-first AI assistant HTTP server with semantic search
terraphim-agent Agent memory, learning, session, and knowledge graph workflows
terraphim-grep Local text and knowledge-graph-assisted search

Usage

Terraphim Server

# Start the server
terraphim_server

# Run as a background service
brew services start terraphim-server

# Check status
brew services info terraphim-server

The server will be available at http://localhost:8000.

Terraphim Agent

# Inspect the installed command surface
terraphim-agent --help
terraphim-agent learn --help
terraphim-agent memory --help

# Search local code and documentation
terraphim-grep --help

Configuration

Configuration files are installed to:

  • Server: $(brew --prefix)/etc/terraphim/

Updating

brew update
brew upgrade terraphim-server terraphim-agent terraphim-grep

Troubleshooting

Build fails with OpenSSL errors

Ensure OpenSSL is properly linked:

brew reinstall openssl@3
export PKG_CONFIG_PATH="$(brew --prefix openssl@3)/lib/pkgconfig"
brew reinstall terraphim-server

Verify downloaded binaries

The macOS terraphim-agent and terraphim-grep binaries are signed with the Terraphim Developer ID. Homebrew also verifies the SHA-256 checksum before installation. Check the installed signatures with:

codesign --verify --verbose=2 "$(which terraphim-agent)"
codesign --verify --verbose=2 "$(which terraphim-grep)"

The v1.21.14 signatures chain through Apple's Developer ID G1 intermediate. If an otherwise checksum-matching binary reports an invalid signature, install the official Developer ID G1 intermediate from the Apple PKI page and retry. Do not bypass Gatekeeper. The release workflow also verifies every macOS binary on a fresh GitHub-hosted macOS runner before publication.

Links

License

Apache-2.0

About

Homebrew tap for Terraphim AI tools

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages