<!-- Generated by @imgly/plugin-repo-builder — do not edit this repo by hand. -->
<!-- mcp-name: ly.img/codesign -->

# CoDesign

**The design layer for the agent era.**

CoDesign gives your coding agent a real design engine. Generate, edit, and
automate _fully editable_ designs — print, social, and video — straight from
the chat, then export print-ready PDFs, images, mp4 video, and more. You steer, the agent
edits the same scene, and you keep control of the outcome.

It ships as an MCP server (plus a Claude Code plugin) that hands your agent
IMG.LY's CE.SDK CreativeEngine — the same production engine behind IMG.LY's
commercial SDKs. Every recipe below spawns the published npm package
`@imgly/codesign-mcp` over stdio; no separate install step — `npx` fetches it on first
use.

## What you can make

Ask your agent, in plain language:

- **Resize for every channel** — _"Take this Instagram post and make the
  Story, LinkedIn and X versions."_
- **Make an image editable** (needs the free IMG.LY sign-in) — _"Split this
  flat product photo into layers, put the product on our brand background and
  make it editable."_
- **Restyle an existing PDF** — _"Import this datasheet.pdf as an editable
  design, restyle it with our brand kit, and export A4 and web versions."_
- **Generate many from a CSV** — _"One speaker card per row in speakers.csv,
  same template, all editable."_
- **Prepare for print** — _"Turn this flyer into an A4 print PDF with 3 mm
  bleed and CMYK."_
- **Update an existing design** — _"Open last year's flyer.psd, swap the date
  and venue, export again."_
- **Localize a design** — _"Translate this poster into German and re-fit the
  layout so nothing overflows."_
- **Make a short video** (generated music and voiceover need the free IMG.LY
  sign-in) — _"Turn this poster into a 15-second vertical reel: animate the
  headline in, cut between the three product shots, and put a music bed and a
  voiceover under it."_
- **Create a launch graphic** — _"Make the v2.0 launch graphic with our logo
  and brand colors, in X, LinkedIn and OG-image sizes."_
- **Create App Store graphics** — _"Make the App Store screenshots and the
  Play Store feature graphic from these five screen captures, on-brand, all
  sizes."_

## How it works

Three layers, one product:

- **The plugin** — skills, slash commands, and an embedded design handbook your
  agent draws on to design _well_ (brand, localize, resize, and quality-check
  its own output). This is the piece you install.
- **The MCP server** (`@imgly/codesign-mcp`) — exposes the design tools (`edit`,
  `preview`, `export`, `list`, `history`, …) over MCP, driven by tool calls
  from any agent host.
- **The CE.SDK CreativeEngine** — IMG.LY's real, headless design engine that
  does the actual layout, rendering, and export.

## Licensing

This repository — the Claude Code and Codex plugins, marketplace manifests,
skills and documentation — is released under the [MIT License](./LICENSE).
The CoDesign engine itself, distributed as the npm package `@imgly/codesign-mcp`, is
proprietary software from IMG.LY and free to use locally. The full terms ship
inside the package as `LICENSE.md`.

## Why a real engine matters

Every other design agent draws on a web canvas — a quick fix that breaks on the
hard problems. CoDesign commands a production engine matured over years across
print, video, and social:

- **True print & color fidelity** — CMYK, bleed, and ICC profiles, not just
  RGB screen output.
- **Deterministic output** — renders identically everywhere, independent of
  browser or config.
- **Native performance** — a purpose-built engine that stays fast at scale and
  under heavy assets.
- **Full compatibility** — imports InDesign, PSD, PowerPoint (PPTX), PDF, and
  Lottie; exports print-ready PDF, image, video, and HTML.

## Requirements & known limitations

> **Read this first — the failure modes below are silent.**

- **Node.js ≥ 22.15 is required and is _not_ provided.** The server runs on your
  system Node. With no Node (or Node < 22.15) on `PATH`, the host reports the
  server as failed with no useful reason — typically `local: 0` and
  `MCP error -32000`. Install Node 22.15+ first: <https://nodejs.org>.
- **Pin `@0.4.1` — every recipe names that exact version on purpose.** The
  plugin ships the skills that version was built with, and a bare or dist-tagged
  `npx` would pair them with a different server. Each release republishes this
  repo with a new pin — update the plugin (or your recipe) to move forward.
- **Windows is not supported under bare `npx`.** Hosts that spawn `npx`
  directly hit `spawn npx ENOENT`
  ([anthropics/claude-code#58510](https://github.com/anthropics/claude-code/issues/58510)).
  Use WSL for now; a native Windows launcher is coming.

## Install

### Claude Code

Install the plugin from the marketplace:

```bash
claude plugin marketplace add imgly/codesign
claude plugin install codesign@imgly-codesign
```

Or add the MCP server directly, without the plugin:

```bash
claude mcp add codesign -- npx -y @imgly/codesign-mcp@0.4.1 stdio
```

### Codex

Install the plugin from the marketplace:

```bash
codex plugin marketplace add imgly/codesign
codex plugin add codesign@imgly-codesign
```

Or add the MCP server directly, without the plugin:

```bash
codex mcp add codesign -- npx -y @imgly/codesign-mcp@0.4.1 stdio
```

### Antigravity CLI

Clone the repo and install the plugin folder:

```bash
git clone https://github.com/imgly/codesign
agy plugin install ./codesign/plugins/codesign
```

Or add the MCP server directly, without the plugin:

```bash
agy mcp add codesign -- npx -y @imgly/codesign-mcp@0.4.1 stdio
```

### Gemini CLI

Gemini CLI now serves Gemini Code Assist Standard/Enterprise and API-key
accounts; on a personal Google account, use Antigravity CLI above.

Install as an extension straight from the public repo:

```bash
gemini extensions install https://github.com/imgly/codesign
```

Or add the server manually to `~/.gemini/settings.json`:

```json
{
  "mcpServers": {
    "codesign": {
      "command": "npx",
      "args": [
        "-y",
        "@imgly/codesign-mcp@0.4.1",
        "stdio"
      ]
    }
  }
}
```

### Other MCP hosts

Every other host spawns the same stdio server — only the config file and
the top-level key differ. Add this block to the host’s MCP config:

```json
{
  "mcpServers": {
    "codesign": {
      "command": "npx",
      "args": [
        "-y",
        "@imgly/codesign-mcp@0.4.1",
        "stdio"
      ]
    }
  }
}
```

| Host | Config file | Note |
| --- | --- | --- |
| Cursor | `.cursor/mcp.json` | as-is |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` | as-is |
| VS Code | `.vscode/mcp.json` | use the key `servers` instead of `mcpServers` |
| Zed | `settings.json` | use the `context_servers` shape below |

VS Code (`servers` key):

```json
{
  "servers": {
    "codesign": {
      "command": "npx",
      "args": [
        "-y",
        "@imgly/codesign-mcp@0.4.1",
        "stdio"
      ]
    }
  }
}
```

Zed (`context_servers`):

```json
{
  "context_servers": {
    "codesign": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@imgly/codesign-mcp@0.4.1",
          "stdio"
        ]
      }
    }
  }
}
```

## Beyond your machine

CoDesign runs free on your machine today. When you need more — always-on
hosting, your own infrastructure (VPC / on-prem), or a fully bundled design
agent that lives in the canvas — the same building block graduates by changing
config, not vendors. No lock-in. Talk to us: <support@img.ly>.

## Support

Questions or issues: <support@img.ly>. This distribution is generated from
IMG.LY's source repository.