Skip to main content
Glama

Miru (見る)

CI coverage license bun

Hybrid code search for AI coding agents.

Ask where something happens in your codebase. Miru returns relevant file paths, line numbers, and source excerpts through MCP.

Install

Requires Bun 1.1 or later, with bunx on your PATH.

Run inside Claude Code:

/plugin marketplace add takara-ai/miru-code
/plugin install miru@miru

Reload plugins or restart Claude Code, then ask:

Use Miru to find where authentication is configured in this project.

If credentials are missing, Claude can use Miru's auth tool to start sign-in. Approve the login code, then retry the search. Plugin credentials are separate from CLI credentials.

Other agents

See agent integrations for Codex and Cursor plugins. The Cursor plugin provides skills and rules; use the CLI installer below to connect its MCP tools.

Related MCP server: grepsense

Install (CLI fallback)

For terminal use or agents configured through the CLI:

bun add -g @takara-ai/miru-code
miru setup
miru install

Choose your agents in the installer, then restart them. See supported integrations. Use miru uninstall to remove the configuration.

Try it

miru search "auth middleware" ./src
miru locate REDIS_HOST ./src
miru expand src/auth.ts 42 ./src
miru find-related src/auth.ts 42 ./src

Use --json for scripts. Run miru <command> -h for options.

MCP tools

Tool

Purpose

search

Find code by meaning

locate

Find exact strings, regex matches, or filenames

expand

Read neighbouring chunks in the same file

find_related

Find similar code in other files

auth

Sign in or configure a SageMaker endpoint

read_benchmark

Read token-savings totals when benchmark mode is enabled

The optional repo argument defaults to the server's working directory. Miru builds the index on first use and watches local files for changes.

How it works

Miru combines embeddings, BM25, and code-aware ranking. Tree-sitter provides syntax-aware chunks for 26 languages, with structural and line-based fallbacks for other files.

See chunking and caching and the ranking evaluation.

Privacy and API usage

By default, Miru sends file contents as source chunks and search queries over HTTPS to Takara for embeddings. API usage may incur costs under your Takara plan.

For embeddings on your own infrastructure, use AWS SageMaker. Set MIRU_WORKSPACE_ROOT to restrict local MCP repository paths to one directory.

Documentation

  • Reference: CLI commands, MCP parameters, configuration, and benchmarks

  • Agent integrations: plugin capabilities, configuration paths, and optional skills

  • Contributing: development setup, checks, and releases

Credits

Miru builds on work by MinishLab:

See NOTICE for attribution and licence text.

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Deep code indexing for AI agents. Search symbols, navigate call graphs, explore inheritance, track git history — all via MCP.
      76 PyPI
      59
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides two-modal code search (lexical via Zoekt and semantic via ChromaDB embeddings) for AI coding agents through MCP tools, enabling fast regex and meaning-based code lookup.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI coding assistants to semantically search and retrieve relevant code patterns, documentation, and implementations from a codebase via MCP tools.
      8
      MIT