pixling 0.1.1

The pixel artist for your coding agent.
Pipelines, styles and taste for making game sprites with code. Works with Claude Code, Codex and Cursor.
pixling.dev

Coding agents can write your game, but they can't draw. pixling gives them pipelines that render real pixel art from code, curated styles that ship with how they were made, and the taste rules behind them. The agent writes a spec, builds it, looks at the result and iterates, the way it does with a failing test.

Install

uv tool install pixling        # or: pipx install pixling   ·   or: npx pixling
pixling agent install .        # in your game repo: adds the skill and an AGENTS.md block

Then ask your agent:

make a harbour town in the vista style, with lamps that light up at dusk, into assets/maps

Quickstart

pixling new house_5 inn          # start a spec from an example -> specs/inn.json
pixling build specs/inn.json     # -> out/inn/: sprite sheets, GIFs, JSON
pixling review out/inn           # a zoomed sheet to judge by eye
pixling                          # every command; each takes -h, the ones agents parse take --json

Pipelines

pixling pipelines NAME shows each one's steps, code and lessons. Output is engine-ready: sheets, GIFs, JSON metadata, .aseprite files, and for maps collision, depth and light layers.

Styles

Three launch styles, each with its own hand (camera, shading, line, shadows) and kit. pixling styles NAME --how shows how each was made.

Vista	Crisp Tactics	Flat Minimal
painted aerial towns and world maps	exact isometric, flat faces, soft line	exact isometric, two hues, long flat shadows

Everything above is rendered by the engine. Units and creatures for these boards are block tokens (pixling blocks): a few voxels in the board's own iso, light and shadow.

Docs

• docs/PIPELINES.md: every pipeline, step by step
• docs/ARTIST.md: the spec format and design rules
• docs/STYLES.md: the styles and how a new one is made
• docs/ENVIRONMENTS.md: living maps

The same docs are built into the CLI: pixling guide.

Develop

git clone https://github.com/trinity-works/pixling && cd pixling
pip install -e .
python3 -m unittest discover -s tests     # the video tests need ffmpeg

Rules for agents working on the engine are in AGENTS.md. Issues and pull requests are welcome.

License

MIT. Fonts in docs/brand/fonts and site/fonts are under the SIL Open Font License: wordmark in Jersey 15 by the Soft Type Project, tagline in Departure Mono by Helena Zhang, site in Geist.