# Kuuhaku

> Kuuhaku reads a system's repositories and maps how they talk to each other: HTTP calls matched to the routes they reach, gRPC, message queues, WebSockets and shared databases. Every connection carries its evidence, the file and line on both sides, and a tier: config, inferred, declared or observed. No confidence percentages.

- The scanner is static analysis (tree-sitter and per-framework readers), deterministic, with no LLM in it. It reads Node and TypeScript (Express, Fastify, NestJS, Next.js), Vue and React, Flutter and Dart, Java and Kotlin (Spring Boot, Quarkus, Jakarta EE), Python (FastAPI, Django, Flask), Go, C# (ASP.NET Core), Rust, PHP and Ruby, plus nginx, Envoy, Spring Cloud Gateway and Zuul routing.
- The CLI runs where the code is: `npx kuuhaku scan .` reads the repos on your machine and uploads only the graph (names, files, lines, env key names without values). Hosted scans of GitHub and Bitbucket repos clone with a read-only key and delete the checkout when the scan ends.
- On top of the map: a page per repo, a review inbox for what the scanner could not settle, a pull-request check on GitHub and Bitbucket ("this PR removes PUT /devices/:id, which web calls at src/api.js:42"), a personal-data map, an MCP server (`npx kuuhaku mcp`) so coding assistants can ask what depends on a route, and exports to Mermaid, C4 (Structurizr), Backstage, architecture.yaml and a PDF report.
- Accuracy is measured on public systems with hand-checked answer keys: connections at F1 97%.
- Pricing: free in early access until 14 November 2026, then $9, $29 or $79 a month per organization, priced by repos; seats are free.

## Pages

- [Home](https://kuuhaku.dev/): what Kuuhaku does
- [Public maps](https://kuuhaku.dev/maps/): nine open-source microservice systems mapped from their code, service by service
- [Supported stacks](https://kuuhaku.dev/stacks.html): what the scanner reads in each language, cell by cell
- [Command line](https://kuuhaku.dev/cli.html): the `kuuhaku` CLI and its commands
- [Security](https://kuuhaku.dev/security.html): what leaves your machine and what does not
- [Pricing](https://kuuhaku.dev/pricing.html)
- [Privacy](https://kuuhaku.dev/privacy.html)
- [Terms](https://kuuhaku.dev/terms.html)

## Live examples, no account needed

- [OpenTelemetry Demo](https://kuuhaku.dev/maps/otel-demo.html)
- [Train Ticket](https://kuuhaku.dev/maps/train-ticket.html)
- [Online Boutique](https://kuuhaku.dev/maps/online-boutique.html)
- [eShop](https://kuuhaku.dev/maps/eshop.html)
- [Robot Shop](https://kuuhaku.dev/maps/robot-shop.html)
- [Sock Shop](https://kuuhaku.dev/maps/sock-shop.html)
- [Bank of Anthos](https://kuuhaku.dev/maps/bank-of-anthos.html)
- [Quarkus Super Heroes](https://kuuhaku.dev/maps/quarkus-super-heroes.html)
- [Spring PetClinic Microservices](https://kuuhaku.dev/maps/spring-petclinic-microservices.html)

## Optional

- [npm package](https://www.npmjs.com/package/kuuhaku): the CLI and the MCP server
- [App](https://app.kuuhaku.dev/): sign in or start free