Skip to content

Repository files navigation

Plate

Plate

Give your coding agent eyes for design.

Quickstart · Tools · Install · Website

Plate: give your agent eyes for design. Brief, catalog, resolve, kit, stack, capture, inspect, check, pair, license.

Give your agent a clear view of what it builds. Plate captures the running project, returns the actual image, and supplies asset references and source checks for the next revision.

Connect it to Claude Code, Codex or Cursor over MCP. Your existing agent does the work; Plate provides the tools and keeps captures on your computer.

Built with Plate Pro

Night Pitch: a floodlit top-down arena on stadium turf, with wave, integrity and score readouts

Night Pitch — a playable floodlit arena, keyboard and on-screen touch controls, real stadium turf and a rigged character. Its complete implementation is included in Plate Pro. Play it

These are demonstrations from the Plate example set, not benchmarks, and not something the free Starter produces for you. The Starter gives your agent the evidence loop and the material; Pro adds the systems and worked implementations behind these examples.

Cinder 750: an insulated bottle product page with the bottle lit by a real studio environment Kiln: a landing page for a pottery studio in Lisbon
Cinder 750 — product page, real environment light. Open it Kiln — pottery studio landing page. Open it

Install

Install into an isolated virtual environment; your agent will be pointed at that interpreter.

git clone https://github.com/ohad6k/plate.git
cd plate
python -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
python -m pip install .
python -m plate_toolkit doctor

Python 3.11 or newer. For screenshots, add python -m pip install playwright and python -m playwright install chromium in the same environment.

Connect your agent

Print the snippet for your client and merge it into that client's config. The command only prints; it never edits your files.

python -m plate_toolkit config claude    # or codex, or cursor

Claude Code (.mcp.json) and Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "plate": {
      "command": "/path/to/plate/.venv/bin/python",
      "args": ["-m", "plate_toolkit", "mcp"]
    }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.plate]
command = "/path/to/plate/.venv/bin/python"
args = ["-m", "plate_toolkit", "mcp"]

The printed snippet carries the absolute path of the interpreter you installed into, so generate it in the environment your agent actually runs in. Restart the client and the ten tools are connected.

Three things to ask for

Look at what it just built.

Serve the site on http://localhost:5173, capture it with Plate at 1440x900 and again at 390x844, and tell me what is wrong with the hierarchy.

plate_capture opens an isolated Chromium with none of your logged-in sessions, waits for fonts and readiness, and returns a real image plus overflow, missing images and page errors. It asks for reduced motion by default so two captures are comparable; pass reduced_motion: false when you need an animated state. plate_inspect does the same for a screenshot you already have.

Load real material instead of drawing it.

Brief a night stadium scene, resolve the nouns with Plate, then read plate_kit stadium and plate_stack three-r128 and wire the HDRI, turf and rigged character in.

plate_resolve looks each visual noun up in its supported account-free sources — Poly Haven, the Quaternius animation library and Google Fonts — and returns the licence, size and a load snippet. Anything those sources cannot honestly supply, such as a face, a photograph or a brand mark, comes back resolved: false with the reason instead of a plausible substitute.

Find out why it looks generated.

Run plate_check on index.html, fix the three highest-weighted tells, capture before and after, and build the comparison with plate_pair.

plate_check reads the source and counts primitives against loaded assets, gradient heroes, emoji headings, pill buttons, purple by hue, a centred column under a nav, missing type and three.js with no post-processing. It reports what it cannot see rather than scoring the picture.

The ten free tools

plate_brief · plate_catalog · plate_resolve · plate_kit · plate_stack · plate_check · plate_pair · plate_capture · plate_inspect · plate_license

Arguments, limits and protocol notes are in docs/TOOLS.md. Two ready-to-load kits ship with the repository, each asset byte-identical to its upstream original with KIT.md and LICENSES.md next to the files: stadium (rigged humanoid with 46 clips, night HDRI, turf, concrete) and product-card (studio HDRI, hero object script).

Starter and Pro

Starter (this repository) Pro
MCP server, CLI and agent skill Yes Yes
Free tools All ten All ten
Asset kits with licences stadium, product-card Same two
Design systems Four: editorial, product, software, data
Worked implementations with real previews Included, with one-call project assembly into a new folder
Project contract and before/after review record Included
Studio, the local project workbench Included in Pro, installed by the Pro distribution
Online library and private saved briefs Included
Licence MIT source, free One-time individual licence

Pro is a separate distribution with its own installer, published on the Plate site. The free tools in this repository work without a purchase.

Both distributions install as plate-toolkit at the same version, so pip will not replace one with the other on its own:

python -m pip install --force-reinstall <the Pro wheel>

That swaps the installed package only. Your Plate home directory — ~/.plate by default, or wherever PLATE_HOME points — is never touched by an install, so captures, cache and any saved work survive the upgrade.

What Plate does not do

It does not host a model, generate images or rank designs. plate_check reads source, never pixels: its score finds known tells and is not a rating — do not optimize against it and do not present it as proof that one design beats another. A capture is one still frame and says nothing about timing or how motion reads over its length. The example pages above are selected demonstrations, not controlled experiments. Resolved assets come from third-party sources whose terms you should read before shipping.

Docs and community

Quickstart · Install · Tools · Agent skill · Contributing · Security

Bugs and feature requests belong in GitHub issues. Anything with a security impact goes through private reporting as described in SECURITY.md.

Licence

MIT, see LICENSE. Kit assets keep their own licences, including CC0 dedications and font licences; each kit's KIT.md and LICENSES.md record the source, size and terms per file, and those files travel with the assets.

About

Design tools for your coding agent. Capture, inspect, resolve real assets, and improve websites, games and motion.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages