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 33332. 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-wakeSessionStart
Session begins. Initialize memory and session state.
oc-primeUserPromptSubmit
Before Claude sees your prompt. Inject relevant memory blocks.
oc-pulsePreToolUse
Before Claude uses a tool. Safety checks and sync state.
oc-digestStop
Session ends. Process transcript, update memory, send notifications.
Support
Need help? Check out our resources: