opencode-notepad 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,46 @@
+MIT License
+
+Copyright (c) 2026 parzival1l
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+src/gui.css adapts task-list styling rules from Markdown Preview
+(https://github.com/pluk-inc/markdown-preview), used under the MIT License:
+
+Copyright (c) 2026 Pluk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,81 @@
-# Temporary Holding Version
+# opencode-notepad
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+An OpenCode Desktop plugin that adds a Markdown notepad to the session side panel, one per chat. The note's top section is a checklist. The coding agent can add to it, so "add this to the list" in chat is enough.
+
+## Parts
+
+- **Server** (`src/index.ts`) owns the note file and serializes every edit. It registers the agent tools and the `notepad` RPC.
+- **GUI** (`src/gui.tsx`, built to `dist/gui-experimental.cjs`) adds the **Notepad** side tab, a composer pill with the open-item count, and the **Toggle Notepad** command (`mod+alt+n`).
+- **RPC** (`src/rpc.ts`) is the contract between the two parts. The server emits `updated` on every change, including edits made in other apps.
+
+## Send a selection
+
+Highlight text anywhere in the window, such as part of a chat message. A floating bar appears above it:
+
+- **Quote** attaches the selection to your next message as a quote and opens its comment box, in one step.
+- **Add to list** adds each selected line as a checklist item. It drops list markers like `-`, `1.`, and `•`.
+- **Add to notes** appends the selection to the notes as a blockquote.
+
+The keyboard does the same: `mod+alt+l` sends the selection to the list, and `mod+alt+k` sends it to the notes. The bar stays hidden for selections inside inputs, the composer, and the Notepad itself. The GUI API has no hook into the timeline, so the bar reads the window's selection. Selected text arrives as plain text, without Markdown formatting.
+
+## Note format
+
+Each chat has its own plain Markdown file, `~/.local/share/opencode-notepad/<session ID>.md` (under `$XDG_DATA_HOME` when set). A subagent writes to its parent chat's note. A chat gets a file on its first edit. Set `options.dir` to keep the files elsewhere. The run of task lines at the very top is the checklist. Everything after the first non-task line is free Markdown.
+
+```markdown
+- [ ] Review the citation flow
+- [x] Ship the PR
+
+## Notes
+
+Anything you like.
+```
+
+## Agent tools
+
+All tools work on the calling chat's note.
+
+| Tool | What it does |
+|------|--------------|
+| `notepad.add` | Adds checklist items. Triggered by "add this to the list", "remind me to", and similar. |
+| `notepad.check` | Checks or unchecks items by text `query` or by `index`. |
+| `notepad.read` | Returns the numbered checklist and the notes. |
+| `notepad.append_note` | Appends Markdown to the notes section. |
+
+## Install
+
+Requires OpenCode Desktop 2.2.0 or later.
+
+1. Add the package to `plugins` in the global `~/.config/opencode/opencode.jsonc`. OpenCode Desktop loads GUI parts only from the global config.
+
+   ```jsonc
+   {
+     "plugins": [
+       "opencode-notepad",
+       // Or keep the notes in another folder:
+       // { "package": "opencode-notepad", "options": { "dir": "~/notes/opencode" } },
+     ],
+   }
+   ```
+
+2. Open a session, then pick **Notepad** from the side panel's **+** menu, or press `mod+alt+n`.
+
+OpenCode installs the package and reloads plugins when the config changes.
+
+## Develop
+
+1. Clone the repo, then run `bun install` and `bun run build`.
+2. In `plugins`, replace `"opencode-notepad"` with the absolute path of your clone.
+
+- `bun run dev` rebuilds the GUI on every change. Each rebuild reloads the GUI in every window.
+- The server reloads when a file in `src/` changes.
+- `bun test` covers the note format and the file store. `bun run typecheck` runs `tsc`.
+
+## Markdown Preview
+
+The toolbar button opens the note in [Markdown Preview](https://github.com/pluk-inc/markdown-preview) through its `md-preview://file/<path>` URL scheme. There you can read it with an outline, or click its checkboxes. The panel picks up those edits. The checklist styles adapt Markdown Preview's task-list rules (MIT): done items are muted, not struck through.
+
+## Limits
+
+- The server runs one plugin instance per project directory. Each instance serializes its own writes. Two instances that write to one chat's note in the same few milliseconds can still lose one edit.
+- The GUI API is experimental. This plugin pins `@opencode/plugin@2.2.0`, which matches OpenCode Desktop 2.2.0.

package/dist/gui-experimental.cjs

@@ -0,0 +1,5 @@
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});let e=require("solid-js/web"),t=require("solid-js"),n=require("solid-js/store"),r=require("@opencode/plugin/gui"),i=require("@opencode/plugin/rpc");var a=/^\s*[-*+]\s+\[( |x|X)\]\s?(.*)$/;function o(e){let t=e.replace(/\r\n?/g,`
+`).split(`
+`),n=[],r=0;for(;r<t.length;r++){let e=a.exec(t[r]);if(!e)break;n.push({checked:e[1]!==` `,text:e[2].trim()})}let i=t.slice(r);for(;i.length>0&&i[0].trim()===``;)i.shift();return{tasks:n,body:i.join(`
+`).trimEnd()}}function s(e){return e.replace(/^\s*(?:[-*+•]|\d+[.)])\s+(\[( |x|X)\]\s*)?/,``).replace(/\s*\n\s*/g,` `).trim()}function c(e){return e.split(/\r?\n/).map(s).filter(Boolean)}function l(e){return e.trim().split(/\r?\n/).map(e=>e.trim()?`> ${e.trimEnd()}`:`>`).join(`
+`)}var u={type:`string`,minLength:1},d={type:`object`,properties:{sessionID:u,doc:{type:`string`},path:{type:`string`}},required:[`sessionID`,`doc`,`path`],additionalProperties:!1},f={type:`integer`,minimum:0};function p(e){return{type:`object`,properties:{sessionID:u,...e},required:[`sessionID`,...Object.keys(e)],additionalProperties:!1}}var m=i.Rpc.define({id:`notepad`,methods:{read:{input:p({}),output:d},add:{input:p({items:{type:`array`,items:{type:`string`}}}),output:d},check:{input:p({index:f,checked:{type:`boolean`}}),output:d},remove:{input:p({index:f}),output:d},clearDone:{input:p({}),output:d},appendNote:{input:p({markdown:{type:`string`}}),output:d},setBody:{input:p({body:{type:`string`}}),output:d}},events:{updated:{schema:d}}}),h=(0,e.template)(`<div class=notepad-selection>`),g=(0,e.template)(`<span class=notepad-selection-divider>`),_=(0,e.template)(`<button type=button>`),v=`input, textarea, select, [contenteditable=''], [contenteditable='true'], .notepad, .notepad-selection`;function y(){let e=window.getSelection();if(!e||e.isCollapsed||e.rangeCount===0)return;let t=e.toString();if(!t.trim())return;let n=e.anchorNode;if((n instanceof Element?n:n?.parentElement)?.closest(v))return;let r=e.getRangeAt(0).getBoundingClientRect();if(r.width!==0||r.height!==0)return{text:t,top:r.top,left:r.left+r.width/2}}function b(n){let[r,i]=(0,t.createSignal)(),a,o=()=>{clearTimeout(a),a=setTimeout(()=>i(y()),120)},s=()=>i(void 0);(0,t.onMount)(()=>{document.addEventListener(`selectionchange`,o),window.addEventListener(`scroll`,s,!0),window.addEventListener(`resize`,s)}),(0,t.onCleanup)(()=>{clearTimeout(a),document.removeEventListener(`selectionchange`,o),window.removeEventListener(`scroll`,s,!0),window.removeEventListener(`resize`,s)});function c(e){let t=r();t&&(window.getSelection()?.removeAllRanges(),s(),e.run(t.text))}return(0,e.createComponent)(t.Show,{get when(){return r()},children:r=>(0,e.createComponent)(e.Portal,{get children(){var i=h();return i.$$mousedown=e=>e.preventDefault(),(0,e.insert)(i,(0,e.createComponent)(t.For,{get each(){return n.actions},children:(n,r)=>[(0,e.createComponent)(t.Show,{get when(){return r()>0},get children(){return g()}}),(()=>{var t=_();return t.$$click=()=>c(n),(0,e.insert)(t,()=>n.label),t})()]})),(0,e.effect)(t=>{var n=`${r().top<48?r().top+28:r().top-40}px`,a=`${Math.min(Math.max(r().left,160),window.innerWidth-160)}px`;return n!==t.e&&(0,e.setStyleProperty)(i,`top`,t.e=n),a!==t.t&&(0,e.setStyleProperty)(i,`left`,t.t=a),t},{e:void 0,t:void 0}),i}})})}(0,e.delegateEvents)([`mousedown`,`click`]);var x=`.notepad{box-sizing:border-box;flex-direction:column;gap:8px;height:100%;padding:10px 12px 16px;display:flex;overflow-y:auto}.notepad-toolbar{align-items:center;gap:4px;display:flex}.notepad-toolbar>:not(.notepad-add){flex-shrink:0}.notepad-add{flex:1;min-width:0;margin-right:2px}.notepad-add>*{width:100%}.notepad-tasks{margin:0;padding:0;list-style:none}.notepad-task{border-radius:6px;align-items:flex-start;gap:4px;padding:2px 2px 2px 4px;display:flex}.notepad-task:hover{background:color-mix(in srgb, currentColor 6%, transparent)}.notepad-task label{cursor:pointer;overflow-wrap:anywhere;flex:1;align-items:flex-start;gap:8px;min-width:0;padding:3px 0;line-height:1.4;display:flex}.notepad-task input[type=checkbox]{width:14px;height:14px;accent-color:var(--text-interactive-base,currentColor);cursor:pointer;flex-shrink:0;margin:2px 0 0}.notepad-task.is-done label span{opacity:.5}.notepad-remove{opacity:0;flex-shrink:0}.notepad-task:hover .notepad-remove,.notepad-remove:focus-visible{opacity:1}.notepad-clear{justify-content:flex-end;display:flex}.notepad-notes-header{border-top:1px solid color-mix(in srgb, currentColor 12%, transparent);opacity:.8;justify-content:space-between;align-items:center;margin-top:4px;padding-top:8px;font-size:12px;font-weight:600;display:flex}.notepad-empty{opacity:.5;margin:0;font-size:13px}.notepad-body{min-height:2em}.notepad-editor{resize:vertical;border:1px solid color-mix(in srgb, currentColor 18%, transparent);min-height:240px;color:inherit;tab-size:2;background:0 0;border-radius:6px;flex:1;padding:8px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12.5px;line-height:1.5}.notepad-editor:focus{border-color:color-mix(in srgb, currentColor 35%, transparent);outline:none}.notepad-selection{z-index:2147483000;color:#f4f4f4;background:#1f1f1f;border-radius:8px;align-items:center;padding:3px;font-size:12px;animation:.12s ease-out notepad-pop;display:flex;position:fixed;transform:translate(-50%);box-shadow:0 6px 20px #00000047,0 0 0 1px #ffffff14}.notepad-selection button{all:unset;cursor:pointer;white-space:nowrap;border-radius:5px;padding:4px 9px}.notepad-selection button:hover,.notepad-selection button:focus-visible{background:#ffffff24}.notepad-selection-divider{background:#ffffff2e;width:1px;height:14px}@keyframes notepad-pop{0%{opacity:0;transform:translate(-50%)translateY(4px)}}@media (prefers-reduced-motion:reduce){.notepad-selection{animation:none}}`,S=(0,e.template)(`<div class=notepad-clear>`),C=(0,e.template)(`<textarea class=notepad-editor autofocus>`),w=(0,e.template)(`<div class=notepad><div class=notepad-toolbar><div class=notepad-add></div></div><ul class=notepad-tasks></ul><div class=notepad-notes-header><span>`),T=(0,e.template)(`<li class=notepad-task><label><input type=checkbox><span>`),E=(0,e.template)(`<div class=notepad-body>`),D=(0,e.template)(`<p class=notepad-empty>`),O=r.Plugin.define({i18n:{en:{title:`Notepad`,"command.toggle":`Toggle Notepad`,"add.label":`Add a checklist item`,"add.placeholder":`Add an item and press Enter`,remove:`Remove item`,clearDone:`Clear done`,notes:`Notes`,"notes.empty":`No notes yet. Select Edit to write Markdown.`,edit:`Edit`,done:`Done`,openPreview:`Open in Markdown Preview`,openFile:`Open file in default app`,copyPath:`Copy file path`,pill:`{{count}} open`,"pill.title":`Notepad checklist`,"pill.open":`Open Notepad`,error:`Notepad: {{message}}`,"selection.quote":`Quote`,"selection.list":`Add to list`,"selection.notes":`Add to notes`,"command.selectionList":`Add selection to Notepad list`,"command.selectionNotes":`Add selection to Notepad notes`,"added.list":`Added {{count}} item(s) to the Notepad list`,"added.notes":`Added the selection to Notepad notes`,"quote.source":`Conversation`,"quote.unavailable":`This chat can't take a quote right now`,noChat:`Open a chat first`}},setup(i){let a=i.ui,u=`${i.id}:main`,[d,f]=(0,n.createStore)({}),p=new Set,h=e=>o(e&&d[e]?.doc||``);function g(e,t){f(e,t)}function _(e){d[e]||p.has(e)||(p.add(e),i.client.rpc(m).read({sessionID:e}).then(t=>g(e,t),v).finally(()=>p.delete(e)))}(0,r.createKeyed)(()=>i.servers.get(`sidecar`)?.client,e=>{let n=e.rpc(m);for(let e of Object.keys(d))n.read({sessionID:e}).then(t=>g(e,t),v);(0,t.onCleanup)(n.events.on(`updated`,e=>{let t=e.data;for(let[e,n]of Object.entries(d))n.sessionID===t.sessionID&&g(e,t);d[t.sessionID]||g(t.sessionID,t)}))});function v(e){i.toast.show({title:i.t(`error`,{message:e instanceof Error?e.message:String(e)}),variant:`error`})}function O(e,t,n){t(i.client.rpc(m)).then(t=>{g(e,t),n?.()},v)}function k(){let e=i.sessions.current();return e||i.toast.show({title:i.t(`noChat`)}),e}function A(e){let t=k(),n=c(e);t&&n.length!==0&&O(t.id,e=>e.add({sessionID:t.id,items:n}),()=>i.toast.show({title:i.t(`added.list`,{count:n.length}),variant:`success`,duration:2e3}))}function j(e){let t=k();t&&O(t.id,n=>n.appendNote({sessionID:t.id,markdown:l(e)}),()=>i.toast.show({title:i.t(`added.notes`),variant:`success`,duration:2e3}))}function M(e){let t=i.screen.current()?.composer;if(!t?.quotable()){i.toast.show({title:i.t(`quote.unavailable`)});return}let n=crypto.randomUUID();t.attach({type:`quote`,commentID:n,text:e.trim(),source:{label:i.t(`quote.source`),icon:`speech-bubble`,subject:`this conversation`}}),t.focus(n)}function N(){let e=i.sessions.current();e&&i.layout.toggle(u,e)}let P={id:`main`,get title(){return i.t(`title`)},closable:`compact`,fallback:!0};i.add(r.Style,x),i.add(r.Panel,{id:`main`,region:`side`,mobile:{get title(){return i.t(`title`)},order:60,kind:`menu`,icon:`checklist`},list:e=>e.open.includes(`main`)?[P]:[],enter:()=>document.querySelector(`.notepad-add input`)?.focus(),render:t=>(0,e.createComponent)(I,{get session(){return t.session}})}),i.add(r.Command,()=>({id:`toggle`,title:i.t(`command.toggle`),keywords:`notepad todo checklist notes markdown`,bind:`mod+alt+n`,enabled:!!i.sessions.current(),run:N}));let F=[{id:`quote`,get label(){return i.t(`selection.quote`)},run:M},{id:`list`,get label(){return i.t(`selection.list`)},run:A},{id:`notes`,get label(){return i.t(`selection.notes`)},run:j}];i.add(r.Slot,{at:`window.bottom`,render:()=>(0,e.createComponent)(b,{actions:F})});for(let[e,t,n]of[[`selection-list`,`mod+alt+l`,A],[`selection-notes`,`mod+alt+k`,j]])i.add(r.Command,()=>({id:e,title:i.t(e===`selection-list`?`command.selectionList`:`command.selectionNotes`),keywords:`notepad selection highlight quote`,bind:t,run:()=>{let e=y();if(!e)return!1;window.getSelection()?.removeAllRanges(),n(e.text)}}));i.add(r.MenuItem,()=>{let e=i.sessions.current();return{menu:`session.panel`,id:`open`,title:i.t(`title`),icon:`checklist`,keybind:`${i.id}.toggle`,opened:!!e&&i.layout.state(u,e)!==`closed`,run:()=>{e&&i.layout.open(u,e)}}}),(0,r.createKeyed)(()=>i.sessions.current()?.id,e=>_(e)),i.add(r.ComposerPill,{id:`open`,show:e=>{let t=h(e.session.id).tasks.filter(e=>!e.checked);if(t.length!==0)return{icon:`checklist`,label:i.t(`pill`,{count:t.length}),title:i.t(`pill.title`),rows:[...t.slice(0,8).map((e,t)=>({id:`task-${t}`,label:e.text})),{id:`open`,label:i.t(`pill.open`),icon:`checklist`,run:()=>i.layout.open(u,e.session)}]}}});function I(n){let[o,c]=(0,t.createSignal)(``),[l,u]=(0,t.createSignal)(!1),[f,p]=(0,t.createSignal)(``),m,g=()=>n.session.id,v=()=>h(g()),y=()=>d[g()]?.path??``;(0,t.createEffect)(()=>_(g())),(0,r.createKeyed)(g,e=>{(0,t.onCleanup)(()=>{l()&&k(e),u(!1)})});function b(e){if(!s(e))return;c(``);let t=g();O(t,n=>n.add({sessionID:t,items:[e]}))}function x(){p(v().body),u(!0)}function k(e=g()){clearTimeout(m),f()!==h(e).body&&O(e,t=>t.setBody({sessionID:e,body:f()}))}function A(){k(),u(!1)}return(()=>{var n=w(),r=n.firstChild,s=r.firstChild,u=r.nextSibling,d=u.nextSibling,h=d.firstChild;return(0,e.insert)(s,(0,e.createComponent)(a.TextInput,{get label(){return i.t(`add.label`)},get placeholder(){return i.t(`add.placeholder`)},get value(){return o()},onInput:c,onSubmit:b})),(0,e.insert)(r,(0,e.createComponent)(a.Tooltip,{get value(){return i.t(`openPreview`)},get children(){return(0,e.createComponent)(a.IconButton,{icon:`square-arrow-top-right`,get label(){return i.t(`openPreview`)},variant:`ghost`,size:`small`,get disabled(){return!y()},onClick:()=>i.system.openExternal(`md-preview://file${encodeURI(y())}`)})}}),null),(0,e.insert)(r,(0,e.createComponent)(a.Menu,{get label(){return i.t(`title`)},icon:`outline-dots`,placement:`bottom-end`,get items(){return[{label:i.t(`openFile`),icon:`open-file`,onSelect:()=>i.system.openExternal(`file://${encodeURI(y())}`)},{label:i.t(`copyPath`),icon:`copy`,onSelect:()=>void i.system.copy(y())}]}}),null),(0,e.insert)(u,(0,e.createComponent)(t.For,{get each(){return v().tasks},children:(t,n)=>(()=>{var r=T(),o=r.firstChild.firstChild,s=o.nextSibling;return o.addEventListener(`change`,e=>{let t=e.currentTarget.checked,r=g();O(r,e=>e.check({sessionID:r,index:n(),checked:t}))}),(0,e.insert)(s,()=>t.text),(0,e.insert)(r,(0,e.createComponent)(a.IconButton,{icon:`xmark-small`,get label(){return i.t(`remove`)},variant:`ghost-muted`,size:`small`,class:`notepad-remove`,onClick:()=>{let e=g();O(e,t=>t.remove({sessionID:e,index:n()}))}}),null),(0,e.effect)(()=>r.classList.toggle(`is-done`,!!t.checked)),(0,e.effect)(()=>o.checked=t.checked),r})()})),(0,e.insert)(n,(0,e.createComponent)(t.Show,{get when(){return v().tasks.some(e=>e.checked)},get children(){var t=S();return(0,e.insert)(t,(0,e.createComponent)(a.Button,{variant:`ghost-muted`,size:`small`,onClick:()=>{let e=g();O(e,t=>t.clearDone({sessionID:e}))},get children(){return i.t(`clearDone`)}})),t}}),d),(0,e.insert)(h,()=>i.t(`notes`)),(0,e.insert)(d,(0,e.createComponent)(a.Button,{variant:`ghost`,size:`small`,get icon(){return l()?`check`:`pencil-line`},onClick:()=>l()?A():x(),get children(){return(0,e.memo)(()=>!!l())()?i.t(`done`):i.t(`edit`)}}),null),(0,e.insert)(n,(0,e.createComponent)(t.Show,{get when(){return l()},get fallback(){return(0,e.createComponent)(t.Show,{get when(){return v().body},get fallback(){return(()=>{var t=D();return(0,e.insert)(t,()=>i.t(`notes.empty`)),t})()},get children(){var t=E();return t.$$dblclick=x,(0,e.insert)(t,(0,e.createComponent)(a.Markdown,{get text(){return v().body}})),t}})},get children(){var t=C();return t.$$keydown=e=>{(e.key===`Escape`||e.key===`Enter`&&(e.metaKey||e.ctrlKey))&&(e.preventDefault(),A())},t.addEventListener(`blur`,()=>k()),t.$$input=e=>{p(e.currentTarget.value),clearTimeout(m),m=setTimeout(k,600)},(0,e.setAttribute)(t,`spellcheck`,!0),(0,e.effect)(()=>t.value=f()),t}}),null),n})()}}});(0,e.delegateEvents)([`input`,`keydown`,`dblclick`]),exports.default=O;

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "opencode-notepad",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "OpenCode Desktop side-panel notepad, one per chat: Markdown notes with a checklist the coding agent can add to.",
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "notepad",
+    "checklist",
+    "markdown"
+  ],
+  "type": "module",
+  "license": "MIT",
+  "author": "parzival1l",
+  "homepage": "https://github.com/parzival1l/opencode-notepad#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/parzival1l/opencode-notepad.git"
+  },
+  "bugs": "https://github.com/parzival1l/opencode-notepad/issues",
+  "exports": {
+    ".": "./src/index.ts",
+    "./rpc": "./src/rpc.ts",
+    "./gui-experimental": "./dist/gui-experimental.cjs"
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run typecheck && bun test && bun run build"
+  },
+  "dependencies": {
+    "@opencode/plugin": "2.2.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.4.4",
+    "solid-js": "^1.9.17",
+    "typescript": "^7.0.2",
+    "vite": "^8.3.5",
+    "vite-plugin-solid": "^2.11.14"
+  }
+}

