GlyphSmith is an SVG editor designed for both manual editing and AI-assisted editing. Instead of asking agents to rewrite whole SVG strings, GlyphSmith imports SVG into a Geometry AST, applies targeted patch operations, and exports SVG only at the boundary.

SVG
↓ Import
Geometry AST
↓ Patch Operations
Geometry AST
↓ Export
SVG

Status

GlyphSmith is in early development. The current release is CLI-first and focuses on local editor sessions, project files, SVG export, and MCP-based agent workflows.

Quick Start

Install GlyphSmith:

npm install -g glyphsmith

Start a new project:

glyphsmith my-logo

This opens ./my-logo.gs.json. If the file does not exist, GlyphSmith creates it automatically.

You can also run it without a global install:

npx glyphsmith my-logo

Agent Workflow

GlyphSmith keeps the Geometry AST as the source of truth. AI agents should modify projects through patch operations or MCP tools instead of regenerating SVG files.

Default local MCP endpoint:

http://127.0.0.1:6202/mcp

Register the local MCP endpoint:

glyphsmith mcp install codex --url http://127.0.0.1:6202/mcp
glyphsmith mcp install claude --url http://127.0.0.1:6202/mcp

Install GlyphSmith skills:

glyphsmith skills install codex
glyphsmith skills install claude

Project Files

GlyphSmith project files use the .gs.json extension and can contain multiple pages. One page maps to one SVG-equivalent Geometry AST document.

Examples:

examples/playground.gs.json
examples/glyphsmith.gs.json

CLI path resolution is deterministic:

glyphsmith              -> ./glyphsmith.gs.json
glyphsmith logo         -> ./logo.gs.json
glyphsmith logo.gs.json -> ./logo.gs.json

If the resolved project file does not exist, the CLI creates it and continues.

Repository Layout

apps/
├ cli/  Local host, CLI entrypoint, MCP coordination
└ web/  SvelteKit editor UI

packages/
├ ast/     Geometry AST definitions
├ editor/  Reusable editor interaction logic
├ kernel/  Geometry operations
├ mcp/     MCP server implementation
└ svg/     SVG import/export

README Assets

README images live in docs/images. App runtime assets live in apps/web/static.

Current README assets:

docs/images/app-icon.svg
docs/images/editor.png

Developer Workflow

Install dependencies:

pnpm install

Run GlyphSmith from this repository:

pnpm run build:cli
node apps/cli/dist/index.js my-logo

Run the default development project:

pnpm run dev

Development defaults:

Project: examples/playground.gs.json
UI:      http://localhost:6201
Host:    ws://localhost:6202/ws
MCP:     http://localhost:6202/mcp

Run the official GlyphSmith icon project:

pnpm run dev:icons

Export Icons

Export the icon project into the web app static directory:

pnpm run export:icons

The generated SVG files are written to:

apps/web/static/icons

Running the command again overwrites the generated icon output.

Package

Build the publishable CLI package:

pnpm run build:cli

Create a local npm tarball for inspection:

pnpm run pack:cli

The package is written to artifacts/npm and contains the bundled CLI, built web UI, and GlyphSmith skills.