{
  "markdown": "# PowerScroll\n\n**A local-first visual notebook in one editable HTML file—with an MCP bridge for AI agents.**\n\n[Try PowerScroll](https://cynacons.github.io/PowerScroll/app/) ·\n[Download PowerScroll.html](https://github.com/CynaCons/PowerScroll/releases/latest/download/PowerScroll.html) ·\n[Agent setup](#let-an-agent-work-in-your-notebook) ·\n[Report a problem](https://github.com/CynaCons/PowerScroll/issues/new/choose)\n\n![PowerScroll visual notebook showing structured pages, independent scrolls, markdown and an editable architecture diagram](site/assets/powerscroll-canvas.png)\n\nPowerScroll combines the hierarchy of OneNote, the freeform canvas of a\nwhiteboard, and editable diagrams in a notebook you completely own. No account,\nserver, proprietary database, or cloud connection is required.\n\n## Start in under a minute\n\n1. Open the [live demo](https://cynacons.github.io/PowerScroll/app/) or download\n   [`PowerScroll.html`](https://github.com/CynaCons/PowerScroll/releases/latest/download/PowerScroll.html).\n2. Add text, images, drawings, shapes, pages, and independent vertical scrolls.\n3. Press **Ctrl+S**. The application and your notebook data are saved together\n   in one HTML file.\n4. Open that file in a browser whenever you want to continue.\n\nThe hosted demo does not upload notebook content. Download or save your notebook\nto keep it; your browser file is the source of truth.\n\n## Why PowerScroll is different\n\n### One file is the product and the data\n\nEvery notebook contains the complete editor, structured workspace, drawings,\nimages, and optional extensions. It opens offline and remains editable. Sharing\nthe file shares a working copy rather than an export that needs PowerScroll\ninstalled elsewhere.\n\n### Visual without losing structure\n\nSections and pages provide notebook hierarchy. Inside each page, named scrolls\ncreate independent vertical workstreams on an infinite canvas. Markdown, math,\nimages, ink, shapes, PlantUML, Mermaid, SVG, and draw.io content can live beside\none another.\n\n### Humans and agents share the same canvas\n\nThe local MCP bridge lets an agent read pages, add and move blocks, manage\nscrolls, insert images, create native editable diagrams, and save the notebook.\nAgent edits use the same in-memory stores, undo history, and save path as human\nedits—there is no shadow database to reconcile.\n\n![PowerScroll agent bridge and editable native diagram workflow](site/assets/powerscroll-agent.png)\n\n## Let an agent work in your notebook\n\nThe bridge is off by default and listens only on your machine. Run the published\npackage directly from npm:\n\n```bash\nnpx -y powerscroll-mcp\n```\n\nThen open a notebook and enable **Settings → Agent bridge → Let a local agent\nwrite into this notebook**. See the [complete tool and client setup guide](powernote-mcp/README.md).\n\nThe executable is published as [`powerscroll-mcp`](https://www.npmjs.com/package/powerscroll-mcp)\nand its discovery metadata is active in the\n[official MCP Registry](https://registry.modelcontextprotocol.io/?q=powerscroll).\nThe latest GitHub release also carries a package tarball as a fallback, but npm\nis the canonical install source.\n\n## Selected capabilities\n\n- Infinite canvas with pan, zoom, touch, lasso, alignment guides, and undo/redo\n- Markdown, tables, checkboxes, links, syntax blocks, and KaTeX mathematics\n- Images with paste/import, crop, rotate, lightbox, notes, and compact mode\n- Freehand pen and erasers; styled rectangles, circles, triangles, arrows, lines, and arcs\n- Sections, pages, named resizable scrolls, outline, search, and replace\n- Native editable diagrams from PlantUML, Mermaid, SVG, and draw.io\n- Direct disk save and autosave in Chrome/Edge, with browser download fallback\n- In-app updates that preserve notebook content and installed extensions\n- Local multi-agent MCP bridge with a single-writer lease and unblocked reads\n\n## Privacy and security\n\nNormal editing does not require a PowerScroll server or account. Update checks\nand optional extension installation contact GitHub; the local agent bridge makes\na loopback WebSocket connection only after the user enables it.\n\nA notebook is executable HTML. Open notebooks only from people you trust, just\nas you would any executable document. See [SECURITY.md](SECURITY.md) for the\nthreat model and private vulnerability-reporting instructions.\n\n## Migrating a PowerNote notebook\n\nPowerScroll opens existing PowerNote notebooks directly. Legacy embedded ids,\ninternal links, storage, and bridge protocol identifiers remain supported.\n\nFor a notebook too old to update itself:\n\n1. Open the latest `PowerScroll.html`.\n2. Use the **Open** button to select the old notebook.\n3. Press **Ctrl+S** to write the current PowerScroll editor back with its content.\n\n## Development\n\n```bash\nnpm install\nnpm install --prefix powernote-mcp\nnpm run dev\nnpm run build:template\nnpx playwright test\nnpm run test:bridge\n```\n\nPowerScroll is built with React, TypeScript, Vite, Konva, and Zustand. Behavioral\nrequirements and their test traceability live in [`docs/`](docs/). Contribution\nexpectations are in [CONTRIBUTING.md](CONTRIBUTING.md). Maintainers should use\nthe [release runbook](docs/RELEASING.md) and update the\n[deployment ledger](docs/DEPLOYMENTS.md) after publishing.\n\n## License\n\n[MIT](LICENSE) © 2026 Constantin Chabirand\n",
  "bytes": 5308,
  "sha": "2e41cb034e3bc6fbf4165b49d063a7b30f26d6103e6041c5d32c903611c21211",
  "repo_slug": "cynacons/powerscroll",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_cynacons_powerscroll_e0956c41/readme"
}