ZhuzhUp - install (about a minute)

ZhuzhUp lets you leave comments and make hands-on edits directly on any web
page, then turn all of it into one precise brief for an AI coding agent or a
developer. This is a pre-release build, so it installs by hand rather than
from the Chrome Web Store.

INSTALL

1. Unzip this file somewhere you won't delete later (Documents is fine).
   You should end up with a folder that has manifest.json inside it.
2. In Chrome, go to:  chrome://extensions
3. Turn ON "Developer mode" (toggle, top right).
4. Click "Load unpacked" (top left) and choose the folder from step 1.
   Pick the folder itself, not the zip and not a file inside it.
5. Click the puzzle-piece icon in the toolbar and pin ZhuzhUp so you can
   reach it easily.

Keep the unzipped folder where it is. Chrome loads the extension from that
folder every time it starts, so deleting or moving it uninstalls ZhuzhUp.

USING IT

- Click the ZhuzhUp icon to turn comment mode on for the page you're viewing.
  A bar appears at the bottom and the icon shows ON. Click it again to exit.
- Flip the switch to "Leave notes", then click anything on the page to attach
  a note to it. Type the note, add your name, save.
- "Move things" lets you drag an element somewhere else, grab an edge to
  resize it, or hover text to change its size. What you set is treated as the
  intended end state.
- Plain clicks still work normally while the switch is set to "Navigate page",
  so you can move around the site without dropping pins.
- Esc exits at any time.

HANDING OFF THE FEEDBACK

- "Copy Claude prompt" compiles every open note on the page into a single
  numbered brief and copies it to your clipboard. Paste that into Claude Code
  (or send it to whoever is making the changes). It includes what you pinned,
  where it sits in the page, and what you asked for.
- "Copy share link" puts your notes into the link itself. Send it to someone
  who also has ZhuzhUp installed and your pins appear on their screen.
- Mark a note done and it drops out of the next compiled brief.

SIGNING IN

"Copy Claude prompt" asks you to sign in first. It's free: enter your email,
and ZhuzhUp emails you a numeric code to paste back in. Everything else
(leaving notes, moving things, share links) works without an account.

Heads up: sign-in codes are rate limited on this pre-release backend. If your
code doesn't arrive within a couple of minutes, wait an hour and try again,
or tell Mishelle and she'll sort it out.

WHAT IT CAN SEE (please read this part)

ZhuzhUp asks Chrome for access to every site you visit. It genuinely needs
that: you can open it on any page, and it has to be there before the page
loads so a share link still works on sites that rewrite the address bar.

That is a real amount of trust to hand an extension that Google has not
reviewed yet, so here is exactly what it does with it. Nothing is read or sent
until you turn comment mode on for a page. It never sends the pages you visit.
The only thing it sends on its own is a one-line install count. Everything you
write stays on your machine until you sign in, and once you do it goes to your
own account and only you can read it.

If that is more than you want to grant a pre-release tool, that is a
completely reasonable call. Wait for the Chrome Web Store version, where
Google reviews it first.

KEEPING IT UP TO DATE

Chrome never updates an extension you loaded by hand. Your copy stays exactly
as it is until you download a new one, so ZhuzhUp will tell you in the bar when
a newer version is out, and there is a link there to get it. If a build ever
turns out to have a problem, that same notice is how you will hear about it.

To update: download the new zip, unzip it over the same folder, then click the
refresh arrow on the ZhuzhUp card at chrome://extensions.

PRIVACY

Your notes stay on your own machine until you sign in. Once signed in they
sync to your own account and only you can see them, apart from anything you
deliberately share via a share link. A note includes the address of the page
you pinned it to.

If you got here from a personal invite link, that link has a code in it that is
tied to your name, so we can see that you downloaded and installed it. That is
how we tell who is actually trying the pre-release. Nothing else about your
machine or your browsing is collected. Full policy:
https://zhuzhup.ai/privacy.html

Questions: hello@zhuzhup.ai
