Graphlin

Live architecture diagrams while Claude Code or Codex explores and builds your code.

Get started

You need: macOS or Linux, Node.js 22.14+, and Claude Code or Codex CLI. Local parsing needs no key. Optional AI classification uses a TypeSafe API key.

1. Start the viewer

In your project's terminal:

npx --yes graphlin@latest

Graphlin asks which host to install, offers local, source, or metadata mode for this project, and accepts your key at a masked prompt if needed. It stores the key privately and builds stable plugins outside the npm cache. The browser opens automatically. Keep this terminal running; Ctrl+C stops the viewer.

Source mode permits locally filtered source excerpts, user prompts, and public agent messages to be sent to TypeSafe for classification. Local mode parses JavaScript, TypeScript, TSX, and Python on your machine.

2. Start your agent

Open a second terminal in the same project. Choose one:

Claude Code

claude

Codex

codex

Accept the host's project trust prompt. In Claude, use /plugin to confirm Graphlin is enabled. In Codex, use /hooks to review and trust Graphlin's hooks. Start a new agent session after installation. Then ask either agent:

Orient yourself in this project: read its main files and explain how the components connect.

Watch the diagram populate as it explores. On later runs, repeat step 1 and launch your agent; Graphlin reuses the saved setup. Use the printed agent command if you selected a custom data directory.

For setup alone, append init to the command. Append uninstall to remove Graphlin's host plugins across projects while keeping your saved key and history.

Choose Code, nested Blocks, C4, Changes, or Activity timeline. Search with /, expand a source scope, or set a task baseline. Architecture documents are optional; uncertain boundaries stay marked as unknown.

Build another view with the visualizer SDK. Install it with npx graphlin extensions add package-name@version, then approve its project access in the viewer.

Just looking?

Try the offline demo—no key or agent required:

npx --yes graphlin@latest demo

More

User guide · Views · Design · Contributing · Releasing · MIT license

Graphlin visualizes observable actions and code evidence. It does not capture private reasoning or prove runtime connectivity. Development preview.