howardpen9

Hermes Gbrain Bridge — Documentation skill for Claude Code

Documentation community

Convert Hermes / OpenClaw agent memory (JSONL sessions, MEMORY.md) to markdown for gBrain ingest.

How to install Hermes Gbrain Bridge

This entry records only its repository, not the path inside it, so there is no exact command to give. Open howardpen9/hermes-gbrain-bridge and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Hermes Gbrain Bridge does

Convert Hermes / OpenClaw agent memory (JSONL sessions, MEMORY.md) to markdown for gBrain ingest.

Alternatives in Documentation

Notion Knowledge Capture — Convert conversations into structured, searchable Notion wiki entries 14.6k ★
Ars Format Convert — ARS academic-paper format-convert mode — convert to LaTeX / DOCX / PDF / Markdown 4.5k ★
Napkin — You maintain a per-repo markdown runbook, not a chronological log 420 ★

README

hermes-gbrain-bridge

A small, dependency-free bridge that converts scattered agent memory (Hermes, Claude Code, Codex, OpenClaw) into clean markdown for [gBrain](https://github.com/garrytan/gbrain) to ingest.

🇹🇼 繁體中文版本：[README.zh-TW.md](README.zh-TW.md)

Most agent tools write memory in their own format — JSONL event streams, flat-key text, SQLite. gBrain only imports markdown. If you want one searchable brain across everything you've ever asked an agent, you need a bridge. This is that bridge.

Why this exists

On one normal developer machine, agent memory lives in at least **five** different places — each in its own format:

Tool	Location	Format
Hermes	`~/.hermes/sessions/.jsonl` + `memories/.md`	JSONL + `§`-delimited markdown
Claude Code	`~/.claude/projects//*.jsonl`	Event stream JSONL
Codex CLI	`~/.codex/sessions/*/.jsonl`	JSONL with `session_meta` header
OpenClaw archive	`~/.openclaw.pre-migration/workspace/*/.md`	Markdown with legacy paths
Conductor workspaces	Encoded into the Claude Code path	Same as Claude Code

gBrain is an excellent knowledge brain, but out of the box it only reads markdown. You don't want to lose the last three years of conversations just because they're in the wrong container. This repo is the converter that makes them ingestible — one command per source, with mtime windows, size floors, secret redaction, and a canonical event format under the hood.

Architecture

┌──────────────────────────────────┐       ┌───────────────────────┐
│        Local machine             │       │   Cloud (Railway)     │
│                                  │       │                       │
│  ~/.hermes/sessions/             │       │   Postgres            │
│  ~/.hermes/memories/             │─┐     │   + pgvector          │
│  ~/.claude/projects/             │ │     │   + pg_trgm