moving

packages/hive-mind-cli/README.md

@@ -0,0 +1,55 @@
+# @hive-mind/cli
+
+[![npm](https://img.shields.io/npm/v/@hive-mind/cli.svg)](https://www.npmjs.com/package/@hive-mind/cli)
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](./LICENSE)
+
+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
+
+```bash
+npm install -g @hive-mind/cli
+```
+
+or run without installing:
+
+```bash
+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
+
+```bash
+# 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](./LICENSE) and [NOTICE](./NOTICE).
+
+## Part of hive-mind
+
+Full docs at the [monorepo root](https://github.com/marolinik/hive-mind).