Skip to content
@plotwork-official

Plotwork

Beautiful Diagrams for AI Agents

Plotwork

Architecture diagrams that never go stale.

Your AI agent writes a few lines of text. Plotwork draws a clean, on-brand diagram
and redraws it when the code changes.

Website  ·  Quick start  ·  Docs  ·  Pricing  ·  Enterprise

LinkedIn X Bluesky Mastodon Instagram YouTube Facebook Discord

An AI agent writes a few lines of Plotwork text, and Plotwork draws an AWS checkout architecture from them, then the same diagram in other kinds and themes.

Select the film to watch it in full quality.


Contents

The problem

Problem Today
Diagrams drift A picture drawn by hand is out of date by the next release, and nobody knows which one to trust.
Agents cannot draw AI agents write code all day but cannot use a drawing tool, so the diagram is the one part left undone.
Every team draws differently Shapes, colours and icons change from page to page, with no review and no brand.

What Plotwork does

A small text language that agents write well, and an engine that draws it the same way everywhere.

An AI agent, a CI pipeline or an import of source files sends Plotwork text to the engine, which checks, lays out and draws it for the README, Confluence and the team library.

Drawn by Plotwork from 22 lines of text.

Feature What you get
29 kinds of diagram Flow, sequence, database, C4, state, Gantt, mind map, Sankey, Wardley and more.
Drawn from your files Terraform, Bicep, CloudFormation, Pulumi, SQL, Prisma, OpenAPI, Kubernetes, Compose and more.
Over 5,500 icons AWS, Azure, Google Cloud, Kubernetes and the brands your stack uses.
Checked like code Every mistake comes back with a line, a column and a fix, so an agent corrects itself.
Kept in sync CI redraws every diagram on change and fails the build when one is stale.

Start in a minute

MCP server on npm Command line on npm GitHub Action GitLab CI/CD catalog Azure DevOps extension Terraform Registry Self-hosted engine on Docker Hub

With an AI agent (Claude Code shown; Cursor, VS Code and Claude Desktop work too):

claude mcp add plotwork -- npx -y @buun_group/plotwork-mcp

In CI, with the GitHub Action:

- uses: plotwork-official/plotwork-action@v1

From the command line:

npx -y @buun_group/plotwork render architecture.diagram

Repositories

Repository What it is
plotwork-mcp The MCP server for agents, run locally with no account.
plotwork-cli The plotwork command: render, sync Markdown, import files, check in CI.
plotwork-action The GitHub Action that keeps every diagram in a repository current.
plotwork-component The GitLab CI/CD component.
plotwork-azure-devops The Azure Pipelines extension.
plotwork-claude-plugin The Claude Code plugin: draws diagrams as Claude saves files.
terraform-provider-plotwork The Terraform and OpenTofu provider: diagrams that update on every apply.
plotwork-selfhost The engine as one container, for diagram text that must stay inside your network.
plotwork-examples A made-up company's repository, with every workflow wired up.
terraform-plotwork-examples Terraform and OpenTofu examples for the provider.

For teams

Plotwork for organisations adds a shared, private diagram library and the controls a security review asks for.

Control What it does
Your brand Your colours, fonts and icon packs on every diagram.
Approved patterns Reference architectures every team draws the same way.
Sign-in and audit SSO, SCIM, two-step sign-in and an audit log you can stream to your SIEM.
Private by default Diagram source is not stored unless you publish it, and the engine can run on your own servers.

Talk to us about Enterprise


Built by Buun Group.

Popular repositories Loading

  1. plotwork-mcp plotwork-mcp Public

    The official mcp repository for plotwork for local installation

    JavaScript

  2. plotwork-action plotwork-action Public

    The repository used for the official plotwork github actions.

  3. plotwork-cli plotwork-cli Public

    JavaScript

  4. plotwork-examples plotwork-examples Public

    This repository holds examples for our plotwork can generate diagrams and much more

    HCL

  5. plotwork-claude-plugin plotwork-claude-plugin Public

    The Plotwork plugin for Claude Code: the MCP server, a hook that draws diagrams on save, a localhost gallery, and skills.

    JavaScript

  6. plotwork-selfhost plotwork-selfhost Public

    The Plotwork engine as one container: MCP over Streamable HTTP and the drawing API, with no account and no outbound request.

    Go Template

Repositories

Showing 10 of 12 repositories

Top languages

Loading…

Most used topics

Loading…