Skip to content
Back to search

penecho

Think with AI beyond the chat box. A shared canvas for handwriting, equations, diagrams, and spatial reasoning.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/penecho--penecho/badge.svg)](/listings/penecho--penecho)

HTML

<a href="/listings/penecho--penecho"><img src="/api/listings/penecho--penecho/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

| | Get started | | --- | --- | | **Desktop app** | macOS and Windows from [GitHub Releases](https://github.com/penecho/penecho/releases/latest). Includes everything, updates itself. | | **npm** | Node.js 22.19+. Run `npm i -g penecho` then `penecho` and open `localhost:3888`. | | **Browser** | Sign in at [penecho.ai](https://penecho.ai) for hosted models and Cloud canvases. Nothing to install. |

npm install -g penecho
penecho             # opens http://localhost:3888

> [!TIP] > On first start, choose a six-digit access code (or open access on a trusted network). Add a model in **Settings → AI & connections**: your own API key, a signed-in Codex / Claude Code / Kimi CLI, or PenEcho models.

<details> <summary>Run from source</summary>

git clone https://github.com/penecho/penecho.git
cd penecho
npm install
npm start

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "penecho",
  3. "owner": {
  4. "name": "PenEcho"
  5. },
  6. "plugins": [
  7. {
  8. "name": "penecho-cloud",
  9. "source": "./integrations/penecho-cloud",
  10. "description": "Draw and revise a shared Canvas beside your AI conversation.",
  11. "version": "1.1.4"
  12. }
  13. ],
  14. "description": "PenEcho Cloud Canvas plugin with native HTTPS MCP and a drawing workflow Skill."
  15. }