package/src/gui.css

@@ -0,0 +1,149 @@
+/* Task-list rules adapted from pluk-inc/markdown-preview (MIT): done items are muted, not struck
+   through, so their text stays readable beside the checkbox. */
+.notepad {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  height: 100%;
+  overflow-y: auto;
+  padding: 10px 12px 16px;
+  box-sizing: border-box;
+}
+.notepad-toolbar {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+.notepad-toolbar > :not(.notepad-add) {
+  flex-shrink: 0;
+}
+.notepad-add {
+  flex: 1;
+  min-width: 0;
+  margin-right: 2px;
+}
+.notepad-add > * {
+  width: 100%;
+}
+.notepad-tasks {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+.notepad-task {
+  display: flex;
+  align-items: flex-start;
+  gap: 4px;
+  border-radius: 6px;
+  padding: 2px 2px 2px 4px;
+}
+.notepad-task:hover {
+  background: color-mix(in srgb, currentColor 6%, transparent);
+}
+.notepad-task label {
+  display: flex;
+  flex: 1;
+  min-width: 0;
+  align-items: flex-start;
+  gap: 8px;
+  padding: 3px 0;
+  cursor: pointer;
+  line-height: 1.4;
+  overflow-wrap: anywhere;
+}
+.notepad-task input[type="checkbox"] {
+  flex-shrink: 0;
+  margin: 2px 0 0;
+  width: 14px;
+  height: 14px;
+  accent-color: var(--text-interactive-base, currentColor);
+  cursor: pointer;
+}
+.notepad-task.is-done label span {
+  opacity: 0.5;
+}
+.notepad-remove {
+  flex-shrink: 0;
+  opacity: 0;
+}
+.notepad-task:hover .notepad-remove,
+.notepad-remove:focus-visible {
+  opacity: 1;
+}
+.notepad-clear {
+  display: flex;
+  justify-content: flex-end;
+}
+.notepad-notes-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  margin-top: 4px;
+  padding-top: 8px;
+  border-top: 1px solid color-mix(in srgb, currentColor 12%, transparent);
+  font-size: 12px;
+  font-weight: 600;
+  opacity: 0.8;
+}
+.notepad-empty {
+  margin: 0;
+  font-size: 13px;
+  opacity: 0.5;
+}
+.notepad-body {
+  min-height: 2em;
+}
+.notepad-editor {
+  flex: 1;
+  min-height: 240px;
+  resize: vertical;
+  padding: 8px;
+  border-radius: 6px;
+  border: 1px solid color-mix(in srgb, currentColor 18%, transparent);
+  background: transparent;
+  color: inherit;
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 12.5px;
+  line-height: 1.5;
+  tab-size: 2;
+}
+.notepad-editor:focus {
+  outline: none;
+  border-color: color-mix(in srgb, currentColor 35%, transparent);
+}
+.notepad-selection {
+  position: fixed;
+  z-index: 2147483000;
+  transform: translateX(-50%);
+  display: flex;
+  align-items: center;
+  padding: 3px;
+  border-radius: 8px;
+  background: #1f1f1f;
+  color: #f4f4f4;
+  box-shadow: 0 6px 20px rgb(0 0 0 / 0.28), 0 0 0 1px rgb(255 255 255 / 0.08);
+  font-size: 12px;
+  animation: notepad-pop 120ms ease-out;
+}
+.notepad-selection button {
+  all: unset;
+  padding: 4px 9px;
+  border-radius: 5px;
+  cursor: pointer;
+  white-space: nowrap;
+}
+.notepad-selection button:hover,
+.notepad-selection button:focus-visible {
+  background: rgb(255 255 255 / 0.14);
+}
+.notepad-selection-divider {
+  width: 1px;
+  height: 14px;
+  background: rgb(255 255 255 / 0.18);
+}
+@keyframes notepad-pop {
+  from { opacity: 0; transform: translateX(-50%) translateY(4px); }
+}
+@media (prefers-reduced-motion: reduce) {
+  .notepad-selection { animation: none; }
+}

package/src/gui.tsx

@@ -0,0 +1,459 @@
+import { createEffect, createSignal, For, onCleanup, Show } from "solid-js"
+import { createStore } from "solid-js/store"
+import {
+  Command,
+  ComposerPill,
+  createKeyed,
+  MenuItem,
+  Panel,
+  Plugin,
+  Slot,
+  Style,
+  type MountedSession,
+  type PanelTab,
+} from "@opencode/plugin/gui"
+import * as Note from "./note"
+import { Notepad, type State } from "./rpc"
+import { readSelection, SelectionBar, type SelectionAction } from "./selection"
+import css from "./gui.css?inline"
+
+export default Plugin.define({
+  i18n: {
+    en: {
+      title: "Notepad",
+      "command.toggle": "Toggle Notepad",
+      "add.label": "Add a checklist item",
+      "add.placeholder": "Add an item and press Enter",
+      remove: "Remove item",
+      clearDone: "Clear done",
+      notes: "Notes",
+      "notes.empty": "No notes yet. Select Edit to write Markdown.",
+      edit: "Edit",
+      done: "Done",
+      openPreview: "Open in Markdown Preview",
+      openFile: "Open file in default app",
+      copyPath: "Copy file path",
+      pill: "{{count}} open",
+      "pill.title": "Notepad checklist",
+      "pill.open": "Open Notepad",
+      error: "Notepad: {{message}}",
+      "selection.quote": "Quote",
+      "selection.list": "Add to list",
+      "selection.notes": "Add to notes",
+      "command.selectionList": "Add selection to Notepad list",
+      "command.selectionNotes": "Add selection to Notepad notes",
+      "added.list": "Added {{count}} item(s) to the Notepad list",
+      "added.notes": "Added the selection to Notepad notes",
+      "quote.source": "Conversation",
+      "quote.unavailable": "This chat can't take a quote right now",
+      "noChat": "Open a chat first",
+    },
+  },
+  setup(ctx) {
+    const ui = ctx.ui
+    const key = `${ctx.id}:main`
+
+    // Notes by the session ID the window asked for. A subagent's entry holds its parent chat's note.
+    const [docs, setDocs] = createStore<Record<string, State>>({})
+    const loading = new Set<string>()
+
+    const noteOf = (sessionID: string | undefined) => Note.parse((sessionID && docs[sessionID]?.doc) || "")
+
+    function put(requested: string, state: State) {
+      setDocs(requested, state)
+    }
+
+    function load(sessionID: string) {
+      if (docs[sessionID] || loading.has(sessionID)) return
+      loading.add(sessionID)
+      ctx.client
+        .rpc(Notepad)
+        .read({ sessionID })
+        .then((value) => put(sessionID, value as State), fail)
+        .finally(() => loading.delete(sessionID))
+    }
+
+    // One run per server client: reload what this window shows, then follow every change the server reports.
+    createKeyed(
+      () => ctx.servers.get("sidecar")?.client,
+      (client) => {
+        const pad = client.rpc(Notepad)
+        for (const sessionID of Object.keys(docs)) {
+          void pad.read({ sessionID }).then((value) => put(sessionID, value as State), fail)
+        }
+        onCleanup(
+          pad.events.on("updated", (event) => {
+            const state = event.data as unknown as State
+            for (const [requested, current] of Object.entries(docs)) {
+              if (current.sessionID === state.sessionID) put(requested, state)
+            }
+            if (!docs[state.sessionID]) put(state.sessionID, state)
+          }),
+        )
+      },
+    )
+
+    function fail(error: unknown) {
+      ctx.toast.show({
+        title: ctx.t("error", { message: error instanceof Error ? error.message : String(error) }),
+        variant: "error",
+      })
+    }
+
+    type Pad = ReturnType<typeof ctx.client.rpc<typeof Notepad>>
+
+    function call(sessionID: string, run: (pad: Pad) => Promise<unknown>, done?: () => void) {
+      run(ctx.client.rpc(Notepad)).then((value) => {
+        put(sessionID, value as State)
+        done?.()
+      }, fail)
+    }
+
+    function currentChat(): MountedSession | undefined {
+      const session = ctx.sessions.current()
+      if (!session) ctx.toast.show({ title: ctx.t("noChat") })
+      return session
+    }
+
+    function selectionToList(text: string) {
+      const session = currentChat()
+      const items = Note.toItems(text)
+      if (!session || items.length === 0) return
+      call(
+        session.id,
+        (pad) => pad.add({ sessionID: session.id, items }),
+        () => ctx.toast.show({ title: ctx.t("added.list", { count: items.length }), variant: "success", duration: 2000 }),
+      )
+    }
+
+    function selectionToNotes(text: string) {
+      const session = currentChat()
+      if (!session) return
+      call(
+        session.id,
+        (pad) => pad.appendNote({ sessionID: session.id, markdown: Note.quote(text) }),
+        () => ctx.toast.show({ title: ctx.t("added.notes"), variant: "success", duration: 2000 }),
+      )
+    }
+
+    // Attaches the selection to the next prompt as a quote and opens its comment box: one step.
+    function selectionToQuote(text: string) {
+      const composer = ctx.screen.current()?.composer
+      if (!composer?.quotable()) {
+        ctx.toast.show({ title: ctx.t("quote.unavailable") })
+        return
+      }
+      const commentID = crypto.randomUUID()
+      composer.attach({
+        type: "quote",
+        commentID,
+        text: text.trim(),
+        source: { label: ctx.t("quote.source"), icon: "speech-bubble", subject: "this conversation" },
+      })
+      composer.focus(commentID)
+    }
+
+    function toggle() {
+      const session = ctx.sessions.current()
+      if (session) ctx.layout.toggle(key, session)
+    }
+
+    const tab: PanelTab = {
+      id: "main",
+      get title() {
+        return ctx.t("title")
+      },
+      closable: "compact",
+      fallback: true,
+    }
+
+    ctx.add(Style, css)
+
+    ctx.add(Panel, {
+      id: "main",
+      region: "side",
+      mobile: {
+        get title() {
+          return ctx.t("title")
+        },
+        order: 60,
+        kind: "menu",
+        icon: "checklist",
+      },
+      list: (input) => (input.open.includes("main") ? [tab] : []),
+      enter: () => document.querySelector<HTMLInputElement>(".notepad-add input")?.focus(),
+      render: (props) => <NotepadView session={props.session} />,
+    })
+
+    ctx.add(
+      Command,
+      (): Command => ({
+        id: "toggle",
+        title: ctx.t("command.toggle"),
+        keywords: "notepad todo checklist notes markdown",
+        bind: "mod+alt+n",
+        enabled: !!ctx.sessions.current(),
+        run: toggle,
+      }),
+    )
+
+    // Highlight text anywhere in the window (outside inputs) to get a floating bar: Quote, Add to list, Add to notes.
+    const actions: SelectionAction[] = [
+      {
+        id: "quote",
+        get label() {
+          return ctx.t("selection.quote")
+        },
+        run: selectionToQuote,
+      },
+      {
+        id: "list",
+        get label() {
+          return ctx.t("selection.list")
+        },
+        run: selectionToList,
+      },
+      {
+        id: "notes",
+        get label() {
+          return ctx.t("selection.notes")
+        },
+        run: selectionToNotes,
+      },
+    ]
+    ctx.add(Slot, { at: "window.bottom", render: () => <SelectionBar actions={actions} /> })
+
+    for (const [id, bind, send] of [
+      ["selection-list", "mod+alt+l", selectionToList],
+      ["selection-notes", "mod+alt+k", selectionToNotes],
+    ] as const) {
+      ctx.add(
+        Command,
+        (): Command => ({
+          id,
+          title: ctx.t(id === "selection-list" ? "command.selectionList" : "command.selectionNotes"),
+          keywords: "notepad selection highlight quote",
+          bind,
+          run: () => {
+            const picked = readSelection()
+            if (!picked) return false
+            window.getSelection()?.removeAllRanges()
+            send(picked.text)
+          },
+        }),
+      )
+    }
+
+    ctx.add(MenuItem, (): MenuItem => {
+      const session = ctx.sessions.current()
+      return {
+        menu: "session.panel",
+        id: "open",
+        title: ctx.t("title"),
+        icon: "checklist",
+        keybind: `${ctx.id}.toggle`,
+        opened: !!session && ctx.layout.state(key, session) !== "closed",
+        run: () => {
+          if (session) ctx.layout.open(key, session)
+        },
+      }
+    })
+
+    // Load the routed chat's note so its pill shows without opening the panel.
+    createKeyed(
+      () => ctx.sessions.current()?.id,
+      (sessionID) => load(sessionID),
+    )
+
+    ctx.add(ComposerPill, {
+      id: "open",
+      show: (input) => {
+        const open = noteOf(input.session.id).tasks.filter((task) => !task.checked)
+        if (open.length === 0) return undefined
+        return {
+          icon: "checklist",
+          label: ctx.t("pill", { count: open.length }),
+          title: ctx.t("pill.title"),
+          rows: [
+            ...open.slice(0, 8).map((task, i) => ({ id: `task-${i}`, label: task.text })),
+            {
+              id: "open",
+              label: ctx.t("pill.open"),
+              icon: "checklist" as const,
+              run: () => ctx.layout.open(key, input.session),
+            },
+          ],
+        }
+      },
+    })
+
+    function NotepadView(props: { readonly session: MountedSession }) {
+      const [draft, setDraft] = createSignal("")
+      const [editing, setEditing] = createSignal(false)
+      const [body, setBody] = createSignal("")
+      let timer: ReturnType<typeof setTimeout> | undefined
+
+      const id = () => props.session.id
+      const note = () => noteOf(id())
+      const path = () => docs[id()]?.path ?? ""
+
+      createEffect(() => load(id()))
+
+      // Switching chats while editing saves the old chat's draft first.
+      createKeyed(id, (sessionID) => {
+        onCleanup(() => {
+          if (editing()) save(sessionID)
+          setEditing(false)
+        })
+      })
+
+      function add(value: string) {
+        if (!Note.clean(value)) return
+        setDraft("")
+        const sessionID = id()
+        call(sessionID, (pad) => pad.add({ sessionID, items: [value] }))
+      }
+
+      function startEdit() {
+        setBody(note().body)
+        setEditing(true)
+      }
+
+      function save(sessionID = id()) {
+        clearTimeout(timer)
+        if (body() !== noteOf(sessionID).body) call(sessionID, (pad) => pad.setBody({ sessionID, body: body() }))
+      }
+
+      function finishEdit() {
+        save()
+        setEditing(false)
+      }
+
+      return (
+        <div class="notepad">
+          <div class="notepad-toolbar">
+            <div class="notepad-add">
+              <ui.TextInput
+                label={ctx.t("add.label")}
+                placeholder={ctx.t("add.placeholder")}
+                value={draft()}
+                onInput={setDraft}
+                onSubmit={add}
+              />
+            </div>
+            <ui.Tooltip value={ctx.t("openPreview")}>
+              <ui.IconButton
+                icon="square-arrow-top-right"
+                label={ctx.t("openPreview")}
+                variant="ghost"
+                size="small"
+                disabled={!path()}
+                onClick={() => ctx.system.openExternal(`md-preview://file${encodeURI(path())}`)}
+              />
+            </ui.Tooltip>
+            <ui.Menu
+              label={ctx.t("title")}
+              icon="outline-dots"
+              placement="bottom-end"
+              items={[
+                {
+                  label: ctx.t("openFile"),
+                  icon: "open-file",
+                  onSelect: () => ctx.system.openExternal(`file://${encodeURI(path())}`),
+                },
+                { label: ctx.t("copyPath"), icon: "copy", onSelect: () => void ctx.system.copy(path()) },
+              ]}
+            />
+          </div>
+
+          <ul class="notepad-tasks">
+            <For each={note().tasks}>
+              {(task, i) => (
+                <li class="notepad-task" classList={{ "is-done": task.checked }}>
+                  <label>
+                    <input
+                      type="checkbox"
+                      checked={task.checked}
+                      onChange={(event) => {
+                        const checked = event.currentTarget.checked
+                        const sessionID = id()
+                        call(sessionID, (pad) => pad.check({ sessionID, index: i(), checked }))
+                      }}
+                    />
+                    <span>{task.text}</span>
+                  </label>
+                  <ui.IconButton
+                    icon="xmark-small"
+                    label={ctx.t("remove")}
+                    variant="ghost-muted"
+                    size="small"
+                    class="notepad-remove"
+                    onClick={() => {
+                      const sessionID = id()
+                      call(sessionID, (pad) => pad.remove({ sessionID, index: i() }))
+                    }}
+                  />
+                </li>
+              )}
+            </For>
+          </ul>
+          <Show when={note().tasks.some((task) => task.checked)}>
+            <div class="notepad-clear">
+              <ui.Button
+                variant="ghost-muted"
+                size="small"
+                onClick={() => {
+                  const sessionID = id()
+                  call(sessionID, (pad) => pad.clearDone({ sessionID }))
+                }}
+              >
+                {ctx.t("clearDone")}
+              </ui.Button>
+            </div>
+          </Show>
+
+          <div class="notepad-notes-header">
+            <span>{ctx.t("notes")}</span>
+            <ui.Button
+              variant="ghost"
+              size="small"
+              icon={editing() ? "check" : "pencil-line"}
+              onClick={() => (editing() ? finishEdit() : startEdit())}
+            >
+              {editing() ? ctx.t("done") : ctx.t("edit")}
+            </ui.Button>
+          </div>
+          <Show
+            when={editing()}
+            fallback={
+              <Show when={note().body} fallback={<p class="notepad-empty">{ctx.t("notes.empty")}</p>}>
+                <div class="notepad-body" onDblClick={startEdit}>
+                  <ui.Markdown text={note().body} />
+                </div>
+              </Show>
+            }
+          >
+            <textarea
+              class="notepad-editor"
+              value={body()}
+              spellcheck={true}
+              autofocus
+              onInput={(event) => {
+                setBody(event.currentTarget.value)
+                clearTimeout(timer)
+                timer = setTimeout(save, 600)
+              }}
+              onBlur={() => save()}
+              onKeyDown={(event) => {
+                if (event.key === "Escape" || (event.key === "Enter" && (event.metaKey || event.ctrlKey))) {
+                  event.preventDefault()
+                  finishEdit()
+                }
+              }}
+            />
+          </Show>
+        </div>
+      )
+    }
+  },
+})

package/src/index.ts

@@ -0,0 +1,164 @@
+import { Plugin } from "@opencode/plugin"
+import * as Note from "./note"
+import { Notepad, type State } from "./rpc"
+import { createNotebook, resolveDir } from "./store"
+
+function listing(doc: string, file: string): string {
+  const note = Note.parse(doc)
+  const tasks = note.tasks.length
+    ? note.tasks.map((task, i) => `${i}. [${task.checked ? "x" : " "}] ${task.text}`).join("\n")
+    : "(no checklist items)"
+  return `Notepad for this chat: ${file}\n\nChecklist (index. [state] text):\n${tasks}\n\nNotes:\n${note.body || "(empty)"}`
+}
+
+export default Plugin.define({
+  id: "notepad",
+  async setup(ctx) {
+    let emit: (state: State) => void = () => {}
+    const book = createNotebook(resolveDir(ctx.options.dir), (sessionID, doc) =>
+      emit({ sessionID, doc, path: book.path(sessionID) }),
+    )
+
+    // A chat and its subagents share one notepad: the top-level session's.
+    const roots = new Map<string, string>()
+    async function root(sessionID: string): Promise<string> {
+      const known = roots.get(sessionID)
+      if (known) return known
+      let current = sessionID
+      for (let depth = 0; depth < 16; depth++) {
+        const info = await ctx.session.get({ sessionID: current }).catch(() => undefined)
+        if (!info?.parentID) break
+        current = info.parentID
+      }
+      roots.set(sessionID, current)
+      return current
+    }
+
+    async function edit(sessionID: string, change: (doc: string) => string): Promise<State> {
+      const id = await root(sessionID)
+      return { sessionID: id, doc: await book.update(id, change), path: book.path(id) }
+    }
+
+    const rpc = await ctx.rpc.register(Notepad, {
+      read: async (input) => {
+        const id = await root((input as { sessionID: string }).sessionID)
+        return { sessionID: id, doc: await book.read(id), path: book.path(id) }
+      },
+      add: async (input) => {
+        const { sessionID, items } = input as { sessionID: string; items: string[] }
+        return edit(sessionID, (doc) => Note.addTasks(doc, items))
+      },
+      check: async (input) => {
+        const { sessionID, index, checked } = input as { sessionID: string; index: number; checked: boolean }
+        return edit(sessionID, (doc) => Note.setChecked(doc, index, checked))
+      },
+      remove: async (input) => {
+        const { sessionID, index } = input as { sessionID: string; index: number }
+        return edit(sessionID, (doc) => Note.removeTask(doc, index))
+      },
+      clearDone: async (input) => edit((input as { sessionID: string }).sessionID, Note.clearDone),
+      appendNote: async (input) => {
+        const { sessionID, markdown } = input as { sessionID: string; markdown: string }
+        return edit(sessionID, (doc) => Note.appendBody(doc, markdown))
+      },
+      setBody: async (input) => {
+        const { sessionID, body } = input as { sessionID: string; body: string }
+        return edit(sessionID, (doc) => Note.setBody(doc, body))
+      },
+    })
+    emit = (state) => void rpc.events.emit("updated", { ...state }).catch(() => undefined)
+    const unwatch = await book.watch()
+
+    await ctx.tool.transform((editor) => {
+      editor.namespace({
+        name: "notepad",
+        description:
+          "This chat's Notepad: a Markdown note in the OpenCode Desktop side panel, one per chat. Its top section is a " +
+          'checklist. When the user says "add this to the list", "put that on my list", or "note that down", call notepad.add.',
+      })
+      editor.add({
+        name: "add",
+        description:
+          "Add one or more items to the top checklist of this chat's Notepad. Use when the user says \"add this to the " +
+          'list", "add to my notepad", "remind me to", or similar. Write each item as a short, self-contained line; ' +
+          'resolve "this" or "that" from the conversation.',
+        input: {
+          type: "object",
+          properties: {
+            items: { type: "array", items: { type: "string" }, minItems: 1, description: "One checklist line each." },
+          },
+          required: ["items"],
+          additionalProperties: false,
+        },
+        options: { namespace: "notepad", codemode: true, pinned: true },
+        async execute(input, context) {
+          const { items } = input as { items: string[] }
+          const state = await edit(context.sessionID, (doc) => Note.addTasks(doc, items))
+          const total = Note.parse(state.doc).tasks.length
+          return { content: `Added ${items.length} item(s) to this chat's Notepad checklist (${total} total).` }
+        },
+      })
+      editor.add({
+        name: "check",
+        description:
+          "Check off (or uncheck) items in this chat's Notepad checklist. Match by `query` (case-insensitive text) or " +
+          "by `index` from notepad.read. A query that matches several items checks all of them.",
+        input: {
+          type: "object",
+          properties: {
+            query: { type: "string" },
+            index: { type: "integer", minimum: 0 },
+            checked: { type: "boolean", default: true },
+          },
+          additionalProperties: false,
+        },
+        options: { namespace: "notepad", codemode: true },
+        async execute(input, context) {
+          const { query, index, checked = true } = input as { query?: string; index?: number; checked?: boolean }
+          let matched: number[] = []
+          const state = await edit(context.sessionID, (current) => {
+            matched = index !== undefined ? [index] : Note.findTasks(current, query ?? "")
+            return matched.reduce((next, i) => Note.setChecked(next, i, checked), current)
+          })
+          if (matched.length === 0) return { content: `No checklist item matches.\n\n${listing(state.doc, state.path)}` }
+          const tasks = Note.parse(state.doc).tasks
+          const names = matched.map((i) => `- ${tasks[i]!.text}`).join("\n")
+          return { content: `${checked ? "Checked" : "Unchecked"} ${matched.length} item(s):\n${names}` }
+        },
+      })
+      editor.add({
+        name: "read",
+        description: "Read this chat's Notepad: the numbered checklist and the free Markdown notes below it.",
+        input: { type: "object", properties: {}, additionalProperties: false },
+        options: { namespace: "notepad", codemode: true },
+        async execute(_input, context) {
+          const id = await root(context.sessionID)
+          return { content: listing(await book.read(id), book.path(id)) }
+        },
+      })
+      editor.add({
+        name: "append_note",
+        description:
+          "Append Markdown to the free-form notes section of this chat's Notepad, below the checklist. Use for longer " +
+          "notes; use notepad.add for checklist items.",
+        input: {
+          type: "object",
+          properties: { markdown: { type: "string" } },
+          required: ["markdown"],
+          additionalProperties: false,
+        },
+        options: { namespace: "notepad", codemode: true },
+        async execute(input, context) {
+          const { markdown } = input as { markdown: string }
+          await edit(context.sessionID, (doc) => Note.appendBody(doc, markdown))
+          return { content: "Appended to this chat's Notepad notes." }
+        },
+      })
+    })
+
+    return async () => {
+      unwatch()
+      await rpc.dispose()
+    }
+  },
+})

package/src/note.ts

@@ -0,0 +1,97 @@
+// A note is one Markdown document. Its top section is the run of task lines at the very start
+// ("- [ ] item"); everything after the first non-task line is free Markdown, the body.
+
+export interface Task {
+  readonly text: string
+  readonly checked: boolean
+}
+
+export interface Note {
+  readonly tasks: readonly Task[]
+  readonly body: string
+}
+
+const TASK = /^\s*[-*+]\s+\[( |x|X)\]\s?(.*)$/
+
+export function parse(doc: string): Note {
+  const lines = doc.replace(/\r\n?/g, "\n").split("\n")
+  const tasks: Task[] = []
+  let i = 0
+  for (; i < lines.length; i++) {
+    const match = TASK.exec(lines[i]!)
+    if (!match) break
+    tasks.push({ checked: match[1] !== " ", text: match[2]!.trim() })
+  }
+  const rest = lines.slice(i)
+  while (rest.length > 0 && rest[0]!.trim() === "") rest.shift()
+  return { tasks, body: rest.join("\n").trimEnd() }
+}
+
+export function compose(note: Note): string {
+  const tasks = note.tasks.map((task) => `- [${task.checked ? "x" : " "}] ${task.text}`).join("\n")
+  const body = note.body.trimEnd()
+  const doc = tasks && body ? `${tasks}\n\n${body}` : tasks || body
+  return doc ? `${doc}\n` : ""
+}
+
+// Turns free text into one task line: drops a leading list or task marker, joins lines.
+export function clean(item: string): string {
+  return item
+    .replace(/^\s*(?:[-*+•]|\d+[.)])\s+(\[( |x|X)\]\s*)?/, "")
+    .replace(/\s*\n\s*/g, " ")
+    .trim()
+}
+
+export function addTasks(doc: string, items: readonly string[]): string {
+  const note = parse(doc)
+  const added = items.map(clean).filter(Boolean).map((text) => ({ text, checked: false }))
+  return compose({ ...note, tasks: [...note.tasks, ...added] })
+}
+
+export function setChecked(doc: string, index: number, checked: boolean): string {
+  const note = parse(doc)
+  if (!note.tasks[index]) throw new RangeError(`No task at index ${index}`)
+  return compose({ ...note, tasks: note.tasks.map((task, i) => (i === index ? { ...task, checked } : task)) })
+}
+
+export function removeTask(doc: string, index: number): string {
+  const note = parse(doc)
+  if (!note.tasks[index]) throw new RangeError(`No task at index ${index}`)
+  return compose({ ...note, tasks: note.tasks.filter((_, i) => i !== index) })
+}
+
+export function clearDone(doc: string): string {
+  const note = parse(doc)
+  return compose({ ...note, tasks: note.tasks.filter((task) => !task.checked) })
+}
+
+export function setBody(doc: string, body: string): string {
+  return compose({ ...parse(doc), body })
+}
+
+export function appendBody(doc: string, markdown: string): string {
+  const note = parse(doc)
+  const added = markdown.trim()
+  if (!added) return compose(note)
+  return compose({ ...note, body: note.body ? `${note.body}\n\n${added}` : added })
+}
+
+// Selected text becomes one checklist item per non-blank line, so a selected list adds each entry.
+export function toItems(selection: string): string[] {
+  return selection.split(/\r?\n/).map(clean).filter(Boolean)
+}
+
+export function quote(text: string): string {
+  return text
+    .trim()
+    .split(/\r?\n/)
+    .map((line) => (line.trim() ? `> ${line.trimEnd()}` : ">"))
+    .join("\n")
+}
+
+// Indexes of tasks whose text contains the query, ignoring case.
+export function findTasks(doc: string, query: string): number[] {
+  const needle = query.trim().toLowerCase()
+  if (!needle) return []
+  return parse(doc).tasks.flatMap((task, i) => (task.text.toLowerCase().includes(needle) ? [i] : []))
+}

