youyo-memoria

memoria

memoria is a project-aware, LAG-powered memory system for Claude Code.

It automatically captures, structures, and retrieves knowledge from coding sessions across projects, with strong locality and similarity awareness.

Documentation

• Japanese README: README.ja.md
• Detailed design: docs/specs/SPEC.ja.md
• CLI design: docs/specs/CLI.ja.md
• Hook contract: docs/specs/HOOKS.ja.md
• Data model: docs/specs/SCHEMA.ja.md
• Workers: docs/specs/WORKERS.ja.md
• Retrieval: docs/specs/RETRIEVAL.ja.md
• Agent skill: skills/memoria/SKILL.md

Architecture

Claude Code
  -> plugin (hooks + skill)
    -> memoria CLI (Go / Kong)
      -> ingest worker (Go)
      -> embedding worker (Python / uv / UDS)
      -> SQLite (queue + memory + retrieval metadata)

Installation

Homebrew

brew install youyo/tap/memoria

Go install

go install github.com/youyo/memoria@latest

Setup

In Claude Code:

/plugin

Add marketplace: youyo/memoria, then enable the plugin.

That's it. Database, migrations, and workers are initialized automatically on first use.

Usage

memoria memory search "why session end is unreliable"
memoria worker status
memoria doctor