sophon-cli

Named after the Sophon from Cixin Liu's Three-Body Problem — a sentient proton supercomputer. This is a tiny CLI that delegates its heavy lifting to distant search APIs.

A provider-agnostic Rust CLI that queries Brave Search or Exa and prints normalized text results.

Install

cargo install sophon-cli

Quick start

# Run locally from the repo
cargo run -- "rust programming"

# Choose a provider explicitly
cargo run -- "rust programming" --provider brave
cargo run -- "rust programming" --provider exa

# Show package info
cargo run -- --about

# Run all checks
just check

Configuration

Set the API key for the provider you want to use:

# Brave
echo "BRAVE_API_KEY=your_key_here" > .env

# Exa
echo "EXA_API_KEY=your_key_here" > .env

You can also export the variables directly in your shell instead of using .env.

Example usage

# Web search with Brave
sophon-cli "rust programming" --provider brave

# News search with Brave
sophon-cli "open source ai" --provider brave --search-type news --limit 3

# Exa search
sophon-cli "vector database benchmarks" --provider exa --limit 5

Supported providers

• brave for web, news, images, and video search
• exa for Exa search results mapped into the shared domain model

Docs

See the architecture docs for the typed input-to-output flow and layer boundaries.

Built with mdbook — run mdbook build to generate the HTML site.