package/src/rpc.ts

@@ -0,0 +1,45 @@
+import { Rpc } from "@opencode/plugin/rpc"
+
+// Every call names the chat it works on. The server stores a subagent's notes in its parent chat.
+const sessionID = { type: "string", minLength: 1 } as const
+
+const state = {
+  type: "object",
+  properties: { sessionID, doc: { type: "string" }, path: { type: "string" } },
+  required: ["sessionID", "doc", "path"],
+  additionalProperties: false,
+} as const
+
+const index = { type: "integer", minimum: 0 } as const
+
+function input<P extends Record<string, unknown>>(properties: P) {
+  return {
+    type: "object",
+    properties: { sessionID, ...properties },
+    required: ["sessionID", ...Object.keys(properties)],
+    additionalProperties: false,
+  } as const
+}
+
+// `sessionID` in a reply or event is the chat that owns the note, which may be the caller's parent.
+export interface State {
+  readonly sessionID: string
+  readonly doc: string
+  readonly path: string
+}
+
+export const Notepad = Rpc.define({
+  id: "notepad",
+  methods: {
+    read: { input: input({}), output: state },
+    add: { input: input({ items: { type: "array", items: { type: "string" } } }), output: state },
+    check: { input: input({ index, checked: { type: "boolean" } }), output: state },
+    remove: { input: input({ index }), output: state },
+    clearDone: { input: input({}), output: state },
+    appendNote: { input: input({ markdown: { type: "string" } }), output: state },
+    setBody: { input: input({ body: { type: "string" } }), output: state },
+  },
+  events: {
+    updated: { schema: state },
+  },
+})

