mimori

Provides AST-based symbol search, context slicing, and blast-radius analysis for codebases.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/fusuyfusuy/dot-agents --skill mimori-fusuyfusuy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mimori
Source: https://github.com/fusuyfusuy/dot-agents/tree/main/skills/mimori
Command: npx skills add https://github.com/fusuyfusuy/dot-agents --skill mimori-fusuyfusuy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reading entire source files to understand code wastes context tokens and time, and editing shared symbols without knowing their callers risks breaking distant parts of a codebase. This Skill gives agents token-efficient AST code intelligence plus a persistent project memory and technical-debt ledger. ## Core Features & Use Cases - Token-Dense Context Slicing: Extract exact symbol bodies with 1-hop callers and callees (~120 tokens instead of 3,000+ for raw file reads) via mimori slice. - Architectural Mapping & Blast-Radius Analysis: PageRank centrality maps identify high-impact symbols, and mimori blast computes transitive ripple effects before any mutation. - Project Memory & Debt Tracking: Maintains .agents/memory.md with vocabulary, gotchas, and a 30-line-capped debt ledger synced from in-code # ponytail: markers. - Use Case: Before renaming a shared utility function, run mimori blast src/utils.ts:helper -d 3 to see every caller, entry point, and test suite affected, then slice only the symbols you need to edit. ## Quick Start Ask the agent to run mimori dump with a 1500-token budget to load project memory and architectural entry points before starting work on this repository.

Frequently Asked Questions about mimori

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read a specific function without loading the whole file?▼

Use mimori slice with a coordinate like path/to/file.ts:functionName to extract just that symbol's body. Add -f to inline private local callees and -i to include imports, consuming roughly 120 tokens instead of thousands.

How to check what breaks before renaming a function?▼

Run mimori blast with the target coordinate and a depth, such as mimori blast src/utils.ts:helper -d 3. It computes the transitive upstream ripple across callers, entry points, and test suites before you edit.

Does mimori work as an MCP server?▼

Yes, run mimori mcp to start a JSON-RPC stdio server exposing tools like mimori_slice, mimori_map, mimori_blast, mimori_graph, mimori_memory, and mimori_debt. Each MCP tool mirrors a CLI subcommand with equivalent arguments.

What is the ponytail debt marker format?▼

Ponytail markers are in-code comments formatted as '# ponytail: <what> <- <ceiling> -> <upgrade_trigger>' and work with //, /* */, and -- comment styles. The mimori debt command lists, validates, and syncs them into .agents/memory.md.

Why does mimori fail with an ambiguous coordinate error?▼

When a bare symbol name matches multiple candidates, mimori exits with code 1 and prints candidate coordinates ranked by PageRank rather than guessing. Re-run with a more specific path-qualified coordinate to resolve the ambiguity.