Skip to content
Back to search

peekdesign

MarketplaceWorks with Claude CodeGitHub

Peekdesign for Claude Code: your agent's art director (MCP server, skills, commands)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wrencanfly--peekdesign-plugin/badge.svg)](/listings/wrencanfly--peekdesign-plugin)

HTML

<a href="/listings/wrencanfly--peekdesign-plugin"><img src="/api/listings/wrencanfly--peekdesign-plugin/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 20 lines
  1. {
  2. "name": "peekdesign",
  3. "owner": {
  4. "name": "Peekdesign",
  5. "url": "https://peekdesign.space"
  6. },
  7. "metadata": {
  8. "description": "Peekdesign for Claude Code: your agent's art director."
  9. },
  10. "plugins": [
  11. {
  12. "name": "peekdesign",
  13. "source": "./",
  14. "description": "Style directions with tokens, curated references, design guides, a live canvas with screenshots, critiques and Peek, our design agent.",
  15. "version": "0.2.1",
  16. "category": "design",
  17. "homepage": "https://peekdesign.space/plugin"
  18. }
  19. ]
  20. }
README.md · README · 155 lines
  1. # Peekdesign — your agent's art director
  2. Peekdesign connects your coding agent to a curated library of motion, branding and interface work from artists on X, and to the tools our own design agent uses. Your agent can:
  3. - **turn a vibe into a style** — three directions for any search, each with a palette with roles, a Google Fonts pairing, how to build it, its references, CSS tokens and a ready `STYLE.md`,
  4. - **find and study references** — plain-words search over the whole library, full media, and specs (palette, type, grid, a timed motion breakdown with easings),
  5. - **follow our design guides** — the rules Peek designs by: websites and landing pages, product UI, motion, real glass and 3D in WebGL,
  6. - **design on a live canvas** you can watch, with real-browser screenshots so it checks its own work (WebGL included; three.js, React Three Fiber, drei and GSAP import by name),
  7. - **critique** a design against references (0–100 across six axes, with concrete fixes),
  8. - **hand a brief to Peek**, our design agent, and bring the result back into your codebase.
  9. Your agent does the heavy lifting on your own plan — thinking and writing code are free. Credits (included monthly with every paid plan, or as top-ups) pay only for what runs on our side: opening a design 1 · spec 3 · inspiration 5 · style directions 10 (the first 10 are free) · critique 10 · a frame change 1 · a screenshot 2 · Peek by its real model use. Searching, reading and guides are free. New accounts get 100 credits.
  10. The MCP endpoint is `https://peekdesign.space/api/mcp` (locally: `http://localhost:3000/api/mcp`).
  11. ## Claude Code — plugin (recommended)
  12. The plugin bundles the MCP server, four skills (`art-director`, `design-artifacts`, `design-critique`, `motion-direction`) and four commands:
  13. | Command | What it does |
  14. | --- | --- |
  15. | `/peekdesign:style <search>` | Three style directions; saves the one you pick as `STYLE.md` and tokens |
  16. | `/peekdesign:inspire <brief>` | Art direction for what you're building, from real references |
  17. | `/peekdesign:peek <brief>` | Hands the brief to Peek, watches it on a canvas, brings the code back |
  18. | `/peekdesign:critique [target]` | Scores a design and turns the critique into fixes |
  19. Install it from inside Claude Code:
  20. ```
  21. /plugin marketplace add wrencanfly/peekdesign-plugin
  22. /plugin install peekdesign@peekdesign
  23. ```
  24. Then run `/mcp`, select **peekdesign** and **Authenticate**. Your browser opens; sign in and click **Allow**. That's it — no keys to copy. Try: *"Call get_account and tell me my plan and credits."*
  25. The plugin points at `https://peekdesign.space/api/mcp`. To use another instance (a local one while developing), export its URL before starting Claude Code:
  26. ```bash
  27. export PEEKDESIGN_URL=http://localhost:3000
  28. ```
  29. ### Using an API key instead of OAuth
  30. For CI, headless machines or if you prefer keys: create one at **Account → Agent access** (`/account#agents`), then add a `headers` block to `plugin/.mcp.json` (or your own project's `.mcp.json`):
  31. ```json
  32. {
  33. "mcpServers": {
  34. "peekdesign": {
  35. "type": "http",
  36. "url": "${PEEKDESIGN_URL:-https://peekdesign.space}/api/mcp",
  37. "headers": { "Authorization": "Bearer ${PEEKDESIGN_API_KEY}" }
  38. }
  39. }
  40. }
  41. ```
  42. ```bash
  43. export PEEKDESIGN_API_KEY=df_live_…
  44. ```
  45. ## Claude Code — MCP only
  46. No plugin, just the tools (MCP prompts `art-direct` and `critique` carry the workflow):
  47. ```bash
  48. claude mcp add --transport http peekdesign https://<host>/api/mcp
  49. # then /mcp → peekdesign → Authenticate
  50. # or with an API key:
  51. claude mcp add --transport http peekdesign https://<host>/api/mcp \
  52. --header "Authorization: Bearer $PEEKDESIGN_API_KEY"
  53. ```
  54. ## Cursor
  55. Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project):
  56. ```json
  57. {
  58. "mcpServers": {
  59. "peekdesign": {
  60. "url": "https://<host>/api/mcp",
  61. "headers": { "Authorization": "Bearer ${env:PEEKDESIGN_API_KEY}" }
  62. }
  63. }
  64. }
  65. ```
  66. Set `PEEKDESIGN_API_KEY` in the environment Cursor is launched from. Cursor also supports OAuth for remote servers: omit `headers` and click **Connect** in Settings → MCP.
  67. ## VS Code (Copilot agent mode)
  68. `.vscode/mcp.json`:
  69. ```json
  70. {
  71. "servers": {
  72. "peekdesign": { "type": "http", "url": "https://<host>/api/mcp" }
  73. }
  74. }
  75. ```
  76. VS Code discovers OAuth automatically and prompts you to sign in.
  77. ## Claude.ai and Claude Desktop
  78. 1. **Settings → Connectors → Add custom connector.**
  79. 2. Name it *Peekdesign* and paste `https://<host>/api/mcp` as the URL.
  80. 3. Click **Connect** — sign in with your email code and **Allow**.
  81. Enable it per chat from the tools menu. (Custom connectors need a publicly reachable HTTPS URL, so this works with a deployed instance, not `localhost`.)
  82. ## ChatGPT
  83. 1. **Settings → Apps & Connectors → Advanced settings → enable Developer mode.**
  84. 2. **Create connector**: name *Peekdesign*, MCP server URL `https://<host>/api/mcp`, authentication **OAuth**.
  85. 3. Sign in with your email code and **Allow**, then pick the connector in a chat's tools menu.
  86. ## Managing access
  87. - **Account → Agent access** (`/account#agents`): create, view (prefix and last use) and revoke API keys. A key is shown once.
  88. - **Account → Connected apps** (`/account#apps`): see and disconnect OAuth apps (Claude.ai, ChatGPT, Claude Code…).
  89. - **Account → Credits** (`/account#credits`): balance, packs, prices and history.
  90. ## Tools
  91. | Tool | Credits |
  92. | --- | --- |
  93. | `search_designs`, `list_guides`, `read_guide`, `get_account`, `list_boards`, `read_board`, `read_frame`, `get_artifact`, `list_artifacts`, `get_peek_run` | free |
  94. | `get_style_directions` | 10 (first 10 free; a search anyone ran this week is free) |
  95. | `get_design` / `get_design_spec` | 1 per day / 3 per month, per design |
  96. | `find_inspiration` / `critique_design` | 5 / 10 |
  97. | `create_board` · frame changes · `get_frame_screenshot` | 2 · 1 each (+2 with `look: true`) · 2 |
  98. | `ask_peek` | Peek's real model use plus its tools |
  99. | `create_artifact` / `update_artifact` | 2 / 1 |
  100. | `generate_images` · `generate_design` | by model · 40 |
  101. ## What the plugin sends, and where
  102. The plugin contains no code that runs on your machine: four skills and four commands (plain instructions for your agent) and one MCP server entry pointing at `https://peekdesign.space/api/mcp` (or `$PEEKDESIGN_URL`). Nothing reaches Peekdesign except the tool calls your agent makes, and each one carries only its own arguments:
  103. - **Searches and briefs** — the words your agent searches with or describes the design in.
  104. - **Code it chooses to send** — HTML/React for canvas frames and artifacts it writes, or a component's source passed to `critique_design`. Your agent never uploads your codebase on its own; it sends what a tool call needs.
  105. - **Sign-in** — OAuth with your Peekdesign account (or an API key you create), so results land in your account.
  106. What we keep: your canvases, frames, artifacts, generated images, search overviews and a log of tool calls and credits, on your account, until you delete them or ask us to. Our AI tools (style directions, critiques, Peek) send the relevant content to Anthropic to generate the result; image generation goes to the image model you pick. We don't sell personal data. Privacy policy: https://peekdesign.space/privacy · Terms: https://peekdesign.space/terms
  107. ## License
  108. MIT for this plugin (the skills, commands and manifests). The Peekdesign service, its library and the artists' work are not covered by it.
  109. ## Ethics
  110. Every reference credits its artist. The skills instruct your agent to credit them too and to borrow technique — grids, pacing, easing, palette relationships — never content such as copy, logos, characters or footage.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.