Mikoshi

Spotlight for your codebase.

Private, local code search + MCP. No cloud. No telemetry.

Quickstart

Install

$ npm install -g mikoshi

Doctor

$ mikoshi doctor

Index

$ mikoshi index ~/project

$ mikoshi search ~/project "sign in duplicate body"

Essentials

Built for local work

Mikoshi keeps indexing local, quiet, and predictable. No uploads. No surprises.

Local-first

Offline-capable

MCP-ready

Read-only

Hybrid search

Principles

Private by design

Indexes locally to ~/.mikoshi. Never touches your repo.

Clean CLI. One-time model setup. Zero noise.

Works with your agents

Codex, Claude, Cursor — via MCP stdio.

Step 1

Install

Install once. Run a quick check.

Step 2

Index

Index a repo. Read-only by design.

Step 3

Search with clean, hybrid results.

Step 4

MCP

Start MCP when you need it.

Add Mikoshi to your MCP servers list.

[mcp_servers.mikoshi]
command = "mikoshi-mcp"
args = []
enabled = true

Install once. Search everywhere.