@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.