htmlnote

Install

Three steps, in this order:

1. Install the binary

curl -fsSL https://raw.githubusercontent.com/DavelRad/htmlnote/main/install.sh | bash

Downloads a precompiled binary for your platform (macOS arm64/x64, Linux x64/arm64) to ~/.local/bin/htmlnote. Make sure that's on your PATH.

2. Register the plugin in Claude Code

Inside a Claude Code chat, run each line as a separate prompt (don't paste both at once):

/plugin marketplace add https://github.com/DavelRad/htmlnote.git

/plugin install htmlnote

3. Reload plugins

Inside Claude Code:

/reload-plugins

This loads the hooks immediately without restarting the app. Done.

How to use it

Ask Claude to write or edit any HTML file. When Claude finishes responding:

        you: "make me a landing page"
              ↓
      Claude writes/edits HTML
              ↓
  htmlnote tab opens automatically
              ↓
   click elements · leave notes
              ↓
        click Copy for chat
              ↓
       paste into chat · send
              ↓
    Claude applies your notes
              ↓
            (loop)

If your prompt isn't about HTML, no tab. Only fires when Claude actually wrote or edited an .html / .htm file in the turn that just ended.

Review any HTML file directly

htmlnote path/to/file.html

Opens the same UI for any HTML file, outside of Claude's flow.

Update

htmlnote --update

Pulls the latest release, verifies SHA256, swaps the binary in place. Won't downgrade.

Troubleshooting

/reload-plugins

htmlnote --stop
rm -rf ~/.htmlnote

git clone https://github.com/DavelRad/htmlnote
cd htmlnote
bash install.sh --local .

What it does NOT do

• Doesn't intercept non-HTML edits — only .html and .htm files
• Doesn't send anything to the network — daemon binds to 127.0.0.1 only, zero telemetry
• Doesn't auto-submit feedback — you explicitly Copy and paste; htmlnote never types into Claude on your behalf
• Doesn't loosen the iframe sandbox — AI-generated HTML runs sandbox="allow-scripts", no access to your host page or cookies

License

MIT