beautiful ascii diagrams

A macOS-native ASCII diagram editor with an agent skill. Let Codex or Claude generate your diagrams, then refine them on a visual canvas.

Download for Mac View on GitHub

jump to quickstart

From Prompt to Canvas

/draw

Skill Examples

The unified skill spans structural diagrams, process flow, metric comparison, and small terminal art without switching tools or modes.

components

Map internal structure, service boundaries, and dependencies.

/draw a component diagram for a search node with client traffic, planning modules, segment stores, shared cache, and object storage


      ╭────────╮
      │ Client │
      ╰────┬───╯
╔══════════╪═══════════════════════════════════════╗
║          │                                       ║░
║     ╭────▼───╮    ╭──────────╮     ╭────────╮    ║░
║     │  API   ├────▶ Planner  ├─────▶ Router │    ║░
║     ╰────┬───╯    ╰─────┬────╯     ╰────┬───╯    ║░
║          └──┐          ┌┘         ┌─────┘        ║░
║             │          │          │              ║░
║         ┌───▼──┐   ┌───▼──┐   ┌───▼──┐           ║░
║         │██████│   │██████│   │██████│           ║░
║         └──────┘   └──────┘   └──────┘           ║░
║          seg A      seg B      seg C             ║░
║                                                  ║░
╚════════════════shared cache══════════════════════╝░
 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░

bar chart

Compare categories, rankings, or before-and-after metrics.

/draw a stacked bar chart of traffic mix by endpoint for search, checkout, and auth with read, write, and cache miss segments


  ┌────────────────────────┐
  │Traffic mix by endpoint │
  ├────────────────────────┴─────────────────────────────────┐
  │ search    ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒░░░░░░      320 rps  │
  │ checkout  ▓▓▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒░░░░░░░░    280 rps  │
  │ auth      ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒░░░░        240 rps  │
  │                                                          │
  └─▓ read   ▒ write   ░ cache miss──────────────────────────┘

ascii drawing

Create title art, mascots, and small terminal-friendly illustrations.

/draw a small cute robot as ASCII art with a square head, bright eyes, tiny arms, little legs, and a friendly expression


           ●
           │
     ╭─────┴────╮
     │  ^   ^   │
     │    -     │
     ╰──────────╯
     ╭───────────╮
     │           │
╭──╮ │  ♥ BEEP   │ ╭──╮
│o=│ │  BOOP! ♥  │ │=o│
╰──╯ │           │ ╰──╯
     ╰─┬──┬─┬──┬─╯
       │| │ │| │
       └──┘ └──┘

flow chart

Show ordered steps, branching, retries, and workflow state changes.

/draw a flow chart for request validation, retry on fix, then processing and done





  ╭─────────╮       ╭──────────╮       ╭─────────╮       ╭──────╮
  │ Request ├───────▶ Validate ├──ok───▶ Process ├───────▶ Done │
  ╰─────────╯       ╰─────┬────╯       ╰────▲────╯       ╰──────╯
                          │                 │
                        fix                 │
                        │                   │
                        │                   │
                    ╭───▼───╮               │
                    │ Retry ├───────────────┘
                    ╰───────╯

Why It Feels So Good

.txt .png .svg

Multiple Export Formats

Export as plain ASCII text, PNG, or SVG. You can also copy diagrams straight to your clipboard.

▦ ▥ ▤

Layers & Grouping

Organize shapes with a hierarchical layer panel. Toggle visibility, lock layers, reorder with drag-and-drop, and group with ⌘G.

DSL ↔ ASCII

Token-Friendly DSL

A lightweight, human-readable language for describing diagrams. Token-efficient and easy for LLMs to generate.

⌘ ⌥ ⇧

Native macOS

Built with SwiftUI. Fast, lightweight, and feels right at home on your Mac.

quickstart

Get Running

1.

Download YuzuDraw
Download for Mac
2.
Install the CLI + skill
```
curl -fsSL https://www.yuzudraw.com/install.sh | sh
```
3.
Prompt your agent
```
/draw a cute robot ascii art
```

Refine it on the canvas

Open the generated .yuzudraw file in the app and keep editing visually.

♥ Sponsor YuzuDraw

Sponsorship helps cover ongoing development and the Apple Developer membership for releases.