Ogham (произносится как «OH-um») — постоянная, поисковая общая память для агентов кодирования ИИ. Работает между клиентами.

Что это такое

Агенты программирования ИИ забывают всё между сессиями. Переключаешься с Claude Code на Cursor, затем на Kiro и OpenCode — и контекст исчезает — решения, подводные завои, форма вашей кодовой базы — поэтому вы повторяетесь, объясняете и отлаждаете те же проблемы.

Ogham даёт вашим агентам одну общую память, которая сохраняется между сессиями и клиентами. Это движок извлечения: он хранит важное и находит это заново, а ваш LLM читает результаты.

Поиск — это структурированный — гибридный поиск плюс типизированный граф с краями, а не просто векторное сходство. Именно это позволяет отвечать на вопросы, ответ на которые — путь между двумя фактами, например, когда обычный векторный RAG сводится.

Быстрый старт

ogham init запускает мастер настройки: он соединяет вашу базу данных, выбирает провайдера вложения, мигрирует схему и записывает конфигурацию клиента MCP (Claude Code, Cursor, VS Code и другие). Для Claude Code он запускает claude mcp add для вас; для других клиентов он печатает фрагмент для копирования.

Сначала нужна база данных — бесплатный проект Supabase или Neon.

Ogham MCP

Ogham (pronounced “OH-um”) – persistent, searchable shared memory for AI coding agents. Works across clients.

What it is

AI coding agents forget everything between sessions. Switch from Claude Code to Cursor to Kiro to OpenCode and the context is gone – decisions, gotchas, the shape of your codebase – so you repeat yourself, re-explain, and re-debug the same issues.

Ogham gives your agents one shared memory that persists across sessions and clients. It is a retrieval engine: it stores what matters and finds it again, and your LLM reads the results.

The retrieval is structured – hybrid search plus a typed-edge graph, not just vector similarity. That is what lets it answer questions whose answer is a path between two facts, the case where plain vector RAG falls down.

Quick start

uvx --from ogham-mcp ogham init

ogham init runs a setup wizard: it connects your database, picks an embedding provider, migrates the schema, and writes the MCP client config (Claude Code, Cursor, VS Code, and others). For Claude Code it runs claude mcp add for you; for other clients it prints the snippet to copy.

You need a database first – a free Supabase project or a Neon database. On Neon or self-hosted Postgres, install the postgres extra so the driver is available:

uvx --from 'ogham-mcp[postgres]' ogham init

Then tell your agent to remember something and ask about it later – from the same client or a different one. They share the database, so the memory follows you.

Manual setup

If you’d rather configure things yourself instead of using the wizard:

# Supabase
export SUPABASE_URL=https://your-project.supabase.co
export SUPABASE_KEY=your-service-role-key
export EMBEDDING_PROVIDER=openai  # or ollama, mistral, voyage
export OPENAI_API_KEY=sk-...      # for your chosen provider

# Or Postgres (Neon, self-hosted)
export DATABASE_BACKEND=postgres
export DATABASE_URL=postgresql://user:pass@host/db
export EMBEDDING_PROVIDER=openai
export OPENAI_API_KEY=sk-...

Run the schema migration (sql/schema.sql for Supabase, sql/schema_postgres.sql for Neon/self-hosted), then add the MCP server to your client.

Installation methods