package/src/selection.tsx

@@ -0,0 +1,93 @@
+import { createSignal, For, onCleanup, onMount, Show } from "solid-js"
+import { Portal } from "solid-js/web"
+
+// Places a selection is editable or belongs to the notepad itself; the bar stays hidden there.
+const IGNORE = "input, textarea, select, [contenteditable=''], [contenteditable='true'], .notepad, .notepad-selection"
+
+export interface Picked {
+  readonly text: string
+  readonly top: number
+  readonly left: number
+}
+
+export interface SelectionAction {
+  readonly id: string
+  readonly label: string
+  run(text: string): void
+}
+
+// The window's current text selection, when it is worth acting on.
+export function readSelection(): Picked | undefined {
+  const selection = window.getSelection()
+  if (!selection || selection.isCollapsed || selection.rangeCount === 0) return undefined
+  const text = selection.toString()
+  if (!text.trim()) return undefined
+  const node = selection.anchorNode
+  const element = node instanceof Element ? node : node?.parentElement
+  if (element?.closest(IGNORE)) return undefined
+  const rect = selection.getRangeAt(0).getBoundingClientRect()
+  if (rect.width === 0 && rect.height === 0) return undefined
+  return { text, top: rect.top, left: rect.left + rect.width / 2 }
+}
+
+export function SelectionBar(props: { readonly actions: readonly SelectionAction[] }) {
+  const [picked, setPicked] = createSignal<Picked>()
+  let timer: ReturnType<typeof setTimeout> | undefined
+
+  const refresh = () => {
+    clearTimeout(timer)
+    timer = setTimeout(() => setPicked(readSelection()), 120)
+  }
+  const hide = () => setPicked(undefined)
+
+  onMount(() => {
+    document.addEventListener("selectionchange", refresh)
+    window.addEventListener("scroll", hide, true)
+    window.addEventListener("resize", hide)
+  })
+  onCleanup(() => {
+    clearTimeout(timer)
+    document.removeEventListener("selectionchange", refresh)
+    window.removeEventListener("scroll", hide, true)
+    window.removeEventListener("resize", hide)
+  })
+
+  function send(action: SelectionAction) {
+    const current = picked()
+    if (!current) return
+    window.getSelection()?.removeAllRanges()
+    hide()
+    action.run(current.text)
+  }
+
+  return (
+    <Show when={picked()}>
+      {(at) => (
+        <Portal>
+          <div
+            class="notepad-selection"
+            style={{
+              top: `${at().top < 48 ? at().top + 28 : at().top - 40}px`,
+              left: `${Math.min(Math.max(at().left, 160), window.innerWidth - 160)}px`,
+            }}
+            // Keep the selection alive while the user clicks a button.
+            onMouseDown={(event) => event.preventDefault()}
+          >
+            <For each={props.actions}>
+              {(action, i) => (
+                <>
+                  <Show when={i() > 0}>
+                    <span class="notepad-selection-divider" />
+                  </Show>
+                  <button type="button" onClick={() => send(action)}>
+                    {action.label}
+                  </button>
+                </>
+              )}
+            </For>
+          </div>
+        </Portal>
+      )}
+    </Show>
+  )
+}

