# Oko

Oko searches a project on the local machine and gives coding agents ranked code excerpts with line numbers. It helps when the codebase is unfamiliar.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 14
- Author: bartlomein
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bartlomein/oko
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/oko

## What it does

Oko adds local project search to Claude Code, Codex, Cursor and the other listed clients. It checks keywords, symbols and file structure, then ranks the matching locations before the agent starts browsing files on its own. The result is a focused excerpt with line numbers.

Install it with Homebrew or the provided installer, then run `oko setup --client claude` inside a project. Setup connects the client and asks for a TypeSafe AI key on first use. Each project needs its own setup, and the server runs on macOS and Linux.

The terminal interface includes `oko ask`, with an optional JSON result. Adding `--no-jev` switches to local keyword ranking without a key. Duplicated code can still send the wrong copy to the top, while changes spread across many files need further exploration by the agent.

## Requirements
- Environment variables: `TYPESAFE_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- locate the file that handles a feature
- trace how request retries work
- inspect a ranked excerpt with line numbers
- reduce unnecessary file browsing by an agent

## Example prompts
- Find where authentication is handled in this project.
- Trace the retry logic and show the relevant line numbers.
- Use Oko to locate every file connected to this API.

## Similar
- [Nia](https://affpapa.org/en/nevibecode/skills/nia.md) — skill · 56200 installs
- [ccc](https://affpapa.org/en/nevibecode/skills/ccc.md) — skill · 5900 installs
- [exa-web-search-free](https://affpapa.org/en/nevibecode/skills/exa-web-search-free.md) — skill · 2800 installs
- [mcp-deepwiki](https://affpapa.org/en/nevibecode/skills/mcp-deepwiki.md) — skill · 2800 installs
- [atomic-decomposition](https://affpapa.org/en/nevibecode/skills/atomic-decomposition.md) — skill · 1600 installs
- [searching-sourcegraph](https://affpapa.org/en/nevibecode/skills/searching-sourcegraph.md) — skill · 1400 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md