Connect your coding agents to the company brain, and ask the brain questions from the terminal.
The Hyperspell command line tool connects coding agents such as Claude Code, Codex, and Cursor to your company brain. It installs a query tool and the Hyperspell MCP server, and tells each agent how to ask the brain about your company, projects, people, and decisions.The tool has two parts, installed together:
hyperspell, the sync tool. It runs in the background, configures your coding agents, and keeps both tools up to date.
hyperbrain, the query tool. It lets you, or an agent, ask the brain a question, search it, or save a note from the terminal.
In the dashboard, open Settings, then Connect Agents, and choose CLI. The dashboard generates an install command that includes a one-time token tied to you. The token works once and expires after an hour, so generate a fresh one when you need it.
The CLI setup in the dashboard
2
Run it in your terminal
Paste the command into a terminal on your Mac or Linux machine. It looks like this, with your token in place of the placeholder:
The installer sets up an isolated Python environment, installs both tools, saves your credentials, registers the sync tool to start automatically when you log in, and configures your agents. It refuses to run as root.
3
Check the result
hyperspell status
This shows your account, where the tool keeps its files, and a log of the changes the installer made to your agent configuration.
Prefer to install by hand? The query tool is on PyPI: uv tool install hyperspell-brain or pipx install hyperspell-brain, then hyperbrain login. The sync tool is only distributed through the dashboard install command.
If you install on a second machine, or your credentials expire, run:
hyperspell login
The tool prints a short code and opens a page in your browser. Approve the login there, and the terminal picks it up on its own.The approval page shows the code, the app it is for, and where the request came from. It asks you to confirm that you started the login yourself on your own device. If someone sends you an approval link by email or chat, do not approve it. Codes work once and expire after ten minutes.
A short managed block telling each agent how to ask the brain and when to use it. The block sits between two marker comments, and the tool never touches anything outside them.
Claude Desktop and Claude Code configuration
A registration for the Hyperspell MCP server, so those agents can ask the brain live questions.
Once installed, a coding agent can answer “what does the billing service do and who owns it?” with hyperbrain ask or the Hyperspell MCP server.
The query tool works for people and for agents alike.
# Ask a question and get a cited answerhyperbrain ask "who owns the mobile release process?"# Search for documents without an answerhyperbrain search "Q3 pricing experiment"# Save something worth rememberinghyperbrain remember "The staging database is refreshed from production every Sunday night."# Check your setuphyperbrain doctor
hyperbrain help --agent prints the whole command surface as one short document, which is handy to paste into an agent’s instructions.
The sync tool checks for a new version of itself and of the query tool once a day and upgrades within the supported range. hyperspell update forces a check. hyperbrain update upgrades the query tool by itself.Other commands you may need:
Command
What it does
hyperspell status
Show your account, file locations, and recent actions.
hyperspell sync --once
Reconcile the agent configuration now and exit.
hyperspell search "query"
Search the brain for source documents.
hyperspell uninstall
Remove the tool and its autostart entry. Add --purge to also delete its files and credentials.
The install command fails immediately. The token works once and expires after an hour. Generate a new one from the dashboard. If you are on a machine where you are root, the installer stops on purpose; run it as a normal user.Claude Code does not seem to know about the brain. Open a new session so it re-reads ~/.claude/CLAUDE.md, and check claude mcp list shows the Hyperspell server. hyperspell status lists what the installer configured.I want everything gone.hyperspell uninstall --purge removes the tools, their files, the credentials, and the managed blocks in your agent configuration files.
Was this page helpful?
Assistant
Responses are generated using AI and may contain mistakes.
