Coding agents
glyphcss ships a skill so AI coding agents — Claude Code, Cursor, Codex, and
anything that reads a SKILL.md — know how to render 3D models and primitive
shapes as ASCII art straight in the terminal. Ask “render a cube in the
terminal” and the agent runs glyphcss cube --auto-center and shows you the
colored output inline.
Install the CLI
Section titled “Install the CLI”The skill drives the @glyphcss/compile CLI. Install it once:
npm i -g @glyphcss/compile # the command is `glyphcss`# or, no install:npx @glyphcss/compile cube --auto-centerAdd the skill
Section titled “Add the skill”Point your agent at the skill, either way:
-
From npm — it’s bundled with the package at
node_modules/@glyphcss/compile/SKILL.md. -
From the web — fetch glyphcss.com/skill.md and drop it into your agent’s skills folder. For Claude Code that’s
.claude/skills/glyphcss/SKILL.md:Terminal window mkdir -p .claude/skills/glyphcsscurl -sS https://glyphcss.com/skill.md -o .claude/skills/glyphcss/SKILL.md
Cursor, Codex, and other agents that support skill/rule files can use the same
SKILL.md — it’s plain Markdown describing the CLI.
What the agent can do
Section titled “What the agent can do”Once the skill is in place, natural-language requests map to CLI runs:
| You ask | The agent runs |
|---|---|
| ”render a cube in the terminal” | glyphcss cube --auto-center |
| ”show me this model as ASCII” | glyphcss model.glb --auto-center |
| ”render a torus, rotated” | glyphcss torus --rot-x 60 --rot-y 30 --auto-center |
| ”ascii-art these polygons” | glyphcss --polygons-json '[…]' |
| ”save it as an HTML page” | glyphcss model.obj -f full -o out.html |
Input can be a mesh file (.obj/.glb/.gltf/.vox/.stl), a primitive shape
(cube, sphere, icosahedron, torus, cone, … — 44 shapes), or custom
polygons as JSON. In a terminal the output defaults to truecolor ANSI, so it
shows in color right in the agent’s console.
Example prompts
Section titled “Example prompts”- “Use glyphcss to render a dodecahedron and show it to me.”
- “Render
./assets/ship.glbas ASCII at 60 columns.” - “Generate ASCII art of a red triangle with glyphcss.”
See the Compiling to Static guide for the full CLI reference, the Vite plugin, and the Node API.