Open source · MIT · macOS, Windows, Linux

A pixel art editor where AI draws live

Ladrilho is a desktop pixel art editor with an MCP server built in. Claude draws in the same document you have open: you watch every step, undo it with Ctrl/Cmd+Z and pause the AI whenever you want. No account, no telemetry.

macOS build available now; Windows and Linux builds come from CI.

// 02 — Live AI

Watch the AI draw, step by step

Ladrilho ships with ladrilho-mcp, an MCP server with 31 tools. Claude creates sprites, sets palettes, draws, adds layers and frames, and looks at the canvas — live, in the app you have open.

A real session

An arcane owl drawn by Claude in Ladrilho, recorded call by call.

An arcane owl appearing step by step as the AI draws it

Step 12 of 12 — AI: review: right-eye highlight and outline AA

MCP calls

  1. status({})
  2. criar_sprite({nome:coruja arcana,largura:48,altura:48})
  3. definir_paleta({cores:[#1a1430,#2b2150,#40337a,#5a4ba0,#7a6cc0,#a294dc,#4a3c5e,#6f5f86],nome:coruja arcana,rotulo:paleta da coruja arcana})
  4. alterar_camada({camada:c1,nome:coruja})
  5. alterar_frame({frame:0,duracao_ms:500})
  6. executar_lote({operacoes:6,rotulo:esboço: cabeça, corpo, asas e penachos})AI: sketch: head, body, wings and ear tufts
  7. ler_pixels({frame:0,formato:hex,regiao:{4}})
  8. ver_canvas({frame:0,escala:6,grade:true})
  9. criar_frame({duplicar_de:0,posicao:1,duracao_ms:500})
  10. executar_lote({operacoes:13,rotulo:blocos de cor})AI: color blocking
  11. ler_pixels({frame:1,formato:hex,regiao:{4}})
  12. ver_canvas({frame:1,escala:6,grade:true})
  13. criar_frame({duplicar_de:1,posicao:2,duracao_ms:500})
  14. criar_camada({nome:galho,posicao:0,rotulo:camada galho})
  15. executar_lote({operacoes:6,rotulo:galho e folhas})AI: branch and leaves
  16. ler_pixels({frame:2,formato:hex,regiao:{4}})
  17. ver_canvas({frame:2,escala:6,grade:true})
  18. criar_frame({duplicar_de:2,posicao:3,duracao_ms:500})
  19. executar_lote({operacoes:1,rotulo:sombras da plumagem})AI: feather shadows
  20. ler_pixels({frame:3,formato:hex,regiao:{4}})
  21. ver_canvas({frame:3,escala:6,grade:true})
  22. criar_frame({duplicar_de:3,posicao:4,duracao_ms:500})
  23. executar_lote({operacoes:1,rotulo:luz do alto à esquerda})AI: light from the top left
  24. ler_pixels({frame:4,formato:hex,regiao:{4}})
  25. ver_canvas({frame:4,escala:6,grade:true})
  26. criar_frame({duplicar_de:4,posicao:5,duracao_ms:500})
  27. executar_lote({operacoes:1,rotulo:textura das penas})AI: feather texture
  28. ler_pixels({frame:5,formato:hex,regiao:{4}})
  29. ver_canvas({frame:5,escala:6,grade:true})
  30. criar_frame({duplicar_de:5,posicao:6,duracao_ms:500})
  31. executar_lote({operacoes:2,rotulo:casca do galho e garras})AI: bark and talons
  32. ler_pixels({frame:6,formato:hex,regiao:{4}})
  33. ver_canvas({frame:6,escala:6,grade:true})
  34. criar_frame({duplicar_de:6,posicao:7,duracao_ms:500})
  35. executar_lote({operacoes:2,rotulo:contorno seletivo})AI: selective outline
  36. ler_pixels({frame:7,formato:hex,regiao:{4}})
  37. ver_canvas({frame:7,escala:6,grade:true})
  38. criar_frame({duplicar_de:7,posicao:8,duracao_ms:500})
  39. executar_lote({operacoes:1,rotulo:olhos âmbar e bico})AI: amber eyes and beak
  40. ler_pixels({frame:8,formato:hex,regiao:{4}})
  41. ver_canvas({frame:8,escala:6,grade:true})
  42. criar_frame({duplicar_de:8,posicao:9,duracao_ms:500})
  43. definir_pixels({camada:coruja,pixels:24,frame:9,rotulo:runas no peito})AI: runes on the chest
  44. ler_pixels({frame:9,formato:hex,regiao:{4}})
  45. ver_canvas({frame:9,escala:6,grade:true})
  46. criar_frame({duplicar_de:9,posicao:10,duracao_ms:500})
  47. criar_camada({nome:magia,posicao:2,rotulo:camada magia})
  48. executar_lote({operacoes:1,rotulo:brilho mágico})AI: magic glow
  49. ler_pixels({frame:10,formato:hex,regiao:{4}})
  50. ver_canvas({frame:10,escala:6,grade:true})
  51. criar_frame({duplicar_de:10,posicao:11,duracao_ms:2000})
  52. ver_canvas({frame:11,regiao:{4},escala:12,grade:true})
  53. executar_lote({operacoes:2,rotulo:revisão: reflexo do olho direito e AA do contorno})AI: review: right-eye highlight and outline AA
  54. ler_pixels({frame:11,formato:hex,regiao:{4}})
  55. ver_canvas({frame:11,escala:6,grade:true})
  56. ver_canvas({frame:0})
  57. ver_canvas({frame:11,onion:true})
  58. exportar({escala:1,sobrescrever:true,formato:folha,disposicao:horizontal,caminho:/Users/gabrielalmeidasantosmelo/projetos/ladrilho-site/public/arte/ia/ia-sessao.png})
  59. exportar({escala:3,sobrescrever:true,formato:gif,caminho:/Users/gabrielalmeidasantosmelo/projetos/ladrilho-site/public/arte/ia/ia-sessao.gif})
  60. salvar({caminho:/Users/gabrielalmeidasantosmelo/projetos/ladrilho-site/public/arte/fontes/ia-sessao.ladrilho,sobrescrever:true})
  61. listar_historico({limite:100})
The Ladrilho canvas with ruler and grid after each AI step
What the AI sees (ver_canvas) — Step 12 of 12
  1. The Ladrilho canvas with ruler and grid after each AI step
    Step 1 of 12executar_lote({ operacoes: 6 (desenhar_forma ×6), rotulo: "esboço: cabeça, corpo, asas e penachos" })AI: sketch: head, body, wings and ear tufts
  2. The Ladrilho canvas with ruler and grid after each AI step
    Step 2 of 12executar_lote({ operacoes: 13 (desenhar_forma ×13), rotulo: "blocos de cor" })AI: color blocking
  3. The Ladrilho canvas with ruler and grid after each AI step
    Step 3 of 12executar_lote({ operacoes: 6 (desenhar_forma ×5, preencher ×1), rotulo: "galho e folhas" })AI: branch and leaves
  4. The Ladrilho canvas with ruler and grid after each AI step
    Step 4 of 12executar_lote({ operacoes: 1 (desenhar_mapa ×1), rotulo: "sombras da plumagem" })AI: feather shadows
  5. The Ladrilho canvas with ruler and grid after each AI step
    Step 5 of 12executar_lote({ operacoes: 1 (desenhar_mapa ×1), rotulo: "luz do alto à esquerda" })AI: light from the top left
  6. The Ladrilho canvas with ruler and grid after each AI step
    Step 6 of 12executar_lote({ operacoes: 1 (desenhar_mapa ×1), rotulo: "textura das penas" })AI: feather texture
  7. The Ladrilho canvas with ruler and grid after each AI step
    Step 7 of 12executar_lote({ operacoes: 2 (desenhar_mapa ×2), rotulo: "casca do galho e garras" })AI: bark and talons
  8. The Ladrilho canvas with ruler and grid after each AI step
    Step 8 of 12executar_lote({ operacoes: 2 (desenhar_mapa ×2), rotulo: "contorno seletivo" })AI: selective outline
  9. The Ladrilho canvas with ruler and grid after each AI step
    Step 9 of 12executar_lote({ operacoes: 1 (desenhar_mapa ×1), rotulo: "olhos âmbar e bico" })AI: amber eyes and beak
  10. The Ladrilho canvas with ruler and grid after each AI step
    Step 10 of 12definir_pixels({ camada: "coruja", pixels: 24, rotulo: "runas no peito" })AI: runes on the chest
  11. The Ladrilho canvas with ruler and grid after each AI step
    Step 11 of 12executar_lote({ operacoes: 1 (desenhar_mapa ×1), rotulo: "brilho mágico" })AI: magic glow
  12. The Ladrilho canvas with ruler and grid after each AI step
    Step 12 of 12executar_lote({ operacoes: 2 (definir_pixels ×2), rotulo: "revisão: reflexo do olho direito e AA do contorno" })AI: review: right-eye highlight and outline AA
An arcane owl appearing step by step as the AI draws it
  • One undo step per call

    Each AI call becomes a single undo step labeled "AI: …". Ctrl/Cmd+Z takes it back.

  • It waits for your stroke

    AI writes queue up and wait until the stroke you are drawing is finished.

  • Pause AI, always visible

    The Pause AI button lives in the status bar. While paused, every write is refused.

  • Opens the app for you

    If Ladrilho is closed, the MCP server launches it and waits until it is ready (up to 30 s).

  • Local only

    The app server listens only on 127.0.0.1, on a random port, with a new Bearer token each run.

  • No arbitrary scripts

    There is no tool to run scripts. The AI can only use the 31 drawing and file tools.

All the tools the AI can use

31 tools

State1

  • statusRead

    App version, AI pause state and open documents

Document5

  • criar_spriteWrite

    Create a new sprite (up to 1024×1024) in a new tab

  • abrir_arquivoWrite

    Open a .ladrilho, PNG or GIF file

  • salvarWrite

    Save the document as .ladrilho

  • listar_documentosRead

    List the open documents

  • ativar_documentoWrite

    Switch to another open document

Palette2

  • definir_paletaWrite

    Set the palette from colors or a Lospec slug

  • ler_paletaRead

    Read the current palette

Drawing8

  • definir_pixelsWrite

    Set individual pixels or horizontal runs

  • desenhar_mapaWrite

    Draw a character map: one letter per color

  • desenhar_formaWrite

    Draw a line, rectangle, ellipse or polygon

  • preencherWrite

    Paint bucket fill, contiguous or global, with tolerance

  • substituir_corWrite

    Replace one color with another in a layer, frame or sprite

  • limparDestructive

    Clear a region or the whole cel

  • transformarWrite

    Flip, rotate or shift pixels

  • colar_imagemWrite

    Paste a PNG at a position, optionally on a new layer

Batch1

  • executar_loteWrite

    Run up to 500 operations as one labeled undo step

Layers4

  • criar_camadaWrite

    Add a layer

  • alterar_camadaWrite

    Rename a layer or change visibility, opacity or lock

  • remover_camadaDestructive

    Delete a layer

  • mover_camadaWrite

    Reorder a layer

Frames3

  • criar_frameWrite

    Add a frame, optionally duplicating another

  • alterar_frameWrite

    Change a frame’s duration

  • remover_frameDestructive

    Delete a frame

Vision3

  • ver_canvasRead

    Get a PNG of the canvas with a ruler, grid and onion skin

  • ler_pixelsRead

    Read pixel colors from a region (up to 64×64)

  • ver_animacaoRead

    Get the frames side by side with their durations

History3

  • desfazerWrite

    Undo the AI’s own steps (never yours)

  • refazerWrite

    Redo the AI’s own undone steps

  • listar_historicoRead

    List the history with labels and authors

Export1

  • exportarWrite

    Export PNG, GIF or sprite sheet, at any integer scale

Connect Claude

Claude Code

bash
claude mcp add ladrilho -- "/Applications/Ladrilho.app/Contents/MacOS/ladrilho-mcp"

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "ladrilho": {
      "command": "/Applications/Ladrilho.app/Contents/MacOS/ladrilho-mcp"
    }
  }
}

The exact path is shown in Preferences › AI › Use with AI, with the commands ready to copy.

Then just ask, for example:

“draw a 16×16 mushroom with the PICO-8 palette in Ladrilho”

Local server security

  • Listens only on 127.0.0.1, on a random port.
  • Requires a Bearer token: 32 random bytes, new on every run, compared in constant time.
  • Rejects any other Host and any Origin header; no CORS.
  • The only network connection is downloading a Lospec palette when you (or the AI) ask for it by name.
Ladrilho while the AI draws a mushroom, with the AI indicator and the Pause AI button
Screenshot of the appLadrilho with the AI drawing, progressive reveal on.

// 03 — Tools

A complete editor, not just an AI trick

The tools you expect, with Aseprite shortcuts by key position — they work the same on any keyboard layout.

  • Pencil demo: a freehand stroke with and without pixel-perfect, the doubled corners disappearing

    Pencil

    Shortcut: B

    Freehand with pixel-perfect: it removes the L-shaped corners from the stroke.

  • Eraser demo: part of a shape being erased to transparency

    Eraser

    Shortcut: E

    Erases to transparency with the same brush sizes as the pencil.

  • Paint bucket demo: a closed shape filling with color

    Paint bucket

    Shortcut: G

    Contiguous or global fill, with tolerance.

  • Line demo: a pixel line drawn between two points

    Line

    Shortcut: L

    Clean pixel lines between two points.

  • Rectangle demo: an outlined rectangle and a filled one

    Rectangle

    Shortcut: U

    Outline or filled.

  • Ellipse demo: an ellipse drawn from corner to corner

    Ellipse

    Shortcut: ShiftU

    Outline or filled, symmetric at any size.

  • Eyedropper demo: a color picked from the canvas and the swatch changing

    Eyedropper

    Shortcut: I

    Picks a color from the canvas. Hold Alt for a quick pick.

  • Marquee demo: a mushroom selected with marching ants and moved as a floating selection

    Rectangular marquee

    Shortcut: M

    Select, move and paste as a floating selection.

  • Flip demo: a goldfish sprite flipped horizontally with Shift+H

    Flip

    Shortcut: ShiftH

    Flip, rotate or shift the selection or the layer.

And more

  • Square or round brush from 1 to 64 px
  • Left button = primary color, right button = secondary
  • Bucket tolerance and global mode
  • Pixel-perfect strokes
  • Floating paste you can move before applying
  • Canvas size and sprite size

// 04 — Animation

Frames, timing and onion skin

Animate with a timeline where each frame has its own duration, check the motion with onion skin and preview it in a loop.

Small adventurer with a cape running in a looping 8-frame cycle
A run cycle in 8 frames, drawn in Ladrilho.
  • Timeline with a duration per frame
  • Onion skin (F3) with previous and next frames
  • Looping preview
  • Export animated GIF or a sprite sheet
  • Layers with opacity, visibility and lock
Ladrilho canvas showing a run cycle frame with the previous and next frames as onion skin
Screenshot of the appOnion skin on frame 4 of the run cycle (ver_canvas).
The 8 frames of the run cycle side by side, each with its index and duration
Screenshot of the appThe frames of the run cycle with their durations (ver_animacao).

// 05 — Color

Palettes and dithering

Built-in palettes, Lospec palettes by name, replace color, and ordered dithering aligned to the sprite grid.

The same scene, six palettes

One cottage in the woods, recolored with the built-in palettes using substituir_cor.

  • Download any palette from Lospec by its slug.
  • Import and export .gpl, .pal and .hex palettes.
  • HSV, RGB and hex color picker with alpha.

A cottage in the woods shown in six palettes: original, PICO-8, DB32, Endesga 32, Sweetie 16 and Game Boy

  • Original
  • PICO-8
  • DB32
  • Endesga 32
  • Sweetie 16
  • Game Boy

Flat or dithered

Ordered dithering between the primary and secondary colors: checker, Bayer 2×2, 4×4 or 8×8, level 0–100%.

The same sunset sky with a moon, shown flat and with checker, Bayer 4×4 and Bayer 8×8 dithering

  • Flat
  • Checker
  • Bayer 4×4
  • Bayer 8×8

// 06 — Formats

Open files, standard exports

Your work is saved in an open format and exported to what games and engines expect.

Gold coin spinning
The coin’s real sprite sheet, as exported by Ladrilho: 8 frames side by side.
  • PNG

    Current frame or a numbered sequence, at any integer scale up to 20×.

  • Animated GIF

    Each frame keeps its own duration.

  • Sprite sheet

    Horizontal or grid, with a JSON atlas in the Aseprite format.

  • Import PNG and GIF

    Bring existing images in to keep working.

  • Autosave

    Silent autosave with recovery after a crash, plus tabs and recent files.

The Ladrilho editor in the dark theme with a 32×32 smiley sprite, tools, palette, layers and timeline
Screenshot of the appThe Ladrilho editor with a 32×32 sprite, dark theme.
Main shortcuts
Pencil / eraser / paint bucketB/E/G
Line / rectangle / ellipseL/U/Shift+U
EyedropperI/Alt(hold)
Marquee / moveM/V
HandH/Space(hold)
Zoom 100–3200% / fit1–6/Mod+0
New frame / new layerAlt+N/Shift+N
Onion skinF3
Next region (keyboard)F6
Undo / redoMod+Z/Mod+Shift+Z
Save / save asMod+S/Mod+Shift+S
ExportMod+Shift+Alt+S
Swap primary and secondaryX
Previous / next color[/]
Play animationEnter
Previous / next frame←/→
Show/hide the timelineTab
PreferencesMod+,
Full shortcut listMod+Shift+Alt+K

Mod = Cmd on macOS, Ctrl elsewhere. Aseprite profile, by key position.

// 07 — Compare

How it compares, honestly

Ladrilho is new. Here is where it stands next to the editors people already use.

Ladrilho compared with Aseprite, Pixelorama, LibreSprite and Piskel
FeatureLadrilhoAsepritePixeloramaLibreSpritePiskel
Open source and freeYesNoSource available under a proprietary EULA; paidYesYesYes
macOS, Windows and LinuxYesmacOS build now; Windows and Linux from CIYesYesYesYesWeb, plus a desktop build (NW.js)
Live MCP built inYesPartialWith a third-party extension connected by handNoNoNo
MCP opens the app by itselfYesNoNoNoNo
Labeled undo step per AI callYesPartialWith a third-party extension connected by handNoNoNo
Pause AI buttonYesNoNoNoNo
Pixel-perfect strokesYesYesYesYesNot confirmed
DitheringYesOrdered dithering (checker, Bayer)YesYesNot confirmedYes
Onion skinYesYesYesYesYes
Sprite sheet exportYesYesYesYesYes
TilemapsOn the roadmapYesYesNoNo
Indexed color modeOn the roadmapYesYesYesNo
ScriptingOn the roadmapYesYesYesNo
.aseprite filesOn the roadmapYesYesPartialPartial import; exportsNo

Need tilemaps, indexed color or scripting today? Aseprite or Pixelorama are the better choice right now.

Source: Ladrilho market research of , with links to every claim. (opens in a new tab)

// 08 — Open source

MIT, in the open

The code, the specs and the plan are public. Read them, open an issue, send a pull request.

On the roadmap

  • Elliptical, lasso and magic wand selection
  • Symmetry
  • Tile mode
  • Indexed color mode
  • Animation tags (forward, reverse, ping-pong)
  • Import and export .aseprite
  • Tilemaps
  • Scripting
Small village built only from the tileset: a log cabin with lit windows, a river with a wooden bridge, a dirt road, a fence, a well and stone walls

Credits

  • Pixelify Sans — SIL Open Font License.
  • Geist and Geist Mono — SIL Open Font License.
  • Shortcuts and behavior inspired by Aseprite; no Aseprite code was used.
  • All the pixel art on this page was drawn by Claude in Ladrilho, through MCP.

// 09 — Download

Get Ladrilho

Free and open source. Pick your platform, or build it from the source.

  • Available

    macOS (Apple Silicon)

    Development .dmg with an ad-hoc signature. The first time, right-click the app › Open.

The macOS build is not notarized. If macOS blocks it, remove the quarantine flag:

bash
xattr -dr com.apple.quarantine /Applications/Ladrilho.app

From the source

Requires Node 22, stable Rust and, on Linux, WebKitGTK 4.1.

bash
npm ci
npm run tauri dev