Skip to main content
plugin

designer-notes — Claude Code plugin: what it does, how to install

designer-notes lets you pin visual comments and edit text directly in the browser on rendered HTML, then hands off the changes to Claude Code.

MIT ★ 7 updated 2026-04-27

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add anthropics/claude-plugins-community
/plugin install designer-notes@claude-community
Open on GitHub

What designer-notes does

The plugin embeds a script into project HTML files and spins up a local dev server. It adds floating browser controls for a Figma-style review experience. Pressing C toggles pin commenting on any element, while pressing T enables inline text editing with automatic before-and-after diff tracking.

Every review note saves with its CSS selector, coordinates, and viewport dimensions into a file named feedback-YYYY-MM-DD.md. Popovers also accept skill triggers, effort tags, and model flags like #opus, #sonnet, or #haiku.

Without Node.js 14 or newer, the background server will not run. Once notes are recorded, running /submit-feedback instructs Claude Code to inspect the markdown file and modify source files directly.

What it helps with

  • attach visual feedback pins to rendered HTML elements
  • edit UI copy inline directly in the browser
  • record viewport sizes and CSS selectors for responsive fixes
  • apply accumulated design changes in batch via /submit-feedback

Example prompts for the agent

  • Start the review server by running /designer-notes
  • Apply collected browser feedback with /submit-feedback

How to install designer-notes

Plugin marketplace

/plugin marketplace add anthropics/claude-plugins-community
/plugin install designer-notes@claude-community

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about designer-notes

How to install designer-notes in Claude Code?

Add the community marketplace via /plugin marketplace add anthropics/claude-plugins-community, then run /plugin install designer-notes@claude-community.

What does designer-notes do?

It runs a local server and injects an overlay into your HTML. You can pin notes or edit text in the browser, then have Claude Code inspect the markdown summary and update your source code.

What are the prerequisites for designer-notes?

It requires Node.js 14 or newer to run its local dev server, alongside any modern web browser.

Source text

SKILL.md · MIT
# designer-notes

Pin comments to HTML elements, just like Figma. Then hand off to Claude Code, Cursor, or Codex to apply the changes.

Learn more at [arturnbull.github.io/designer-notes-landing-page](https://arturnbull.github.io/designer-notes-landing-page/)

## Install

### Claude Code

```bash
npx designer-notes
```

This installs two Claude Code skills and the tool files to `~/.claude/skills/`.

### Cursor (experimental)

```bash
npx designer-notes --cursor
```

This installs tool files to `~/.cursor/designer-notes/` and slash commands to your project's `.cursor/commands/` directory. Cursor support is experimental — the core commenting workflow works, but Claude Code-specific features (model directives, skill invocations, parallel processing) are not available.

### Codex CLI (experimental)

```bash
npx designer-notes --codex
```

This installs skill files to `~/.agents/skills/` for use with OpenAI's Codex CLI. Codex support is experimental — setup runs inline from the skill prompt (no hooks), and model directives map to OpenAI models (`#o3`, `#gpt-4o`, `#o4-mini`).

### Update

```bash
npx designer-notes@latest --force
```

## Quick start

1. Open Claude Code in any project with HTML files
2. Run `/designer-notes` — it adds the script and starts the dev server
3. Press **C** to comment on elements, or **T** to edit text directly
4. Run `/submit-feedback` — Claude reads your feedback and edits the code

## What it does

**designer-notes** is a browser-based commenting tool for reviewing AI-generated UI. It gives you a Figma-like workflow for leaving design feedback directly on rendered HTML pages.

Every comment is saved with its CSS selector and click position into a structured markdown file. When you run `/submit-feedback`, Claude reads that file and applies each change to the source code.

### Features

- **Pin notes to any element** — click a heading, button, or card to attach feedback
- **Inline text editing** — click any text element to edit it directly in the browser, Figma-style. Before/after changes are exported as structured diffs and applied automatically
- **Batch reviews** — leave all your notes first, submit once
- **Slash commands** — use your environment's existing Claude skills
- **Model directives** — use `#opus`, `#sonnet`, or `#haiku` per comment
- **Effort directives** — use `#high-effort`, `#medium-effort`, or `#low-effort`
- **Auto-save** — comments and text edits persist and export to markdown automatically
- **Viewport tracking** — feedback includes window size so changes target the right breakpoint
- **Changelog** — cumulative HTML changelog generated after each feedback round

### Keyboard shortcuts

| Key | Action |
|-----|--------|
| `C` | Toggle comment mode |
| `T` | Toggle text edit mode |
| `⌘\` | Open / close sidepanel |
| `⌘.` | Show / hide all UI |

## Manual install

If you don't have npm, download the files directly:

```bash
mkdir -p ~/.claude/skills/designer-notes ~/.claude/skills/submit-feedback

# Tool files
curl -fsSL https://raw.githubusercontent.com/arturnbull/designer-notes/main/designer-notes.js \
  -o ~/.claude/skills/designer-notes/designer-notes.js
curl -fsSL https://raw.githubusercontent.com/arturnbull/designer-notes/main/serve.js \
  -o ~/.claude/skills/designer-notes/serve.js
curl -fsSL https://raw.githubusercontent.com/arturnbull/designer-notes/main/changelog-template.html \
  -o ~/.claude/skills/designer-notes/changelog-template.html

# Skill files
curl -fsSL https://raw.githubusercontent.com/arturnbull/designer-notes/main/skills/designer-notes/SKILL.md \
  -o ~/.claude/skills/designer-notes/SKILL.md
curl -fsSL https://raw.githubusercontent.com/arturnbull/designer-notes/main/skills/submit-feedback/SKILL.md \
  -o ~/.claude/skills/submit-feedback/SKILL.md
```

Then restart Claude Code.

## How it works

1. `/designer-notes` adds a `<script>` tag to your HTML and starts a local dev server
2. The server auto-finds an open port (defaults to 3847, increments if in use)
3. Three floating buttons appear in the bottom-right: text edit (pencil), comment (speech bubble), and panel (ellipsis)
4. Press **C** to enter comment mode — click elements to place numbered pins and type feedback
5. Press **T** to enter text edit mode — click any text element to edit it inline. Accept with Enter, dismiss with Esc. Re-editing the same element updates the existing entry
6. Use `/skills` and `#directives` in comment popovers for advanced control
7. All feedback auto-saves to `feedback-YYYY-MM-DD.md` in your project directory
8. `/submit-feedback` parses the markdown, locates each element in source, and applies changes. Text edits are applied via haiku for speed
9. After changes are applied, the browser clears automatically for the next review round

## Requirements

- [Claude Code](https://claude.ai/code), [Cursor](https://cursor.com), or [Codex CLI](https://github.com/openai/codex)
- Node.js 14+ (for the dev server)
- Any modern browser

## Uninstall

Claude Code:
```bash
rm -rf ~/.claude/skills/designer-notes ~/.claude/skills/submit-feedback
```

Cursor:
```bash
rm -rf ~/.cursor/designer-notes
rm .cursor/commands/designer-notes.md .cursor/commands/submit-feedback.md
```

Codex:
```bash
rm -rf ~/.agents/skills/designer-notes ~/.agents/skills/submit-feedback
```

## Links

- [Landing page](https://arturnbull.github.io/designer-notes-landing-page/)
- [GitHub](https://github.com/arturnbull/designer-notes)
- [npm](https://www.npmjs.com/package/designer-notes)

## License

MIT

© arturnbull · MIT · arturnbull/designer-notes

Similar plugins

All plugins for Design →

Project sponsors

Companies that keep this analytics open