オガム(発音は「オーーム」)――AIコーディングエージェントのための永続的で検索可能な共有メモリ。クライアント間で動作します。

何なのか

AIのコーディングエージェントはセッション間にすべてを忘れてしまいます。Claude CodeからCursor、Kiro、OpenCodeに切り替えると、コンテキスト(意思決定、落とし穴、コードベースの形など)が消え、同じ問題を繰り返し、説明し直し、デバッグし直すだけです。

Oghamはエージェントに、セッションやクライアント間で永続する共通メモリを提供します。これは検索エンジンであり、重要なものを保存し、再び見つけ出し、あなたのLLMが結果を読み取ります。

検索は構造化で、ハイブリッド探索と型付きエッジグラフを組み合わせたもので、単なるベクトル類似性ではありません。これが、単純なベクトルRAGが落下する場合など、2つの事実間のパスの答えである質問に答えられる理由です。

クイックスタート

ogham initはセットアップウィザードを実行します。データベースを接続し、埋め込みプロバイダーを選び、スキーマを移行し、MCPクライアント設定(Claudeコード、カーソル、VSコードなど)を書き込みます。Claudeコードの場合は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