Skip to content

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.

The skill drives the @glyphcss/compile CLI. Install it once:

Terminal window
npm i -g @glyphcss/compile # the command is `glyphcss`
# or, no install:
npx @glyphcss/compile cube --auto-center

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/glyphcss
    curl -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.

Once the skill is in place, natural-language requests map to CLI runs:

You askThe 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.

  • “Use glyphcss to render a dodecahedron and show it to me.”
  • “Render ./assets/ship.glb as 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.