{ "markdown": "\n\n\n# CoDesign\n\n**The design layer for the agent era.**\n\nCoDesign gives your coding agent a real design engine. Generate, edit, and\nautomate _fully editable_ designs — print, social, and video — straight from\nthe chat, then export print-ready PDFs, images, mp4 video, and more. You steer, the agent\nedits the same scene, and you keep control of the outcome.\n\nIt ships as an MCP server (plus a Claude Code plugin) that hands your agent\nIMG.LY's CE.SDK CreativeEngine — the same production engine behind IMG.LY's\ncommercial SDKs. Every recipe below spawns the published npm package\n`@imgly/codesign-mcp` over stdio; no separate install step — `npx` fetches it on first\nuse.\n\n## What you can make\n\nAsk your agent, in plain language:\n\n- **Resize for every channel** — _\"Take this Instagram post and make the\n Story, LinkedIn and X versions.\"_\n- **Make an image editable** (needs the free IMG.LY sign-in) — _\"Split this\n flat product photo into layers, put the product on our brand background and\n make it editable.\"_\n- **Restyle an existing PDF** — _\"Import this datasheet.pdf as an editable\n design, restyle it with our brand kit, and export A4 and web versions.\"_\n- **Generate many from a CSV** — _\"One speaker card per row in speakers.csv,\n same template, all editable.\"_\n- **Prepare for print** — _\"Turn this flyer into an A4 print PDF with 3 mm\n bleed and CMYK.\"_\n- **Update an existing design** — _\"Open last year's flyer.psd, swap the date\n and venue, export again.\"_\n- **Localize a design** — _\"Translate this poster into German and re-fit the\n layout so nothing overflows.\"_\n- **Make a short video** (generated music and voiceover need the free IMG.LY\n sign-in) — _\"Turn this poster into a 15-second vertical reel: animate the\n headline in, cut between the three product shots, and put a music bed and a\n voiceover under it.\"_\n- **Create a launch graphic** — _\"Make the v2.0 launch graphic with our logo\n and brand colors, in X, LinkedIn and OG-image sizes.\"_\n- **Create App Store graphics** — _\"Make the App Store screenshots and the\n Play Store feature graphic from these five screen captures, on-brand, all\n sizes.\"_\n\n## How it works\n\nThree layers, one product:\n\n- **The plugin** — skills, slash commands, and an embedded design handbook your\n agent draws on to design _well_ (brand, localize, resize, and quality-check\n its own output). This is the piece you install.\n- **The MCP server** (`@imgly/codesign-mcp`) — exposes the design tools (`edit`,\n `preview`, `export`, `list`, `history`, …) over MCP, driven by tool calls\n from any agent host.\n- **The CE.SDK CreativeEngine** — IMG.LY's real, headless design engine that\n does the actual layout, rendering, and export.\n\n## Licensing\n\nThis repository — the Claude Code and Codex plugins, marketplace manifests,\nskills and documentation — is released under the [MIT License](./LICENSE).\nThe CoDesign engine itself, distributed as the npm package `@imgly/codesign-mcp`, is\nproprietary software from IMG.LY and free to use locally. The full terms ship\ninside the package as `LICENSE.md`.\n\n## Why a real engine matters\n\nEvery other design agent draws on a web canvas — a quick fix that breaks on the\nhard problems. CoDesign commands a production engine matured over years across\nprint, video, and social:\n\n- **True print & color fidelity** — CMYK, bleed, and ICC profiles, not just\n RGB screen output.\n- **Deterministic output** — renders identically everywhere, independent of\n browser or config.\n- **Native performance** — a purpose-built engine that stays fast at scale and\n under heavy assets.\n- **Full compatibility** — imports InDesign, PSD, PowerPoint (PPTX), PDF, and\n Lottie; exports print-ready PDF, image, video, and HTML.\n\n## Requirements & known limitations\n\n> **Read this first — the failure modes below are silent.**\n\n- **Node.js ≥ 22.15 is required and is _not_ provided.** The server runs on your\n system Node. With no Node (or Node < 22.15) on `PATH`, the host reports the\n server as failed with no useful reason — typically `local: 0` and\n `MCP error -32000`. Install Node 22.15+ first: .\n- **Pin `@0.5.1` — every recipe names that exact version on purpose.** The\n plugin ships the skills that version was built with, and a bare or dist-tagged\n `npx` would pair them with a different server. Each release republishes this\n repo with a new pin — update the plugin (or your recipe) to move forward.\n- **Windows is not supported under bare `npx`.** Hosts that spawn `npx`\n directly hit `spawn npx ENOENT`\n ([anthropics/claude-code#58510](https://github.com/anthropics/claude-code/issues/58510)).\n Use WSL for now; a native Windows launcher is coming.\n\n## Install\n\n### Claude Code\n\nInstall the plugin from the marketplace:\n\n```bash\nclaude plugin marketplace add imgly/codesign\nclaude plugin install codesign@imgly-codesign\n```\n\nOr add the MCP server directly, without the plugin:\n\n```bash\nclaude mcp add codesign -- npx -y @imgly/codesign-mcp@0.5.1 stdio\n```\n\n### Codex\n\nInstall the plugin from the marketplace:\n\n```bash\ncodex plugin marketplace add imgly/codesign\ncodex plugin add codesign@imgly-codesign\n```\n\nOr add the MCP server directly, without the plugin:\n\n```bash\ncodex mcp add codesign -- npx -y @imgly/codesign-mcp@0.5.1 stdio\n```\n\n### Antigravity CLI\n\nClone the repo and install the plugin folder:\n\n```bash\ngit clone https://github.com/imgly/codesign\nagy plugin install ./codesign/plugins/codesign\n```\n\nOr add the MCP server directly, without the plugin:\n\n```bash\nagy mcp add codesign -- npx -y @imgly/codesign-mcp@0.5.1 stdio\n```\n\n### Gemini CLI\n\nGemini CLI now serves Gemini Code Assist Standard/Enterprise and API-key\naccounts; on a personal Google account, use Antigravity CLI above.\n\nInstall as an extension straight from the public repo:\n\n```bash\ngemini extensions install https://github.com/imgly/codesign\n```\n\nOr add the server manually to `~/.gemini/settings.json`:\n\n```json\n{\n \"mcpServers\": {\n \"codesign\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@imgly/codesign-mcp@0.5.1\",\n \"stdio\"\n ]\n }\n }\n}\n```\n\n### Other MCP hosts\n\nEvery other host spawns the same stdio server — only the config file and\nthe top-level key differ. Add this block to the host’s MCP config:\n\n```json\n{\n \"mcpServers\": {\n \"codesign\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@imgly/codesign-mcp@0.5.1\",\n \"stdio\"\n ]\n }\n }\n}\n```\n\n| Host | Config file | Note |\n| --- | --- | --- |\n| Cursor | `.cursor/mcp.json` | as-is |\n| Windsurf | `~/.codeium/windsurf/mcp_config.json` | as-is |\n| VS Code | `.vscode/mcp.json` | use the key `servers` instead of `mcpServers` |\n| Zed | `settings.json` | use the `context_servers` shape below |\n\nVS Code (`servers` key):\n\n```json\n{\n \"servers\": {\n \"codesign\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@imgly/codesign-mcp@0.5.1\",\n \"stdio\"\n ]\n }\n }\n}\n```\n\nZed (`context_servers`):\n\n```json\n{\n \"context_servers\": {\n \"codesign\": {\n \"command\": {\n \"path\": \"npx\",\n \"args\": [\n \"-y\",\n \"@imgly/codesign-mcp@0.5.1\",\n \"stdio\"\n ]\n }\n }\n }\n}\n```\n\n## Beyond your machine\n\nCoDesign runs free on your machine today. When you need more — always-on\nhosting, your own infrastructure (VPC / on-prem), or a fully bundled design\nagent that lives in the canvas — the same building block graduates by changing\nconfig, not vendors. No lock-in. Talk to us: .\n\n## Support\n\nQuestions or issues: . This distribution is generated from\nIMG.LY's source repository.\n", "bytes": 7718, "sha": "b1479a617c0b4d587483dbaea1720ed6e6c74ad0a692313219b4e67354ac3ce6", "repo_slug": "imgly/codesign", "fonte": "repo", "truncated": false, "api": "https://api.agentalog.com/api/listings/plg_imgly_codesign_8ec8c39d/readme" }