Diagram
← How to make diagrams with AI

How to make diagrams in Gemini CLI

Ask Gemini CLI (Google’s coding agent in the terminal) for a diagram in plain words and it draws one. On its own, the result stays in the chat or in a file only you can open. Connect Diagram once, and every diagram Gemini CLI makes is saved at a link you can share, which stays current as the diagram changes. It takes three steps.

1. Connect Diagram to Gemini CLI

Run this in a terminal, in your repo. It connects Diagram and starts Gemini CLI:

gemini mcp remove -s user diagram ; gemini mcp add -s user --transport http diagram https://diagram.la/mcp ; gemini -i "Set up Diagram for this repo, then ask me what to draw. If you don't have the Diagram tools, tell me the connection didn't work."

Sign in once: When Gemini first connects, a browser tab opens: sign in to Diagram and click Allow.

2. Ask Gemini CLI for a diagram

In Gemini CLI, then describe what you want in plain words. For example:

Gemini CLI draws it, saves it to Diagram as a draft only you can see, and gives you a link. Keep the link open: when you ask for a change, the page updates by itself. Nothing is left in a local file you’d have to remember to upload, and you never have to mention Diagram again: it knows to use it.

3. Publish it and share the link

When it looks right, tell Gemini CLI to publish it. It asks first and says who will be able to see it: the people on its project. Then paste the link in Slack, a pull request, or a doc. To change it later, ask Gemini CLI: the link stays the same and every version is kept.

The kind of thing you can ask for:

Org chart · Nord

Who does what at a small studio

Teams, roles, who to ask.

MayaFounder JonDesign PriyaClients SamEngineering 2 designers2 engineers MayaFounder JonDesign PriyaClients SamCode 2 designers2 engineers

Questions

Can Gemini CLI make diagrams?
Yes. Gemini CLI can draw flowcharts, architecture diagrams, org charts, timelines, and more as a web page. Connected to Diagram, it saves each one at a link you can open and share.
Is Diagram free to use with Gemini CLI?
Yes. Diagram is free for your first 5 diagrams, and there's nothing to install.
Who can see my diagrams?
A new diagram is a draft only you can see. When you say to publish it, the people on its project can see it. You can also add people, share with your team through an org, or make one diagram public for anyone with the link.
What happens when the diagram changes?
Ask Gemini CLI to change it. The change is saved at the same link, and every earlier version is kept.
Does Gemini CLI need an API key?
No. Gemini CLI signs in to Diagram in the browser (Google or an emailed link).

Diagrams in other tools