Playbooks · Everyday tasks
Klad: you and your agent edit the same brush stroke
Written November 12, 2026
Klad lets AI coding agents and humans edit the same individual brush strokes in a drawing. An odd, concrete answer to who holds the pencil.
Paint, not pixels
An image generator hands you a finished picture, and the only edit on offer is another roll of the dice. Klad is a 2D painting and animation app built the other way round. There is no image model in it. You paint in the editor with a pen; your coding agent — Claude Code, Codex, or anything that can run commands — paints through the klad command line, with the same brushes, on the same drawing. Each of you sees the other's strokes land, in about a second. Whatever either of you puts down stays what it was: a stroke with its path, pressure, brush, and colour, a shape with its points, a fill with its region. Hours later, any single stroke — yours or the agent's — can be recoloured, bent, moved, or deleted on its own.
The repository's worked example shows the shape of the collaboration. Asked for a small sprout creature for a game, the agent paints 4,344 strokes and fills. The human then recolours the leaves, bends the mouth into a smile, moves a smudge, and blends the blush. After that, the agent groups the creature's parts into five groups and animates it with 205 keys, and no frame has to be painted again.
How the two of you work
The loop the README describes is simple. Ask in plain words — a lantern for the inn, lit from the left, on its own layer. Watch the strokes appear in your editor. Point at what you mean by pinning a note on the canvas or selecting a part; the agent reads both. Then take over whenever you like: repaint anything by hand, including the agent's strokes. The agent's strokes are marked as its own, and every change from either side is one step in a shared history, so any of it can be undone.
Three printed skills teach the agent the job. Running klad skill prints how to look at a drawing, change it, and judge the result; klad skill drawing covers the craft of planning a picture, light, values, and colour; klad skill pixel does the same for pixel art. The skills are released under the MIT licence and can be used with any agent and any tool.
The drawing is data
Everything the editor can do has a command-line equivalent, so a script or an agent works on the same drawing you have open. An agent can lay a stroke with klad stroke, read the strokes on a layer back as JSON, change one stroke by its address with klad set, fill against a lines layer, read your notes and selection, generate in-between drawings, and export — including straight into Godot as a SpriteFrames scene. A drawing itself is a folder of plain files on your own computer, an edit changes only the files of the thing edited, and the format is documented down to the byte. Klad needs no account.
Around that core sits a full painting app: two dozen brushes and a brush editor, layers, masks, clipping, effects, a timeline with onion skins and clips, bones with inverse kinematics, and exports as PNGs, sprite sheets, or Godot scenes. It is aimed squarely at game work — props, characters, backgrounds, and frame-by-frame animation.
The licence, stated plainly
Klad is source-available, not open source. The app is under the PolyForm Internal Use License 1.0.0, with added permissions: free to build and use for yourself, and inside a company with less than 500,000 euros a year in revenue. A company at or above that line needs a bought licence for each person who uses it, and the app may not be distributed, from source or as a build. The file format, the command reference, the agent skills, and the klad-client crate are the exceptions — those are MIT, so other programs can read and write Klad drawings freely.
What is rough
- It is early, and you build it yourself. There are no installers yet; the first build takes about ten minutes, and signed builds are planned. The repository calls this the first public version.
- The editor is made on a Mac, where pen pressure and tilt work. It builds and passes its tests on Linux and Windows; on Linux you draw with the mouse for now, and nobody has drawn with it on Windows yet.
- Some illustration basics are missing: selecting several shapes at once, align and distribute, snapping, a grid, and SVG import and export. Bones are a preview, and their commands may still change.
- What an agent paints depends on the agent and on how much you steer it. Klad gives the agent real brushes; it does not give it taste.
Related playbooks
- A human-agent team ran X-ray experiments you can audit
- Let the household vote on dinners, with a shared note and no app
- Chase an unpaid invoice with an agent
- Claude Duet: Anthropic's proactive agent app
Sources
- klad — a drawing app built for agent and human collaboration — GitHub — the shared-stroke design, the commands and skills, the worked example, and the licence.
Back to: Everyday playbooks hub · Also: Addy Osmani's 25 agent skills for coding agents · A human-agent team ran X-ray experiments you can audit · Chrome's modern-web-guidance: skills for your agent