오감 (발음: “오-움”) – AI 코딩 에이전트를 위한 지속적이고 검색 가능한 공유 메모리. 클라이언트 간 간 작동.

그게 뭐야

AI 코딩 에이전트는 세션 사이에 모든 것을 잊어버립니다. Claude Code에서 Cursor, Kiro, OpenCode로 전환하면 맥락—결정, 함정, 코드베이스 형태—이 사라져서 같은 문제를 반복하고, 다시 설명하고, 디버깅하게 됩니다.

Ogham은 세션과 클라이언트 간에 지속되는 하나의 공유 메모리를 에이전트에게 제공합니다. 이것은 검색 엔진입니다: 중요한 것을 저장하고 다시 찾아내며, LLM이 결과를 읽습니다.

검색 방식은 구조화 — 하이브리드 탐색과 타입 에지 그래프를 결합한 방식이고, 단순한 벡터 유사성만이 아닙니다. 이 때문에 두 사실 사이의 경로에 대한 답이 되는 질문, 즉 단순한 벡터 RAG가 떨어지는 경우에 답할 수 있습니다.

퀵 스타트

ogham init는 설정 마법사를 실행합니다: 데이터베이스를 연결하고, 임베딩 제공자를 선택하며, 스키마를 마이그레이션하고, MCP 클라이언트 설정(Claude Code, 커서, VS Code 등)을 작성합니다. Claude Code의 경우 claude mcp add를 실행하고; 다른 클라이언트의 경우, 복사할 스니펫을 출력합니다.

먼저 데이터베이스가 필요합니다 – 무료 Supabase 프로젝트나 네온 데이터베이스.

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