Getting started: share AI-drawn diagrams by link
Diagram hosts the diagrams Claude, ChatGPT, Codex, and Cursor draw at a private link that always shows the latest version. Sign in, paste one thing into your AI tool, and ask for a diagram.
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 Google or any email address. 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 it up.
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, saves it, and gives you the link. Only you can see it. In a project your team shares, it starts as a draft; say "publish it" when you want them to see it. 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, diagrams still live on Diagram, so nothing is stuck on one computer. Ask your AI to keep copies in a
diagrams/folder if you want them 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.