CLI Reference

Commands Overview

Usage

mem-oracle <command>

If you're running from source, replace mem-oracle with bun run src/index.ts.

Command	Description
`worker`	Start the worker HTTP service
`serve`	Alias for `worker`
`mcp`	Start the MCP server (stdio)
`index`	Index a documentation URL
`search`	Search indexed documentation
`status`	Show indexing status

Start the worker HTTP service that handles indexing and retrieval.

Terminal

mem-oracle worker

Terminal

# Start on default port
mem-oracle worker

Start the MCP (Model Context Protocol) server for explicit tool calls.

Terminal

mem-oracle mcp

This starts an MCP server using stdio for communication. Use this with Claude Code's MCP configuration.

Index a documentation website.

Terminal

mem-oracle index <url>

Argument	Required	Description
`url`	Yes	The documentation URL to index

Terminal

# Index Next.js docs
mem-oracle index https://nextjs.org/docs/getting-started

Search through indexed documentation.

Terminal

mem-oracle search <query>

Argument	Required	Description
`query`	Yes	The search query

Terminal

# Basic search
mem-oracle search "how to use server components"

Show the status of indexed documentation.

Terminal

mem-oracle status

Next.js Docs (https://nextjs.org)
  ID: abc123
  Status: ready
  Pages: 245/245 indexed
  Pending: 0, Errors: 0, Skipped: 0
  Chunks: 4120

Terminal

# Run with hot reload
bun run dev

# Type check
bun run typecheck

# Run tests
bun test