tuongaz/seeflow repository overview

⁠SeeFlow

Turn your static system architecture into a live control panel wired directly to your running application. Click a node, fire a real request, watch downstream services light up as your app emits events back.

⁠Why

• Diagram drift — Confluence pages go stale. SeeFlow breaks loudly when your actual system changes.
• Onboarding friction — New engineers click through a live flow instead of reading six-month-old docs.
• Demo tedium — Script it once, replay it flawlessly. No more manually clicking through microservices for stakeholders.

⁠Quick Start

docker run --rm -it -p 4321:4321 -v $(pwd):/workspace tuongaz/seeflow

Then open http://localhost:4321⁠.

The studio scans /workspace/.seeflow/seeflow.json on start and auto-registers that flow if present.

⁠Configuration

Runtime environment variables:

⁠Bake demos into a derived image

Ship a container that already contains your flow:

FROM tuongaz/seeflow
COPY ./my-demos /workspace

docker build -t my-flow .
docker run --rm -it -p 4321:4321 my-flow

⁠Tags

• :latest — newest stable release
• :<version> — pinned release (e.g. :0.1.18)
• :<major>.<minor> — latest patch on a minor line (e.g. :0.1)

⁠Generate flows with AI

SeeFlow ships with a Claude Code / Cursor / Codex / Windsurf plugin that reads your codebase, understands your architecture, and generates the diagram and request scripts automatically.

Install the plugin and run:

/seeflow show me the shopping cart feature

It scans your routes and database connections, writes seeflow.json, wires up demo scripts, and opens the canvas.

Full installation instructions: https://github.com/tuongaz/seeflow⁠