Documentation

Get started with OmniClaude in 5 minutes

Quick Start

1. Install the Server

Clone the OmniClaude server package and install dependencies:

git clone https://github.com/anthropics/omniclaude-enterprise
cd omniclaude-enterprise/packages/server
npm install
npm run migrate  # Initialize SQLite database
npm start       # Start on port 3333

2. Connect Claude Code

Add OmniClaude hooks to your Claude Code configuration:

# ~/.claude/hooks/hooks.json
{
  "oc-wake": "http://localhost:3333/api/hook/oc-wake",
  "oc-prime": "http://localhost:3333/api/hook/oc-prime",
  "oc-digest": "http://localhost:3333/api/hook/oc-digest"
}

3. Configure Firebase (Optional)

For team features and cloud backup, connect your Firebase project:

export FIREBASE_PROJECT_ID="your-project-id"
export FIREBASE_ADMIN_CLIENT_EMAIL="your-email"
export FIREBASE_ADMIN_PRIVATE_KEY="your-key"

4. Start Coding with Context

Open Claude Code and start your first session. OmniClaude will:

  • ✓ Load your working memory from the previous session
  • ✓ Inject relevant project context automatically
  • ✓ Track your progress and decisions
  • ✓ Warn about cross-project impacts

Core Concepts

Three-Tier Memory

OmniClaude maintains three types of memory for intelligent context:

Working Memory

Current session state (~500 tokens). What you're doing right now. Auto-expires after the session ends.

Episodic Memory

Compressed session summaries. "What did I decide about the Stripe integration last Tuesday?" Indexed by date, project, and topic.

Semantic Memory

Distilled knowledge. Architecture decisions, coding patterns, team conventions. Persistent across all sessions and projects.

Project Graph

OmniClaude automatically detects dependencies between your projects. When you modify a shared file in one project, it warns about impacts on dependent projects. Cross-project patterns are shared across teams.

Watchdog Safety

The Watchdog detects agent drift: circular edits, repeating errors, hallucinated imports. It warns you before patterns spiral out of control, and learns your team's coding conventions automatically.

API Hooks

OmniClaude integrates with Claude Code through four HTTP hooks:

oc-wake

SessionStart

Session begins. Initialize memory and session state.

oc-prime

UserPromptSubmit

Before Claude sees your prompt. Inject relevant memory blocks.

oc-pulse

PreToolUse

Before Claude uses a tool. Safety checks and sync state.

oc-digest

Stop

Session ends. Process transcript, update memory, send notifications.

Support

Need help? Check out our resources: