{"slug": "i-built-satori-a-read-only-codebase-map-for-ai-coding-agents", "title": "I built Satori: a read-only codebase map for AI coding agents", "summary": "Hamza built Satori, an open-source, read-only codebase map for MCP-compatible AI coding agents. It provides a structured investigation path to help agents efficiently navigate symbols, ownership boundaries, and dependencies without editing source code, reducing token costs and improving context accuracy.", "body_md": "Hi, I’m Hamza, the maker of **Satori**.\n\nMost AI coding agents can search files.\n\nThat is not enough.\n\nReal codebases are not flat text dumps. They have symbols, ownership boundaries, wrappers, callers, callees, stale files, generated output, and logic spread across folders.\n\nWithout structured repo context, agents build context the hard way.\n\nThey burn tokens pulling broad file dumps.\n\nThey still may not have the complete picture.\n\nThey guess which file owns the behavior.\n\nThey miss related callers, wrappers, and stale paths.\n\nThat is expensive for frontier models — and even harder for smaller, local, or non-frontier models where every token matters more.\n\nI built **Satori** to give MCP-compatible coding agents a more efficient investigation path before they touch code.\n\nSatori is an open-source, read-only codebase map for AI coding agents.\n\nIt helps agents move from:\n\n```\nplain-English intent\n→ owner symbols\n→ file outline\n→ exact symbol / line reads\n→ advisory caller/callee context\n→ freshness-aware recovery\n```\n\nThe goal is simple:\n\nSatori does **not** edit your source code. It gives agents better repo context so developers can steer and approve changes with more confidence.\n\nSearch gives agents access to text.\n\nBut investigation needs more than nearby text.\n\nA real repo has structure:\n\nWhen agents do not have a structured path, they often compensate by pulling more files into context.\n\nThat increases token cost, but it does not guarantee completeness.\n\nMore context is not the same thing as better evidence.\n\nSatori exposes a small MCP tool surface for repo investigation:\n\nThe point is not to replace developer judgment.\n\nThe point is to make the agent show better evidence before it proposes a diff.\n\nInstead of asking an agent to grep around a repo and hope it finds the right place, Satori gives it a repeatable path:\n\nThat makes the investigation cheaper, more inspectable, and less dependent on dumping entire files into the model.\n\n```\nnpx -y @zokizuan/satori-cli@latest install --client all\nnpx -y @zokizuan/satori-cli@latest doctor\n```\n\nSatori works with Codex, Claude Code, OpenCode, and MCP-compatible clients.\n\nIt is currently **pre-alpha**, and offline support is planned.\n\nWebsite: [https://satori.hamza.my.id/](https://satori.hamza.my.id/)\n\nGitHub: [https://github.com/ham-zax/satori](https://github.com/ham-zax/satori)\n\nnpm: [https://www.npmjs.com/package/@zokizuan/satori-cli](https://www.npmjs.com/package/@zokizuan/satori-cli)\n\nProduct Hunt: [https://www.producthunt.com/products/satori-4?utm_source=other&utm_medium=social](https://www.producthunt.com/products/satori-4?utm_source=other&utm_medium=social)\n\nIf you use coding agents on real repos, I’d love to hear where they usually lose context.\n\nIs it wrong files?\n\nBroad file dumps?\n\nMissed callers?\n\nStale repo state?\n\nOverconfident edits?\n\nAnd if Satori looks useful, a GitHub star, Product Hunt upvote, or comment would really help the launch.", "url": "https://wpnews.pro/news/i-built-satori-a-read-only-codebase-map-for-ai-coding-agents", "canonical_source": "https://dev.to/zokizuan/i-built-satori-a-read-only-codebase-map-for-ai-coding-agents-4061", "published_at": "2026-07-09 13:52:00+00:00", "updated_at": "2026-07-09 14:05:49.730438+00:00", "lang": "en", "topics": ["developer-tools", "ai-agents", "ai-tools", "ai-infrastructure"], "entities": ["Hamza", "Satori", "Codex", "Claude Code", "OpenCode", "MCP"], "alternates": {"html": "https://wpnews.pro/news/i-built-satori-a-read-only-codebase-map-for-ai-coding-agents", "markdown": "https://wpnews.pro/news/i-built-satori-a-read-only-codebase-map-for-ai-coding-agents.md", "text": "https://wpnews.pro/news/i-built-satori-a-read-only-codebase-map-for-ai-coding-agents.txt", "jsonld": "https://wpnews.pro/news/i-built-satori-a-read-only-codebase-map-for-ai-coding-agents.jsonld"}}