@optiqcode/cli

The CLI and MCP server for Optiq — a context engine for your codebase.

Install

npm install -g @optiqcode/cli

Getting started

optiq login

You'll get a one-time code via email. Paste it in, and you're good.

Commands

optiq login              Sign in with email OTP
optiq logout             Sign out
optiq whoami             Check which account you're using

optiq index [path]       Index a directory for search
optiq search <query>     Search your indexed code
optiq repos              List your indexed repositories
optiq status <job_id>    Check on an indexing job

optiq mcp                Start the MCP server (stdio)

Indexing

# Index the current directory
optiq index

# Index a specific path
optiq index ~/projects/my-app

# Force a clean re-index
optiq index --fresh

After the first index, the backend watches your files and keeps the index up to date automatically. You don't need to re-run optiq index.

Search

Search uses natural language. Just describe what you're looking for.

optiq search "how does the auth middleware validate tokens"
optiq search "where are database connections configured" --repo-id my-app
optiq search "what handles file uploads and validation" --limit 20

You can also use structured filters:

optiq search "symbol:handleAuth"
optiq search "file:middleware type:function"
optiq search "def:createUser"

MCP server

The CLI doubles as an MCP server for AI agents (Claude Code, Cursor, etc). It exposes four tools:

• optiq_index — index a directory
• optiq_search — search indexed code with natural language queries
• optiq_status — check indexing job status
• optiq_repos — list indexed repositories

The search tool accepts natural language — agents should describe what they're looking for in plain English rather than using keyword-style queries.

Claude Code

Add this to .claude/settings.json:

{
  "mcpServers": {
    "optiq": {
      "command": "optiq",
      "args": ["mcp"]
    }
  }
}

Other MCP clients

Any client that supports stdio transport works. Point it at optiq mcp.

License

MIT