Context Engine for Private local code search + MCP
``bash`
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.
for implementation provenance and design constraints.Install
`bash
npm install -g mikoshi
`Use
bash
mikoshi index ~/project
mikoshi search ~/project "query"
`MCP
bash
mikoshi-mcp
`Interactive permissions
text
/permissions
configure: filesystem.write, process.spawn, network.external
`Models
text
/models
provider: openai or anthropic
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
`Codex MCP config (config.toml)
toml
[mcp_servers.mikoshi]
command = "mikoshi-mcp"
args = []
enabled = true[projects."~/project"]
trust_level = "trusted"
`Developer
bash
npm install
npm test
mikoshi doctor
``