package/src/store.ts

@@ -0,0 +1,104 @@
+import { randomUUID } from "node:crypto"
+import { watch } from "node:fs"
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises"
+import os from "node:os"
+import path from "node:path"
+
+const home = os.homedir()
+
+// One Markdown file per chat lives here, beside OpenCode's own data, not in a user folder.
+export const DEFAULT_DIR = path.join(process.env.XDG_DATA_HOME || path.join(home, ".local", "share"), "opencode-notepad")
+
+export function resolveDir(option: unknown): string {
+  if (typeof option !== "string" || !option.trim()) return DEFAULT_DIR
+  const value = option.trim()
+  return path.resolve(value === "~" ? home : value.replace(/^~(?=\/)/, home))
+}
+
+const SAFE_ID = /^[A-Za-z0-9_-]+$/
+
+// `typeof` first: a missing ID would otherwise pass the pattern as the text "undefined".
+export function fileFor(dir: string, sessionID: string): string {
+  if (typeof sessionID !== "string" || !SAFE_ID.test(sessionID)) throw new Error(`Invalid session ID: ${sessionID}`)
+  return path.join(dir, `${sessionID}.md`)
+}
+
+// Owns the notepad files of every chat. Edits to one file run one at a time, so a GUI click and an
+// agent tool call never overwrite each other. `changed` fires after every write, and after edits
+// made by other apps.
+export function createNotebook(dir: string, changed: (sessionID: string, doc: string) => void) {
+  const last = new Map<string, string>()
+  const queues = new Map<string, Promise<unknown>>()
+
+  async function load(sessionID: string): Promise<string> {
+    try {
+      return await readFile(fileFor(dir, sessionID), "utf8")
+    } catch (error) {
+      if ((error as NodeJS.ErrnoException).code === "ENOENT") return ""
+      throw error
+    }
+  }
+
+  async function save(sessionID: string, doc: string) {
+    const file = fileFor(dir, sessionID)
+    await mkdir(dir, { recursive: true })
+    const temp = `${file}.${randomUUID()}.tmp`
+    await writeFile(temp, doc, "utf8")
+    await rename(temp, file)
+    last.set(sessionID, doc)
+  }
+
+  function run<T>(sessionID: string, task: () => Promise<T>): Promise<T> {
+    const next = (queues.get(sessionID) ?? Promise.resolve()).then(task, task)
+    queues.set(
+      sessionID,
+      next.catch(() => undefined),
+    )
+    return next
+  }
+
+  return {
+    dir,
+    path: (sessionID: string) => fileFor(dir, sessionID),
+    read: (sessionID: string) =>
+      run(sessionID, async () => {
+        const doc = await load(sessionID)
+        last.set(sessionID, doc)
+        return doc
+      }),
+    update: (sessionID: string, edit: (doc: string) => string) =>
+      run(sessionID, async () => {
+        const before = await load(sessionID)
+        const after = edit(before)
+        if (after !== before) await save(sessionID, after)
+        changed(sessionID, after)
+        return after
+      }),
+    // Watches the folder, not each file: editors that save by rename replace the file's inode.
+    async watch(): Promise<() => void> {
+      await mkdir(dir, { recursive: true })
+      const timers = new Map<string, ReturnType<typeof setTimeout>>()
+      const watcher = watch(dir, (_event, name) => {
+        const match = name ? /^([A-Za-z0-9_-]+)\.md$/.exec(name.toString()) : null
+        if (!match) return
+        const sessionID = match[1]!
+        clearTimeout(timers.get(sessionID))
+        timers.set(
+          sessionID,
+          setTimeout(() => {
+            void run(sessionID, async () => {
+              const doc = await load(sessionID)
+              if (doc === last.get(sessionID)) return
+              last.set(sessionID, doc)
+              changed(sessionID, doc)
+            }).catch(() => undefined)
+          }, 150),
+        )
+      })
+      return () => {
+        for (const timer of timers.values()) clearTimeout(timer)
+        watcher.close()
+      }
+    },
+  }
+}