# Hypatia Bridge

> Use when Hermes needs a local external memory/knowledge-graph backend without remote services. Trigger when storing durable notes outside built-in memory, querying local knowledge shelves, syncing selected Hermes memory into a searchable graph, or building a fallback local memory layer.

- Skill: `undermybelt/hypatia-bridge` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add undermybelt/hypatia-bridge`
- Raw SKILL.md: https://api.skillmd.com/api/skills/undermybelt/hypatia-bridge/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: undermybelt (https://skillmd.com/u/undermybelt)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/undermybelt/hypatia-bridge

---


# Hypatia Bridge

## Purpose

Use local Hypatia as a sidecar memory layer for Hermes.

## When to use

- Need durable local notes beyond built-in memory limits
- Need searchable external memory
- Need subject/predicate/object graph facts
- Need a local fallback when hosted memory is not enough

## Assets

Workspace:
- `~/Downloads/hermes-hacks/hermes-hypatia-bridge/`

Primary CLI:
- `python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py`

Default Hypatia binary:
- `~/Downloads/repo-intake/hypatia/target/release/hypatia`

## Linked reference

- `references/usage.md`

## Commands

### Add note
```bash
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py add-note "Name" "Body" --tags a,b
```

### Search
```bash
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py search "query"
```

### Get note
```bash
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py get-note "Name"
```

### Add statement
```bash
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py add-statement Hermes uses Hypatia --data "external memory backend"
```

### Query triple
```bash
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py query-triple Hermes uses Hypatia
```

### Raw JSE query
```bash
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_hypatia.py query '["$knowledge", ["$search", "persona"]]'
```

### Selective Hermes sync
```bash
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_memory_sync.py add-memory user persona "Default terse Wenyan mode"
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_memory_sync.py add-fact Hermes uses Hypatia --data "external memory backend"
```

### Semi-auto wrapper
```bash
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_auto_sync.py memory user persona "Default terse Wenyan mode"
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_auto_sync.py fact Hermes uses Hypatia --data "external memory backend"
python3 ~/Downloads/hermes-hacks/hermes-hypatia-bridge/hermes_auto_sync.py memory memory long_term_rule "Prefer direct execution" --sync no
```

## Environment

- `HYPATIA_BIN`
- `HERMES_HYPATIA_SHELF`

## Pitfalls

- If search returns empty after writes, verify Hypatia binary is rebuilt with FTS rebuild fix in `src/storage/sqlite_store.rs`.
- Keep built-in Hermes memory for compact user prefs; use Hypatia for larger external recall.