@litterthanlit/hypher-cli

Pilot · not yet recorded. The bridge between coding agents and Hypher project memory.

• hypher init connects this computer (one browser approval), installs a pinned copy under ~/.hypher/, and adds Claude Code hooks and Codex hooks (Codex asks once to trust them: /hooks). It keeps M0a's hypher sign-in entry wherever it finds one.
• hypher doctor checks each piece and prints the fix for anything red.
• hypher resume prints the note for this repository; hypher seal saves a handoff.
• hypher seal --evidence "<command>=<exit code>" (repeatable, split at the last =) reports a check you ran. Hypher binds each to the working tree at the save and labels it an agent report (only agent reports are accepted until hooks capture checks in Baton M3); the next note says whether that tree still matches. It never runs the command. Only the command text, exit code, tree hash, and time leave the machine, never output. Against a server that does not accept evidence yet, the handoff saves without it and says so.
• hypher mcp is the bridge for any MCP client: resume, seal, and acknowledge, with no IDs.
• hypher uninstall removes exactly what init added and revokes the key.
• init also puts ~/.hypher/bin on PATH with one marked block in your shell's startup file (~/.zshenv for zsh, ~/.bash_profile or ~/.bashrc for bash, a conf.d file for fish), so hypher runs by name in new terminals and in agents' shells. --no-path skips it; hooks and the MCP bridge use the full path either way.
• Inside Codex's sandbox the Keychain and the network are blocked. Commands run there say so instead of reporting that this computer is not connected.

Only hashes, file names, repository and commit identity, and agent-written handoff text leave the machine. Never code, diffs, or transcripts.

Canonical git helpers are vendored from packages/hypher-git (node script/sync-hypher-git.mjs). The note renderer, validators, and secret scan are vendored from hypher-web/shared (node script/sync-hypher-shared.mjs). Do not edit vendor/ by hand.

Releases go out from GitHub Actions with npm trusted publishing; see packages/hypher-cli/RELEASING.md in the repository.