GlyphSmith

<p align="center"> <img src="https://raw.githubusercontent.com/KobayashiRui/GlyphSmith/main/docs/images/app-icon.svg" alt="GlyphSmith" width="72" height="72" /> </p> <h1 align="center">GlyphSmith</h1> <p align="center"> Agent-native SVG editor powered by Geometry AST and patch-based editing. </p> <p align="center"> <a href="https://www.npmjs.com/package/glyphsmith"><img src="https://img.shields.io/npm/v/glyphsmith?style=flat-square" alt="npm version" /></a> <a href="https://www.npmjs.com/package/glyphsmith"><img src="https://img.shields.io/npm/dm/glyphsmith?style=flat-square" alt="npm downloads" /></a> <a href="https://github.com/KobayashiRui/GlyphSmith/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/glyphsmith?style=flat-square" alt="license" /></a> <img src="https://img.shields.io/node/v/glyphsmith?style=flat-square" alt="node version" /> <img src="https://img.shields.io/badge/pnpm-9.0.0-F69220?style=flat-square&logo=pnpm&logoColor=white" alt="pnpm 9.0.0" /> </p> <p align="center"> English | <a href="https://github.com/KobayashiRui/GlyphSmith/blob/main/README.ja.md">日本語</a> </p> 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.  ```txt SVG ↓ Import Geometry AST ↓ Patch Operations Geometry AST ↓ Export SVG ``` ## Demo  ## 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: ```sh npm install -g glyphsmith ``` Start a new project: ```sh 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: ```sh 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: ```txt http://127.0.0.1:6202/mcp ``` Register the local MCP endpoint: ```sh 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: ```sh 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: ```txt examples/playground.gs.json examples/glyphsmith.gs.json ``` CLI path resolution is deterministic: ```txt 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 ```txt 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: ```txt docs/images/app-icon.svg docs/images/glyphsmith-demo.gif docs/images/editor.png ``` ## Developer Workflow Install dependencies: ```sh pnpm install ``` Run GlyphSmith from this repository: ```sh pnpm run build:cli node apps/cli/dist/index.js my-logo ``` Run the default development project: ```sh pnpm run dev ``` Development defaults: ```txt 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: ```sh pnpm run dev:icons ``` ### Export Icons Export the icon project into the web app static directory: ```sh pnpm run export:icons ``` The generated SVG files are written to: ```txt apps/web/static/icons ``` Running the command again overwrites the generated icon output. ### Package Build the publishable CLI package: ```sh pnpm run build:cli ``` Create a local npm tarball for inspection: ```sh pnpm run pack:cli ``` The package is written to `artifacts/npm` and contains the bundled CLI, built web UI, and GlyphSmith skills.