Mapo

A live map of your codebase — for you and for your AI agent.

Website · Download · brew install --cask bur2ak/tap/mapo

Mapo is a native macOS app that turns a project into a map you can read at a glance: every ring is a folder, every circle a file, and the functions live inside them. Click anything to see what it uses and what uses it — across the mobile app, the API and the database.

Why

• See how a request travels. Mapo connects client calls to the server routes they hit and to the tables those routes read and write: placeOrder → POST /api/orders → saveOrder → order_items.
• Know what breaks before you change it. Impact lists everything that depends on a file or function, ring by ring. Find path shows how any two pieces are connected.
• Give your agent the same map. Claude Code, Codex, Cursor and Claude Desktop connect in one click (MCP). They can ask "who calls this?", "what does this endpoint touch?", "what's affected if this changes?" instead of grepping.
• Always current, always local. The map updates when you save, commit or switch branches. Analysis runs entirely on your Mac — no account, no upload, no telemetry.

What it understands

Languages	TypeScript, JavaScript, Python, Swift, Go, Rust, Java, Kotlin and more (via graphify)
HTTP	Hono, Express, Fastify, Koa, Elysia, Next.js route handlers, Cloudflare Workers (incl. service bindings), FastAPI, Flask, Django; clients via fetch, axios, ky, your own get/post wrappers, requests, httpx
RPC	tRPC routers and useQuery / useMutation calls
Databases	SQL migrations (Postgres, SQLite, D1), Prisma, Drizzle, Supabase

Cross-boundary links are inferred from code patterns and marked as such; click through to the source to confirm.

Install

Download the latest .dmg from Releases, or with Homebrew:

brew install --cask bur2ak/tap/mapo

Requires macOS 14 or later on Apple silicon. Mapo updates itself (Sparkle). On first launch, open the sample project to see what it does in ten seconds.

Keyboard

⌘K	Search
⌘[ / ⌘]	Back / forward
⌘↑	Go up (function → file → folder)
⇧⌘P	Find path from the selection
⇧⌘I	Show impact
⇧⌘M	Copy as Mermaid
⌘1 / ⌘2	Files / Code

Build from source

macOS 14+, Xcode 16+, XcodeGen, Node 20+.

bash scripts/build-engine.sh                 # bundled analysis engine
(cd Map && npm ci && npm run build)          # the map (TypeScript)
xcodegen generate && open Mapo.xcodeproj
swift test --package-path Packages/MapoCore

Folder
App/	SwiftUI app
Packages/MapoCore/	graph model, search, queries, HTTP/SQL bridges, MCP server (UI-free, tested)
Map/	the map: circle packing on Canvas (d3-hierarchy)
Sample/CoffeeShop/	the sample project shipped in the app
docs/	plan, design language, decision log (Turkish)

Feedback

Help › Send Feedback… in the app, or open an issue.

License

Apache-2.0. Code analysis is built on graphify (Apache-2.0 / MIT). Third-party notices ship inside the app (About › Third-Party Licenses).