npm install -g mikoshi

✨ Mikoshi — Context Engine for Private local code search + MCP

This system is an independent implementation inspired by publicly observable behavior of agentic developer tools. The agent runtime, tool lifecycle, permission flow, and event protocol are clean-room implementations using mk_-prefixed types and events.

Provenance

See PROVENANCE.md for implementation provenance and design constraints.

Install

npm install -g mikoshi

Use

mikoshi index ~/project
mikoshi search ~/project "query"
mikoshi run --print --output-format json --max-turns 6 "summarize this repo"

MCP

mikoshi-mcp

ACP (any ACP-compatible editor)

mikoshi --acp
# optional helper config:
mikoshi acp setup .

Interactive permissions

/permissions
# configure: filesystem.write, process.spawn, network.external

Models

/models
# provider: openai, anthropic, minimax, or kimi
# API keys are stored per provider+model
# openai models: gpt-5.2, gpt-5.2-codex, gpt-5.2-pro
# anthropic models: claude-sonnet-4-5, claude-haiku-4-5, claude-opus-4-6
# minimax models: MiniMax-M2.5
# kimi models: moonshot/kimi-k2.5, kimi-k2-0905-preview

Codex MCP config (config.toml)

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

[projects."~/project"]
trust_level = "trusted"

Developer

npm install
npm test
mikoshi doctor