Diagram

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.