pi-icarus-hook

Give Pi access to your existing Hermes/Icarus memory.

Pick up where you left off, without reminding Pi to look up memory before every answer.

• Remember the context. Icarus supplies memories before Pi answers.
• Carry useful work forward. Successful exchanges go back to Icarus for capture.
• Stay in control. Turn automatic memory off, or simply hide its messages.

This connects an existing Hermes/Icarus / Memory OS installation. It does not install or replace the memory backend.

Get started

You need Pi, Node.js 22+, and a working local Icarus installation with its Python dependencies. The default plugin location is ~/.hermes/plugins/icarus.

pi install npm:pi-icarus-hook
pi

Already running Pi? Reload or restart after installation. Then ask something natural:

“What did we decide about this project last time?”

Memory context is visible by default. 🪽 Icarus in the footer means automatic memory is on. Pi can also search, recall, and write Fabric memories when you ask.

Everyday controls

Hiding is not disabling. Hidden context still goes to the model. Turning automatic memory off does not remove context already in the conversation or disable explicit Fabric tools.

Session controls apply now; saved defaults apply to future sessions. Use project instead of global to save a visibility default just for a trusted project.

Keep only useful context

The optional classifier automatically removes text it confidently judges irrelevant before memory reaches Pi. Uncertain text stays; if classification fails, the original context is kept. Startup context is left alone.

Privacy and cost: default may use a configured remote provider when no local classifier is available. That sends your prompt and candidate context to that provider and may incur charges. Choose an exact local model to prevent remote fallback, or use none.

Filtering is a relevance estimate, not fact-checking. Discarded text may not be offered again later by Icarus.

A few settings, only if you need them

Put this inside your Pi settings file—normally ~/.pi/agent/settings.json—to hide memory messages by default and disable classification:

{
  "piIcarusHook": {
    "contextDisplay": false,
    "classifier": "none"
  }
}

For a different installation, add "icarusDir": "/path/to/icarus" and "python": "/path/to/venv/bin/python" inside piIcarusHook. Use the Python environment where Icarus's dependencies are installed. Reload or restart Pi after editing settings.

Need more? Full configuration reference →

Help & further reading

• Memory missing? Check /icarus status, then /icarus config for the plugin and Python paths. After a backend failure, restart the session to reinitialize memory.
• Found a problem? Report an issue.
• What changed? Read the changelog.
• Developing the extension? Read the technical vision & developer guide.