Skip to main content
Run this to see everything the command line tool manages on your machine, with each path and whether it is in place:
Pipe it (hyperspell status | jq .surfaces) to get the same list as JSON. The tool never touches anything outside this list.

What is installed

The tool also keeps your login and settings in ~/.hyperspell/ (readable only by you). The activity plugin in this list is for Claude Code. Codex can use the MCP log_activity tool to save an individual summary, but automatic Codex session capture and local handoff require the separate Codex activity plugin. Check its installation with codex plugin list and its hooks in a new conversation with $hyperspell-activity status. It is not shown by hyperspell status. Older versions added a block to ~/.claude/CLAUDE.md. The tool no longer does, and removes the block it wrote. hyperspell status shows this as CLAUDE.md block (retired).

Turn something off

hyperspell uninstall removes autostart, the MCP entries, the note blocks, the skill and the plugin, and uninstalls hyperbrain. Only the entries Hyperspell wrote are removed; the rest of each file is left as it was. Run hyperspell status afterwards to confirm nothing is left.