crsolver/claude-pxl

选用指南

AI 根据 README 整理 · 2026/10/15 23:36:41

适用场景

适用于通过代码生成像素画、精灵表、动画 GIF，并可在浏览器中实时预览绘制过程。

查看 README 依据

# pxl **Pixel art as code.** Write a compact `.px.js` file; get PNGs, sprite sheets with JSON, animated GIFs, and a live browser viewer that replays the painting step by step as you save. Built for AI agents (it ships as a ready-made [agent skill](#use-it-with-an-ai-agent)) and pleasant for people too. No runtime dependencies, no build step: just Node ≥ 22.18. <p> <img src="docs/gallery/no_magic_night.gif" width="100%" alt="Animated witch's cottage at night: bubbling cauldron, fireplace, cat and frog"> </p> <p>

`pxl serve art.px.js` opens a viewer that rebuilds on every save and replays the asset you edited op by op, so you (or whoever is watching an agent work) can see the art being painted. It also writes the same `out/` files as `build`. ## Commands ``` pxl build <art.px.js> [--out DIR] [--only a,b] [--scale N] [--no-preview] pxl serve <art.px.js> [--port 4321] [--out DIR | --no-out] [--no-preview] pxl ascii <art.px.js> <name> print an asset as palette keys with x/y rulers pxl list <art.px.js> list assets, groups and sheets with source locations ```

目标用户

为 AI 代理设计，也适合人类用户。

查看 README 依据

# pxl **Pixel art as code.** Write a compact `.px.js` file; get PNGs, sprite sheets with JSON, animated GIFs, and a live browser viewer that replays the painting step by step as you save. Built for AI agents (it ships as a ready-made [agent skill](#use-it-with-an-ai-agent)) and pleasant for people too. No runtime dependencies, no build step: just Node ≥ 22.18. <p> <img src="docs/gallery/no_magic_night.gif" width="100%" alt="Animated witch's cottage at night: bubbling cauldron, fireplace, cat and frog"> </p> <p>

使用方式

通过命令行使用，提供 build、serve、ascii、list 等命令，支持 .js 或 .ts 文件。

查看 README 依据

`pxl serve art.px.js` opens a viewer that rebuilds on every save and replays the asset you edited op by op, so you (or whoever is watching an agent work) can see the art being painted. It also writes the same `out/` files as `build`. ## Commands ``` pxl build <art.px.js> [--out DIR] [--only a,b] [--scale N] [--no-preview] pxl serve <art.px.js> [--port 4321] [--out DIR | --no-out] [--no-preview] pxl ascii <art.px.js> <name> print an asset as palette keys with x/y rulers pxl list <art.px.js> list assets, groups and sheets with source locations ```

`pxl` means `node bin/pxl.js` in a clone, or `npx github:crsolver/claude-pxl`. Art files can be `.js` or `.ts` (`types/pxl.d.ts` gives editor completion). ## What's in the DSL - **Palettes and ramps**: one-character color keys, built-in palettes (pico8, sweetie16, endesga32…), dark→light ramps that drive `shade()` / `light()`. - **Sprites**: text grids, mirroring, auto-outline, palette-swap variants, flips/rotations, reusable `_parts`, `stamp`. - **Primitives and brushes**: rects, lines, circles, polygons, gradients, dithering, noise, a built-in

部署要求

需要 Node.js 22.18 或更高版本，无运行时依赖。

查看 README 依据

# pxl **Pixel art as code.** Write a compact `.px.js` file; get PNGs, sprite sheets with JSON, animated GIFs, and a live browser viewer that replays the painting step by step as you save. Built for AI agents (it ships as a ready-made [agent skill](#use-it-with-an-ai-agent)) and pleasant for people too. No runtime dependencies, no build step: just Node ≥ 22.18. <p> <img src="docs/gallery/no_magic_night.gif" width="100%" alt="Animated witch's cottage at night: bubbling cauldron, fireplace, cat and frog"> </p> <p>