feedback-to-cli

Click-to-pin feedback on any localhost page. Copy the markdown straight to your AI CLI.

You're vibe-coding with Claude Code, Cursor, or Copilot CLI. You see something off in the browser. Today you screenshot it, describe it in words, paste. Lossy. Slow.

feedback-to-cli collapses that to: click on the thing → type a sentence → "copy all" → paste markdown back to your CLI. With the optional companion process, the paste step disappears too.

Quick start (script tag)

<script src="https://unpkg.com/feedback-to-cli@0"></script>

Drop that on any locally-served page. Click anywhere to pin. Toolbar bottom-right has on/off, clear, copy-all.

Pins persist in localStorage scoped to the pathname. Works in static HTML, Next.js dev, Vite dev, Astro dev — anything that renders HTML on localhost.

Optional: companion server

npx feedback-to-cli serve

Or install it locally: npm install -D feedback-to-cli and run npx feedback-to-cli serve from a script.

Run from your project root. The overlay auto-detects it once at boot. Every save also writes to .feedback-to-cli/<page-slug>.md in the cwd, ready for your assistant to read directly.

.feedback-to-cli/
  home.md
  east-village_abc.md

Tip: add .feedback-to-cli/ to your project's .gitignore so pinned feedback doesn't end up in commits.

Started the companion mid-session? Reload the page so the overlay picks it up.

The companion only accepts requests from localhost, 127.0.0.1, and [::1] origins. If your dev server is on a custom hostname (e.g. my-app.test), open it via http://localhost:<port> while using this tool — pins from other origins fall back to localStorage only and won't reach disk.

Customization

Two data-* attributes on the script tag:

<script
  src="https://unpkg.com/feedback-to-cli@0"
  data-namespace="my-app"
  data-companion-port="9091"
></script>

That's the whole API.

Examples

• examples/static-html/ — drop-in script tag
• examples/nextjs/ — app/layout.tsx snippet
• examples/vite/ — index.html snippet

What lands in the clipboard

# Feedback on /home

Total pins: 2

## Pin #1
**Target:** `<button> List Yours →`
**Note:**
```
make this primary, not ghost
```

## Pin #2
**Target:** `<h1> NYC's only short-term rental search…`
**Note:** _(empty)_

License

MIT © Brooke Bekoff