flowmap-scan

Scan a TypeScript/JavaScript codebase into a Flowmap architecture map — endpoints, call graph, databases — and publish it to your Flowmap project.

npx flowmap-scan ./src

Produces .flowmap/state.yaml. Signed in, it also fills in missing function descriptions with AI and publishes the map to flow-map.link, where your whole team's AIs read and enrich the same shared context over MCP.

Without a login it still works — you get the structural scan as a local .flowmap/state.yaml, which you can drag into your project on the site.

Usage

npx flowmap-scan login          # once — device-code sign-in, no password
npx flowmap-scan ./src          # scan + AI descriptions + publish
npx flowmap-scan whoami         # current user + AI credit balance

Options

| Flag | Meaning | | --- | --- | | --out <path> | Output path (default .flowmap/state.yaml) | | --no-ai | Raw structural scan — skip AI descriptions | | --no-push | Don't upload; leave the scan as a local file | | --full | Full re-scan: replaces the project on the server, wiping accumulated context (decisions / notes / known-issues) | | --project-id <id> | Project id (default: slugified package.json#name) | | --project-name <str> | Human project name |

A normal re-scan updates the code structure but keeps everything you and your AI have accumulated about the codebase. Only --full discards it.

Learn more at https://flow-map.link