@hive-mind/cli

Command-line tools for hive-mind memory. Designed to run from SessionStart / Stop hooks and nightly cron jobs — wherever you need a shell-driven way to read from, write to, or maintain a hive-mind workspace.

Install

npm install -g @hive-mind/cli

or run without installing:

npx @hive-mind/cli recall-context "what do I know about X"

Commands

Command	Purpose
`recall-context <query>`	Hybrid FTS5 + vector search over memory frames
`save-session`	Persist current session transcript as memory frames
`harvest-local`	Ingest ChatGPT / Claude / Gemini / PDF / Markdown / URL exports
`cognify`	Extract entities and relations into the knowledge graph
`compile-wiki`	Compile memory into interlinked wiki pages
`maintenance`	Compact superseded frames, clean up deprecated data

Every command supports --json for machine-readable output and --help for flags.

Examples

# Recall
hive-mind-cli recall-context "deployment pipeline decisions"

# Save a Claude Code session transcript
hive-mind-cli save-session --file ./claude-session.md

# Harvest a folder of ChatGPT exports
hive-mind-cli harvest-local --source chatgpt --path ./exports

# Nightly maintenance
hive-mind-cli maintenance --compact --cleanup

License

Apache 2.0. See LICENSE and NOTICE.

Part of hive-mind

Full docs at the monorepo root.