CLI
WhisperGraph from your terminal: run Cypher, run any catalog recipe by name, serve the graph to an MCP client, or walk it node by node.
In this chapter
- QueryRun one read-only Cypher statement from the terminal, bind parameters with --param, and read the same JSON envelope the HTTP API returns.
- Recipes from the terminalRun any recipe in the catalog by name. Direct recipes answer with one table; flow recipes stream their steps as NDJSON you can pipe to jq.
- Local MCP serverServe WhisperGraph to any stdio MCP client from the binary on your machine, with the hosted connector's tools plus one per recipe.
On this page (4)
CLI Documentation
whisper is one signed binary that talks to WhisperGraph from your terminal. Same graph as the HTTP API, same read-only Cypher, same recipes these docs describe. No HTTP client to write and no JSON to hand-assemble.
The same binary also gives an agent, a server or a laptop its own routable IPv6 address and carries its traffic from it. That half of the tool is documented under Agent Identity and Network & DNS; this chapter covers the graph commands.
Install
One line fetches the signed binary, checks its SHA-256, and puts it on your PATH:
curl -fsSL https://get.whisper.online | sh
Homebrew works too:
brew install whisper-sec/tap/whisper
Windows (PowerShell), Scoop, signed apt, dnf and apk repositories, go install and mise are all in the README. Every build is static, and every release is signed with the AS219419 key, so gpg --verify works on any binary you download by hand.
Check it landed:
whisper version
Sign in
The graph commands use your API key. Sign in once and every later command finds it:
whisper login
Press Enter to approve the login in your browser, or paste a key at the prompt. The key is saved to ~/.config/whisper/key with owner-only permissions.
In CI or a container, set WHISPER_API_KEY in the environment instead. For a single command, pass --key; it wins over both. whisper config shows which source is in effect.
No account yet? Sign in and a key is created for you.
Explore the graph
whisper explore api.openai.com
This opens a full-screen view. You stand on a node, see its edges and neighbours, and step along any of them. With a key the view is live; without one it runs on demo data, which is a fine way to learn the schema before you write a query.
Where next
When a recipe does not cover your question, Cypher is the dialect the graph runs.