56 lines
1.6 KiB
Markdown
56 lines
1.6 KiB
Markdown
# @hive-mind/cli
|
|
|
|
[](https://www.npmjs.com/package/@hive-mind/cli)
|
|
[](./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).
|