Installation

Claude Code Plugin

The recommended way to use Mem- Oracle with Claude Code.

Via Plugin Marketplace

Terminal

# In Claude Code terminal:
/plugin marketplace add jagjeevanak/mem-oracle
/plugin install mem-oracle

Restart Claude Code after installation.

Manual Plugin Setup

Clone the repository:

Terminal

git clone https://github.com/jagjeevanak/mem-oracle.git
cd mem-oracle
bun install

The hook config in plugin/hooks/hooks.json handles lifecycle events automatically.

Plugin Hooks

The Claude Code plugin implements these lifecycle hooks:

Hook	Description
SessionStart	Warms the worker service
UserPromptSubmit	Ensures worker is running and injects docs
SessionEnd	Stops the worker when idle

OpenCode Plugin

Option 1: Copy to Project (Recommended)

Terminal

# From your project root
mkdir -p .opencode/plugin .opencode/skills .opencode/command

# Copy the plugin file
cp /path/to/mem-oracle/.opencode/plugin/mem-oracle.ts .opencode/plugin/

# Copy the skills
cp -r /path/to/mem-oracle/.opencode/skills/docs-search .opencode/skills/

# Copy the commands
cp /path/to/mem-oracle/.opencode/command/*.md .opencode/command/

Option 2: Global Installation

Terminal

mkdir -p ~/.config/opencode/plugin ~/.config/opencode/skills ~/.config/opencode/command

# Copy plugin
cp /path/to/mem-oracle/.opencode/plugin/mem-oracle.ts ~/.config/opencode/plugin/

# Copy skills
cp -r /path/to/mem-oracle/.opencode/skills/docs-search ~/.config/opencode/skills/

# Copy commands
cp /path/to/mem-oracle/.opencode/command/*.md ~/.config/opencode/command/

Option 3: Clone and Symlink

Terminal

git clone https://github.com/jagjeevanak/mem-oracle.git ~/.mem-oracle-plugin

# For project-level
mkdir -p .opencode/plugin .opencode/skills .opencode/command
ln -s ~/.mem-oracle-plugin/.opencode/plugin/mem-oracle.ts .opencode/plugin/
ln -s ~/.mem-oracle-plugin/.opencode/skills/docs-search .opencode/skills/
for f in ~/.mem-oracle-plugin/.opencode/command/*.md; do ln -s "$f" .opencode/command/; done

OpenCode Slash Commands

Command	Description
`/reindex <url>`	Re-index a documentation site with fresh content
`/docs-status`	Check status of all indexed documentation
`/docs-search <query>`	Search through indexed documentation
`/refresh-all`	Refresh all stale docsets (older than 24h)

Manual Installation

For standalone usage without editor plugins.

Install from Source

Terminal

# Clone the repository
git clone https://github.com/jagjeevanak/mem-oracle.git
cd mem-oracle

# Install dependencies
bun install

# Start the worker service (default: http://127.0.0.1:7432)
bun run worker

Using as MCP Server

Start the MCP server for explicit tool calls:

Terminal

mem-oracle mcp

Add to your MCP configuration:

.mcp.json

{
  "mcpServers": {
    "mem-oracle": {
      "command": "mem-oracle",
      "args": ["mcp"]
    }
  }
}

If you're running from source, use bun run /path/to/mem-oracle/src/index.ts mcp.

MCP Tools Available

Tool	Description
`search_docs`	Search indexed documentation
`get_snippets`	Get specific documentation chunks
`index_docs`	Index a documentation website
`index_status`	Get indexing status

Requirements

Requirement	Version
Bun	Latest
Claude Code	Latest with plugin support
OpenCode	Latest with plugin support

Verify Installation

Check that everything is working:

Terminal

# Health check
curl http://localhost:7432/health

# Should return:
# {"status":"ok","uptime":...}

Installation

On this page