README.md · README · 280 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="public/penecho-readme-header-dark.webp">
  4. <img src="public/penecho-readme-header.webp" alt="PenEcho" width="320">
  5. </picture>
  6. </p>
  7. <h1 align="center">AI that shows, not just tells.</h1>
  8. <p align="center">Bring a question, a sketch, or your notes. PenEcho's built-in AI — or Codex, Claude Code and any MCP client — shows you the answer as diagrams, documents and working widgets, right beside your work.</p>
  9. <p align="center">
  10. <a href="https://github.com/penecho/penecho/releases/latest"><img src="https://img.shields.io/badge/release-v1.4.2-087f83" alt="Release v1.4.2"></a>
  11. <a href="https://www.npmjs.com/package/penecho"><img src="https://img.shields.io/badge/npm-penecho-cb3837" alt="npm penecho"></a>
  12. <a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-blue" alt="AGPL-3.0-only"></a>
  13. <a href="https://discord.gg/3jrPJ3mXdX"><img src="https://img.shields.io/badge/discord-join-5865f2" alt="Join Discord"></a>
  14. <a href="docs/mcp-setup.md"><img src="https://img.shields.io/badge/MCP-ready-6f42c1" alt="MCP ready"></a>
  15. </p>
  16. <p align="center">
  17. <a href="https://github.com/penecho/penecho/releases/latest"><img src="https://img.shields.io/badge/DOWNLOAD_FOR_MACOS-24292f?style=for-the-badge&amp;logo=apple&amp;logoColor=white" alt="Download for macOS"></a>
  18. <a href="https://github.com/penecho/penecho/releases/latest"><img src="https://img.shields.io/badge/DOWNLOAD_FOR_WINDOWS-0969da?style=for-the-badge&amp;logo=windows&amp;logoColor=white" alt="Download for Windows"></a>
  19. <a href="https://penecho.ai"><img src="https://img.shields.io/badge/OPEN_PENECHO.AI-087f83?style=for-the-badge&amp;logo=googlechrome&amp;logoColor=white" alt="Open penecho.ai"></a>
  20. </p>
  21. <p align="center">
  22. <a href="https://buymeacoffee.com/penecho"><img src="docs/assets/support-penecho.svg" alt="Support PenEcho open source — buy us a coffee to help fund development, testing, and documentation" width="820"></a>
  23. </p>
  24. <p align="center">
  25. <a href="#new-in-1-4">What's new in 1.4</a> ·
  26. <a href="#quick-start">Quick start</a> ·
  27. <a href="#connect-your-ai-agent-mcp">Connect your AI (MCP)</a> ·
  28. <a href="docs/">Docs</a> ·
  29. <a href="#support-penecho">Support PenEcho</a> ·
  30. <a href="https://discord.gg/3jrPJ3mXdX">Discord</a>
  31. </p>
  32. <p align="center">
  33. <sub><strong>English</strong> ·
  34. <a href="docs/readme/README.zh-CN.md">简体中文</a> ·
  35. <a href="docs/readme/README.ja.md">日本語</a> ·
  36. <a href="docs/readme/README.ko.md">한국어</a> ·
  37. <a href="docs/readme/README.ru.md">Русский</a> ·
  38. <a href="docs/readme/README.es.md">Español</a> ·
  39. <a href="docs/readme/README.pt-BR.md">Português</a> ·
  40. <a href="docs/readme/README.fr.md">Français</a> ·
  41. <a href="docs/readme/README.de.md">Deutsch</a></sub>
  42. </p>
  43. <p align="center">
  44. <img src="https://github.com/penecho/penecho/releases/download/v0.1.0/penecho_full_demo.webp" alt="From a hand sketch to a diagram and working widget on one PenEcho canvas" width="100%">
  45. </p>
  46. <p align="center"><em>From a hand sketch to an interactive result in one canvas.</em></p>
  47. <a name="new-in-1-4"></a>
  48. ## New in 1.4: it knows what you need
  49. <p align="center">
  50. <a href="https://penecho.ai/#knows-you"><img src="https://github.com/penecho/penecho/releases/download/v0.1.0/penecho_knowsyou.webp" alt="Watch the PenEcho 1.4 tour (2:30)" width="100%"></a>
  51. </p>
  52. <p align="center"><a href="https://penecho.ai/#knows-you"><strong>▶ Watch with sound and chapters</strong></a> · <a href="https://github.com/penecho/penecho/releases/download/v0.1.0/penecho_knowsyou.mp4">Download MP4</a><br><sub>Smart Assist · PenEchoLLM · Notes &amp; Cards · live graphs · simulations · 3D</sub></p>
  53. <table width="100%">
  54. <tr>
  55. <td width="50%" valign="top">
  56. <a href="https://penecho.ai/?t=16#knows-you"><img src="docs/assets/release-1.4/penechollm-suggest.webp" alt="PenEchoLLM suggests Solve for a handwritten integral; one tap and the answer lands in place" width="100%"></a><br>
  57. <strong>PenEchoLLM suggests the next step</strong><br>
  58. Pause after writing and PenEchoLLM ranks what you need next: Solve, Typeset, Plot graph, Make diagram, Organize as Note and more. One tap and the answer lands where you wrote, with the next step already suggested. It learns from the suggestions you choose, on your device. Free to try every day, no API key needed.
  59. </td>
  60. <td width="50%" valign="top">
  61. <a href="https://penecho.ai/?t=43#knows-you"><img src="docs/assets/release-1.4/notes-cards.webp" alt="Handwritten notes circled on the canvas become a knowledge card, then appear in the searchable Library" width="100%"></a><br>
  62. <strong>Notes &amp; Cards keep what matters</strong><br>
  63. Circle a formula, sketch or answer and keep it as a knowledge card or work note, with your original handwriting. Cards are categorized automatically and collected in the Library, where you can search, bookmark, review and bring them into any canvas.
  64. </td>
  65. </tr>
  66. </table>
  67. ## What you can do
  68. <table width="100%">
  69. <tr>
  70. <td width="33%" valign="top">
  71. <img src="https://github.com/penecho/penecho/releases/download/v0.1.0/penecho_plugins_sub_x10.webp" alt="PenEcho responding to notes and sketches on a canvas" width="100%"><br>
  72. <strong>Sketch, then ask</strong><br>
  73. Handwriting, equations, text and images on an endless canvas. PenEchoLLM suggests the next step when you pause.
  74. </td>
  75. <td width="33%" valign="top">
  76. <a href="docs/assets/professional-diagrams/kubernetes.webp"><img src="docs/assets/professional-diagrams/previews/kubernetes.webp" alt="Kubernetes architecture diagram" width="100%"></a><br>
  77. <strong>Professional diagrams</strong><br>
  78. Architecture, sequence and workflow diagrams with automatic layout. Export SVG or PNG.
  79. </td>
  80. <td width="33%" valign="top">
  81. <img src="https://github.com/penecho/penecho/releases/download/v0.1.0/play_patris.webp" alt="Interactive widget running on a PenEcho canvas" width="100%"><br>
  82. <strong>Working widgets</strong><br>
  83. Calculators, quizzes and prototypes that run on the canvas and can be favourited or shared.
  84. </td>
  85. </tr>
  86. </table>
  87. ## Quick start
  88. | | Get started |
  89. | --- | --- |
  90. | **Desktop app** | macOS and Windows from [GitHub Releases](https://github.com/penecho/penecho/releases/latest). Includes everything, updates itself. |
  91. | **npm** | Node.js 22.19+. Run `npm i -g penecho` then `penecho` and open `localhost:3888`. |
  92. | **Browser** | Sign in at [penecho.ai](https://penecho.ai) for hosted models and Cloud canvases. Nothing to install. |
  93. ```bash
  94. npm install -g penecho
  95. penecho # opens http://localhost:3888
  96. ```
  97. > [!TIP]
  98. > On first start, choose a six-digit access code (or open access on a trusted network). Add a model in **Settings → AI & connections**: your own API key, a signed-in Codex / Claude Code / Kimi CLI, or PenEcho models.
  99. <details>
  100. <summary>Run from source</summary>
  101. ```bash
  102. git clone https://github.com/penecho/penecho.git
  103. cd penecho
  104. npm install
  105. npm start
  106. ```
  107. </details>
  108. ## Connect your AI agent (MCP)
  109. Keep talking in the agent you already use. PenEcho gives the work a place to live — your agent draws on the canvas, you mark it up, and it reads your feedback on the next turn.
  110. 1. In PenEcho, open **Settings → MCP service** and turn on the current canvas.
  111. 2. Use **Auto configure** for a supported client, or copy the generated setup prompt into your client (Codex, Claude Code, Kimi, Cursor...). For a global npm installation, clients that accept `mcpServers` JSON can also use the compatibility entry below:
  112. ```json
  113. {
  114. "mcpServers": {
  115. "penecho": { "command": "penecho", "args": ["mcp"] }
  116. }
  117. }
  118. ```
  119. 3. Ask: *“Show the architecture we discussed on my PenEcho canvas.”*
  120. ### Cloud Canvas beside your chat: one paste, no install
  121. Paste this into Claude Code, Codex, Cursor or another MCP agent:
  122. ```text
  123. Set up PenEcho Canvas for me:
  124. 1. Download https://penecho.ai/downloads/penecho-cloud-plugin.zip, unzip it, and follow its INSTALL.md for the app you are running in.
  125. 2. Add the PenEcho MCP server https://penecho.ai/mcp. If it needs authorization, open the authorization page once; I'll choose "Continue as guest".
  126. 3. Confirm the PenEcho tools respond, then tell me it's ready.
  127. From now on, when I ask you to draw, diagram or show something on a canvas, use PenEcho and open the canvas beside our chat.
  128. ```
  129. Then just ask:
  130. - *“Draw this project's architecture on the canvas.”*
  131. - *“Turn our login flow into a sequence diagram on the canvas.”*
  132. - *“Make an interactive binary-search demo on the canvas.”*
  133. - *“Read my handwritten notes on the canvas and revise the diagram.”*
  134. The canvas opens beside your chat: in Codex's right panel, the Claude desktop browser pane, or your default browser. No account is needed; choose **Continue as guest** if asked. Sign in only when you want to save to Cloud. MCP uses no PenEcho credits. Claude Chat and Cowork install through the app's own plugin upload or connector settings ([`.plugin` file](integrations/penecho-cloud/penecho-cloud.plugin)). See [installation details](integrations/penecho-cloud/INSTALL.md).
  135. <p align="center">
  136. <a href="docs/assets/mcp-spatial-example.webp"><img src="docs/assets/mcp-spatial-example.webp" alt="An architecture discussion from Claude Code with handwritten annotations on a PenEcho canvas" width="760"></a>
  137. </p>
  138. <p align="center"><em>An architecture discussion from Claude Code, annotated by hand on the canvas.</em></p>
  139. > [!NOTE]
  140. > Agents only see canvases you turn on. Local MCP stays on your computer; Cloud MCP uses separate OAuth authorization and supports guest browser drafts. [MCP guide →](docs/mcp-setup.md)
  141. ## Diagram gallery
  142. <table width="100%">
  143. <tr>
  144. <td width="33%" valign="top"><a href="docs/assets/professional-diagrams/kubernetes.webp"><img src="docs/assets/professional-diagrams/previews/kubernetes.webp" alt="Kubernetes cluster diagram" width="100%"></a><br><strong>Kubernetes cluster</strong></td>
  145. <td width="33%" valign="top"><a href="docs/assets/professional-diagrams/migration.webp"><img src="docs/assets/professional-diagrams/previews/migration.webp" alt="Monolith to microservices diagram" width="100%"></a><br><strong>Monolith → microservices</strong></td>
  146. <td width="33%" valign="top"><a href="docs/assets/professional-diagrams/notifications.webp"><img src="docs/assets/professional-diagrams/previews/notifications.webp" alt="Event-driven notifications diagram" width="100%"></a><br><strong>Event-driven notifications</strong></td>
  147. </tr>
  148. <tr>
  149. <td valign="top"><a href="docs/assets/professional-diagrams/mcp-request.webp"><img src="docs/assets/professional-diagrams/previews/mcp-request.webp" alt="How MCP reaches the canvas diagram" width="100%"></a><br><strong>How MCP reaches the canvas</strong></td>
  150. <td valign="top"><a href="docs/assets/professional-diagrams/release.webp"><img src="docs/assets/professional-diagrams/previews/release.webp" alt="Release parallel tasks diagram" width="100%"></a><br><strong>Release: parallel tasks</strong></td>
  151. <td valign="top"><a href="docs/assets/professional-diagrams/rollout.webp"><img src="docs/assets/professional-diagrams/previews/rollout.webp" alt="Multi-region rollout diagram" width="100%"></a><br><strong>Multi-region rollout</strong></td>
  152. </tr>
  153. </table>
  154. <p align="center"><sub>Click any diagram for the full-size version.</sub></p>
  155. ## How it works
  156. <p align="center"><img src="public/penecho-architecture.webp" alt="A browser connects to PenEcho Cloud or your local PC. An AI agent can connect through optional Cloud MCP or Local MCP." width="100%"></p>
  157. - **On your computer** — the desktop app or CLI serves the canvas and uses your own model API or agent CLI.
  158. - **In the cloud** — penecho.ai adds hosted models, synced projects and favorites, and can reach your linked computer.
  159. - **Your agent** — connects through Local or Cloud MCP. Both are optional.
  160. Details: [architecture notes](docs/architecture.md).
  161. ## Choose your AI
  162. | Connection | Cost | Best for |
  163. | --- | --- | --- |
  164. | **PenEcho models** — sign in, pick a model | Account credits | Getting started, no keys |
  165. | **Your model API** — OpenAI- or Anthropic-compatible | Your provider | Full control of model and cost |
  166. | **Your CLI** — Codex, Claude Code or Kimi, signed in | Your plan | Reusing a subscription you have |
  167. Which model and effort to pick: [recommended models](#recommended-models) (updated with each release).
  168. <a name="recommended-models"></a>
  169. <details>
  170. <summary>Recommended models</summary>
  171. These recommendations balance answer quality against the latency of PenEcho's real canvas workload, based on current hands-on testing; actual response time varies with the provider, canvas complexity, and reasoning behavior.
  172. | Model | Effort | Notes | Recommended use |
  173. | --- | --- | --- | --- |
  174. | Claude Opus 4.8 / 5.0 (`claude-opus-4-8` / `claude-opus-5-0`) | `medium` | Strong quality with a better latency balance | Everyday canvas work |
  175. | Claude Opus 4.8 / 5.0 (`claude-opus-4-8` / `claude-opus-5-0`) | `high` | Higher reasoning quality, longer and more variable waits | Complex handwriting, mathematics, diagrams, or layout |
  176. | Fable 5 (`claude-fable-5` or `fable`) | `medium` | Often around half the response time of `gpt-5.6-sol` at `xhigh` | Fast, high-quality general use |
  177. | [Kimi K3](https://platform.kimi.ai?aff=penecho) (`kimi-k3`) | `medium` | Very good quality; `medium` keeps the balance practical | Recommended Kimi default |
  178. | `gpt-5.6-terra` | `low` to `high` | Surprisingly strong and responsive | Flexible quality and latency targets |
  179. | `gpt-5.6-luna` | `xhigh` | Very good canvas results with strong speed | Quality-first, still responsive |
  180. | `gpt-5.6-sol` | `high` | Good enough for most requests, more responsive than `xhigh` | Default when responsiveness matters |
  181. | `gpt-5.6-sol` | `xhigh` | Very good but slower and more variable | Difficult canvas tasks |
  182. | `deepseek-v4-flash-vision-exp` | `medium` | Good | Vision-capable work through the DeepSeek API |
  183. | `glm-5.3-flash` | `medium` | Good | Fast work through the GLM Anthropic-compatible API |
  184. </details>
  185. ## What's new in 1.4.0
  186. - **Smart Assist with PenEchoLLM:** context-aware actions for handwriting, text and images, ranked by PenEchoLLM, with quick answers, visual creation and follow-up questions.
  187. - **Lasso AI:** circle any part of the canvas to solve, visualize, animate or organize just the selected content.
  188. - **Notes & Cards:** turn canvas content into reusable notes and knowledge cards; browse, search and bring them into other canvases.
  189. - **Widget refinement:** refine results through written feedback and contextual actions, with clearer controls and better content fitting.
  190. - **Canvas polish:** improved pen gestures, stroke deletion, navigation and collaboration with Agent and MCP.
  191. [Watch the 1.4 tour →](https://penecho.ai/#knows-you) · [Full changelog →](CHANGELOG.md#140)
  192. ## Support PenEcho
  193. Help keep PenEcho's open-source canvas improving. Your support funds development, bug fixes, cross-platform testing, accessibility, and documentation.
  194. <p align="center">
  195. <a href="https://github.com/sponsors/penecho"><img src="https://img.shields.io/badge/GitHub_Sponsors-Support_PenEcho-db61a2?style=for-the-badge&amp;logo=githubsponsors&amp;logoColor=white" alt="Support PenEcho on GitHub Sponsors" height="32"></a>
  196. </p>
  197. Choose [Buy Me a Coffee](https://buymeacoffee.com/penecho) for a quick thank-you, or [GitHub Sponsors](https://github.com/sponsors/penecho) for monthly or one-time support. Contributions support open-source maintenance; they do not purchase a commercial license, dedicated support, or guaranteed features.
  198. ## Community
  199. | [Discord](https://discord.gg/3jrPJ3mXdX) | [Discussions](https://github.com/penecho/penecho/discussions) | [Issues](https://github.com/penecho/penecho/issues) | [Contributing](CONTRIBUTING.md) |
  200. | --- | --- | --- | --- |
  201. | Chat with the team | Ideas and questions | Report a bug | Run `npm run check` first |
  202. Licensed under [AGPL-3.0-only](LICENSE); [commercial licence](COMMERCIAL-LICENSE.md) available. [Trademark policy](TRADEMARKS.md) · [Contributor agreement](CONTRIBUTOR-LICENSE-AGREEMENT.md).
  203. Diagram renderers adapt SVG and geometry helpers from [Archify](https://github.com/tt-a1i/archify) by tt-a1i (MIT). See [NOTICE](NOTICE).
  204. <p align="center">
  205. <a href="https://www.kimi.com/code?aff=penecho">
  206. <picture>
  207. <source media="(prefers-color-scheme: dark)" srcset="docs/assets/kimi-open-source-friends-dark.svg">
  208. <img src="docs/assets/kimi-open-source-friends-light.svg" alt="Kimi Open Source Friends" width="326" height="56">
  209. </picture>
  210. </a>
  211. </p>
  212. <p align="center">
  213. <a href="https://www.star-history.com/?repos=penecho%2Fpenecho&amp;type=date&amp;legend=top-left">
  214. <picture>
  215. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=penecho/penecho&amp;type=date&amp;theme=dark&amp;legend=top-left">
  216. <img src="https://api.star-history.com/chart?repos=penecho/penecho&amp;type=date&amp;legend=top-left" alt="PenEcho GitHub star history chart" width="800">
  217. </picture>
  218. </a>
  219. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.