Oko MCP server

Oko

Help your coding agent find code faster and use fewer tokens.

Oko gives Claude Code, Codex, Cursor, OpenCode and Pi a better code search. When you ask your agent about your code, Oko has already found the relevant source, so the agent spends fewer rounds searching and reading files it does not need.

Nine coding tasks on Astro, HTTPX and ripgrep, three runs each, with and without Oko. Results · Method

• Faster: about half the time in Claude Code, OpenCode and Pi; a quarter less in Codex.
• Cheaper: 33–44% fewer tokens with every tool we measured.
• Fewer detours: 65–89% fewer tool calls.
• Better ranking: puts the right file first more often than any published method on Agent Retrieval Bench.
• Local first: search runs on your machine; only the question and selected snippets go to the ranker (privacy).

Quick start

brew install bartlomein/tap/oko
cd your-project
oko setup --client claude     # or codex, cursor, opencode, pi, all

Without Homebrew: curl -fsSL https://raw.githubusercontent.com/bartlomein/oko/main/install.sh | sh.

Then use your coding tool as usual. Setup asks for a TypeSafe AI key the first time, connects your tool to Oko for this project, and checks the connection. Run it once per project; oko upgrade keeps everything current (with Homebrew, run brew upgrade oko first).

Codex: approve Oko's hook once

The first time you open the project, Codex shows Hooks need review. Choose Trust all and continue. If you skipped it, /hooks brings it back.

Cursor: turn Oko on once

Cursor adds a project's tools switched off. Open Customize > MCPs, click oko and turn it on.

Pi: trust the project

Pi 1.0 or later. Trust the project when Pi asks, then check /mcp. Pi setup.

Claude Code, OpenCode: nothing more to do

Start a new session after setup.

Platforms, manual install, no-key mode

macOS (Apple Silicon and Intel) and Linux (ARM64 and x64, glibc 2.35+). The installer puts oko in ~/.local/bin; add it to your PATH if needed. Other install options · Connect a tool by hand · Keys and configuration. For search without a key, add --no-jev: local keyword ranking only.

Results

The same task given to the same coding tool twice, once with its own search and once with Oko, in the same run. Means per session.

Shortened. The full README is on GitHub.