# Omega

Maintain persistent project context by storing decisions, lessons, and task checkpoints for seamless session transitions. Navigate information through semantic search and relationship graphs to uncov…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add omegamemory/omega-memory

# Browse available tools
npx -y @smithery/cli@latest tool list omegamemory/omega-memory

# Get full schema for a tool
npx -y @smithery/cli@latest tool get omegamemory/omega-memory omega_store

# Call a tool
npx -y @smithery/cli@latest tool call omegamemory/omega-memory omega_store '{}'
```

## Direct MCP Connection

Endpoint: `https://omega-memory--omegamemory.run.tools`

**Optional config:**
- `api_key` (query) — API key for authenticated OMEGA instances. Not required for the public demo server.

## Tools (26)

- `omega_store` — Store a memory with optional type and metadata. Use when the user says 'remember this' or for programmatic capture (dec…
- `omega_query` — Search memories — semantic (default) or exact phrase match. Use mode='phrase' for literal substring search (error messa…
- `omega_welcome` — Get a session welcome briefing with recent relevant memories and user profile.
- `omega_profile` — Read or update the user profile. Returns the profile by default. If 'update' dict is provided, merges those fields into…
- `omega_delete_memory` — Delete a specific memory by its ID.
- `omega_edit_memory` — Edit the content of a specific memory.
- `omega_list_preferences` — List all stored user preferences.
- `omega_health` — Detailed health check with memory usage, node counts, cache stats, warnings, and recommendations.
- `omega_backup` — Export or import memories for backup/restore. Default mode is export.
- `omega_lessons` — Retrieve cross-session or cross-project lessons learned, ranked by verification count and access frequency.
- `omega_feedback` — Record feedback on a surfaced memory (helpful, unhelpful, outdated). Improves future surfacing quality.
- `omega_clear_session` — Clear all memories for a specific session. Use for cleanup after test sessions.
- `omega_similar` — Find memories similar to a given memory. Use for discovering related context.
- `omega_timeline` — Show memory timeline grouped by day. Use to see what was captured recently.
- `omega_consolidate` — Run memory consolidation: prune stale low-value memories, cap session summaries, clean orphaned edges. Returns a report.
- `omega_traverse` — Traverse the memory relationship graph from a starting memory. Shows all connected memories within N hops, useful for u…
- `omega_compact` — Compact related memories into consolidated knowledge nodes. Finds clusters of similar memories (same event type, high o…
- `omega_checkpoint` — Save a task checkpoint — captures current plan, progress, files touched, decisions, and key context. Use when: (1) cont…
- `omega_resume_task` — Resume a previously checkpointed task. Retrieves the latest checkpoint with full plan, progress, files, decisions, and …
- `omega_remind` — Set a time-based reminder. OMEGA will surface it when the time arrives (at session start or during active sessions). Us…
- `omega_remind_list` — List active reminders with their status and due times.
- `omega_remind_dismiss` — Dismiss a reminder by its ID. Use after acknowledging a reminder.
- `omega_type_stats` — Get memory counts grouped by event type. Shows the composition of the memory store (how many decisions, lessons, errors…
- `omega_session_stats` — Get memory counts grouped by session. Shows which sessions have contributed the most memories (top 20).
- `omega_weekly_digest` — Get a weekly knowledge digest with stats, trends, and highlights. Shows new memories, session count, growth trends, typ…
- `omega_protocol` — Get your coordination playbook — dynamically assembled operating instructions. Call at session start (step 2 after omeg…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get omegamemory/omega-memory <tool-name>
```