Getting started: share AI-drawn diagrams by link

Diagram gives the diagrams your AI tools draw a home: a link you can share that updates whenever the diagram does.

1. Sign in

Sign in with any Google account. If you're setting up a specific repo, create a new project for it first; its page walks you through the rest.

2. Paste one thing into your AI tool

Pick the AI you use on the setup page. It shows exactly what to copy:

• Claude Code, Codex, Gemini CLI: one command to run in your repo. It connects Diagram and starts the agent, which sets the repo up and asks what you'd like drawn.
• Cursor, VS Code, Windsurf, Zed, JetBrains, and others: connect Diagram once, with one click or one pasted snippet.
• Claude, ChatGPT, Le Chat, Perplexity: add Diagram as a connector once by pasting one URL into the app's settings.

After that there's nothing else to paste. Diagram teaches your AI how it works, and the first request in a repo sets up a diagrams/ folder.

The connection contains your API key, so don't share it or show it on a screen share.

3. Ask for a diagram

Just describe what you want:

Draw how a request flows through this app, from the browser to the database.

Make a diagram of our data model and share it with [email protected].

Update the architecture diagram now that we've added the job queue.

Your tool draws it, publishes it, and gives you the link. New diagrams are private to you. See Ideas and examples for more to ask for.

How it's organized

• Projects group diagrams, usually one per repo.
• Every diagram has one link. Updating it keeps the link and saves the old version.
• In a repo, diagram files live in a diagrams/ folder, so they're versioned with your code.
• Sharing is up to you: keep a diagram private, add people by email, share with your org, or make it public. See Sharing and privacy.