@@ -43,6 +43,24 @@ Click, and a prompt opens for that widget. Ask for a change to it, or for a new
4343
4444 When the build passes, it goes on trial. The app loads it at once, and you try it out. Then hover the belt in the title bar and click **Keep** to merge the build into your library, or **Discard** to drop it. If a build breaks the app, start it with `--safe` to keep or discard builds without loading any widgets.
4545
46+### Ctrl+click your own web app
47+
48+Dev notes bring Ctrl+click to the web apps your projects build. The daemon serves a small script, `devnotes.js`, on `127.0.0.1:7717`. Load it in your app's dev build:
49+
50+```html
51+<script src="http://127.0.0.1:7717/devnotes.js" data-project="pomodoro" async onerror="this.remove()"></script>
52+```
53+
54+Hold Ctrl and the script outlines the element under the pointer. Click it, write what should change, and press Enter. The note becomes a ticket in the project that `data-project` names. The ticket carries the page's URL, the element's selector, text, and HTML, and the window size, so the agent can find the element in the source. Check **Ready?** to start the ticket at once, or leave it unchecked to file a draft. Your app never sees a click made while Ctrl is held.
55+
56+If your app uses Ctrl+click itself, set `data-key` on the tag to `alt`, `shift`, or `meta`.
57+
58+Only pages served from localhost can file notes, because every ticket runs an agent that holds your keys. When the daemon isn't running, `onerror` removes the tag and your app runs as usual.
59+
60+You don't have to add the tag yourself. Every new project starts with a draft called **Dev notes** that asks an agent to add it to the dev build only, and to prove that a production build leaves it out. Edit the draft to fit the project, then move it to ready.
61+
62+Dev notes are based on the click-to-note overlay from [claudeweaver](https://github.com/statico/claudeweaver), by statico, under the MIT license.
63+
4664 ## Get started
4765
4866 You need:
@@ -118,7 +136,7 @@ A ticket moves through these states:
118136 | `failed` | The run ended without `done`. Move it to ready to try again. |
119137 | `done` | Merged. |
120138
121-Every new project starts with a draft called **Dev notes**. Move it to ready, and an agent adds a small script to your web app's dev build. With that script loaded, a Ctrl+click in your own running app files a ticket here, the same way it does in Conveyor.
139+Every new project starts with a draft called **Dev notes**. Move it to ready to [Ctrl+click your own web app](#ctrlclick-your-own-web-app) and file tickets from it.
122140
123141 ## Reference