Skip to content

Claude's answers, rendered: Markdown, math, charts and diagrams drawn in the Claude Code terminal. Independent project, not affiliated with Anthropic.

TypeScript claude-code-mod

Docs: Privacy and access section, stale claims fixed

razorback16eb746ec657b2
diff --git a/README.md b/README.md
index 1b98833..f259238 100644
--- a/README.md
+++ b/README.md
@@ -101,6 +101,17 @@ More in the [gallery](docs/gallery.md): plots, fractals and a tour of all the Ma
All commands are in [Usage](docs/usage.md).
+## Privacy and access
+
+The mod sends nothing about you or your sessions anywhere.
+
+- **Network:** one GET request each day at most, to `raw.githubusercontent.com`, for the public `plugin.json` of this mod. It only tells you about a new version. `/iui updates off` stops it. It also stops when `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_UPDATES` or `DISABLE_AUTOUPDATER` is set.
+- **Clipboard, read:** a small `perl` process watches the clipboard while the mod is on and has drawn a picture. On macOS it reads only the change counter, and it reads the text when the counter changes. The text is only checked for picture cells (then a toast names `/iui grab`). It is not stored or sent. <!-- pending pkg A -->Copies that a password manager marks as concealed or transient are skipped on macOS and on X11, and sensitive copies on Wayland.
+- **Clipboard, written:** only at these times: when you release a picture selection, when you click a link, a file path, a command or a copy button in a picture, on `/iui grab`, when you press the command button in a link row on the main screen, and when the mod changes a `$.ui.copy` that has picture cells to its text.
+- **Files:** a private cache folder in `$TMPDIR` (`cc-intelligent-ui-<uid>`, mode 700, deleted after 2 days), and `~/.cache/cc-intelligent-ui/designs`. `/iui setup` on macOS changes your shell start file after you agree.
+- **Processes:** `typst`, the `perl` watcher, and short helper commands such as `pbpaste`, `osascript`, `defaults`, `fc-list` and `fc-match`. On Linux also `wl-paste`, `xclip`, `xsel` or `clipnotify` for the clipboard.
+- **Typst:** <!-- pending pkg B -->Typst runs with a narrow root, so the code in an answer cannot read other files on your computer.
+
## Docs
- [Install](docs/install.md): requirements, terminal support and updates
diff --git a/THIRD-PARTY-NOTICES.md b/THIRD-PARTY-NOTICES.md
index 7e1150f..a2c40f5 100644
--- a/THIRD-PARTY-NOTICES.md
+++ b/THIRD-PARTY-NOTICES.md
@@ -26,4 +26,4 @@ The colours, sizes and spacing of the `vscode` and `vscode-modern` themes come f
## show-your-work
-The one-line Perl command that reads the terminal's cell size in pixels (`CELL_SH` in `hooks/register.tsx`) comes from [show-your-work](https://github.com/iamumeransari/claude-show-your-work). MIT, Copyright (c) 2026 Umer Ansari.
+The one-line Perl command that reads the terminal's cell size in pixels (`CELL_SH` in `hooks/lib/host.ts`) comes from [show-your-work](https://github.com/iamumeransari/claude-show-your-work). MIT, Copyright (c) 2026 Umer Ansari.
diff --git a/docs/how-it-works.md b/docs/how-it-works.md
index 617ffda..bc076f0 100644
--- a/docs/how-it-works.md
+++ b/docs/how-it-works.md
@@ -16,7 +16,7 @@
One long-lived `perl` process (the watcher) watches the terminal size (at each SIGWINCH) and the clipboard. On macOS, it uses `/usr/bin/perl` with Apple's PerlObjCBridge and reads the change counter of the clipboard (`NSPasteboard changeCount`) every 0.3 s. This read is in the process and starts no other process (approximately 0.05% of one CPU core). On Linux, the process starts a child in a process group of its own. The child runs a tool that prints a line at each clipboard change (`wl-paste --watch`, `clipnotify` or GTK 3 from Python, refer to [Linux](install.md#linux)) and gives the mod a counter for each line. Nothing runs between two changes. When the `perl` process stops, it stops that process group. The clipboard part starts only while the mod is on and after the mod drew its first picture in this session; then the mod starts the process again with the clipboard part (and again without it after `/iui off`). When the counter changes, the mod reads the clipboard one time (`pbpaste` on macOS; `wl-paste`, `xclip`, `xsel` or GTK on Linux). When the clipboard has picture cells that fit a page drawn in this session, the mod shows one toast that names `/iui grab`. It does not change the clipboard. The first counter after a start is not a change, so an old clipboard gets no toast. If the watcher stops, the mod starts it again after 1 s (3 times at most). At `/clear` or a resume, the watcher continues without the clipboard part. At other session ends (for example `/exit`), the mod stops it and does not start a new one.
- `/iui grab` reads the last mouse selection of Claude Code (`$.ui.selection`). With no selection (the main screen), it reads the picture cells on the clipboard. Then it writes their text with `$.ui.copy`. A `ui.copy` hook also changes a copy with picture cells (for example, from `/copy` or `$.ui.copy`) to the text. The mod writes the clipboard only for picture select, `/iui grab` and the `ui.copy` hook.
+ `/iui grab` reads the last mouse selection of Claude Code (`$.ui.selection`). With no selection (the main screen), it reads the picture cells on the clipboard. Then it writes their text with `$.ui.copy`. A `ui.copy` hook also changes a copy with picture cells (one that comes through `$.ui.copy`) to the text. The mod writes the clipboard only for picture select, a click on a link, a file path, a command or a copy button in a picture, `/iui grab`, the command `Button` of a link row (step 7) and the `ui.copy` hook.
A picture cell holds its row and its column (kitty placeholder U+10EEEE plus two combining marks). The mod finds the drawn page that has these rows, at the size that it is drawn. Then it finds the position of each word on that page: it runs the probe (`typst query` on the same template, with the same inputs as the PNG compile, plus `probe=1` and `page=<n>`) only for the pages that a copy reads, and (for picture select) for the pages on the screen. The mod keeps the positions of the last 64 pages in memory. It writes nothing to disk for this, and the PNGs do not change. The mod takes the words in the selected cells.
diff --git a/docs/install.md b/docs/install.md
index 0c69c4c..eee741f 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -4,9 +4,9 @@
## Requirements
-- Claude Code 2.1.298 or later (tested on 2.1.301)
+- Claude Code 2.1.298 or later (tested on 2.1.307)
- [Typst](https://typst.app) 0.15 (tested on 0.15.1)
-- macOS (tested) or Linux with X11 or Wayland. The Linux parts are tested in a container, not yet on a Linux desktop. Refer to [Linux](#linux).
+- macOS (tested) or Linux with X11 or Wayland. It works on a Linux desktop (tested on Ubuntu 24.04 with GNOME). Refer to [Linux](#linux).
- A terminal where Claude Code draws pictures. Refer to [Terminals](#terminals).
## Terminals
diff --git a/docs/limitations.md b/docs/limitations.md
index bc117bc..5b0150c 100644
--- a/docs/limitations.md
+++ b/docs/limitations.md
@@ -35,8 +35,8 @@
- The mod finds the targets from the words of the page. Until they are known (the probe, refer to [The page cache](how-it-works.md#the-page-cache)), a hover shows no highlight, and a click waits for them.
- A file path is a target only when the file exists when the mod draws the answer. A link to a heading of the same text is not a target. A link, a file path or a command in a Typst drawing, in math or in an image is not a target.
- It needs `perl` (with `MIME::Base64`, a core module) to write the frames. With no `perl`, the selection and the copy work with no highlight (the mod tries one time, then writes the reason to the debug log).
-- **The cache folder:** the mod uses only its private cache folder (`$TMPDIR/cc-intelligent-ui-<uid>`, mode 700, your own and not a link). If that folder is a link, is not a folder or is not yours, the mod draws nothing and picture select is off. `/iui`, `/iui details` and a toast at the start tell you why. Remove or fix that folder, then start Claude Code again.
- It copies at the button's up, also when `copyOnSelect` is `false` in `/config`.
+- **The cache folder:** the mod uses only its private cache folder (`$TMPDIR/cc-intelligent-ui-<uid>`, mode 700, your own and not a link). If that folder is a link, is not a folder or is not yours, the mod draws nothing and picture select is off. `/iui`, `/iui details` and a toast at the start tell you why. Remove or fix that folder, then start Claude Code again. The mod also keeps the drawing space of each answer in `~/.cache/cc-intelligent-ui/designs` (`$XDG_CACHE_HOME` if set), and deletes files there after 180 days.
- **A fake bold** (a terminal font with no bold face, for example Monaco): bold text gets a thin outline in its colour. These limits apply:
- A character that the terminal font does not have (for example, CJK text in Monaco) comes from another font. If that font has a bold face, the character gets both the real bold face and the outline, so it is a little bolder than in the terminal.
- Bold text in a live Typst drawing (for example, `text(weight: "bold", font: theme.mono)`) does not get the fake bold. It shows as regular text.
diff --git a/docs/usage.md b/docs/usage.md
index 3932041..f7df907 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -124,7 +124,7 @@ While the mod is on and has drawn a picture in this session, it sees each change
`/iui grab` puts the text on the clipboard. In fullscreen mode, it reads the last mouse selection of Claude Code and copies its text. With no selection (the main screen), it reads the picture cells on the clipboard and copies their text. If the clipboard has the text already, it tells you. If the copied text is not correct, `/iui dump` shows the cells that the mod found and the page that it used. It also writes all of this to `copy-debug.json` in the cache folder.
-A copy of picture cells through Claude Code's `/copy` or `$.ui.copy` gets the text in place of the cells.
+A copy of picture cells through `$.ui.copy` gets the text in place of the cells.
For the limits, refer to [Limitations](limitations.md).
diff --git a/site/index.html b/site/index.html
index 3403b4e..5229cf0 100644
--- a/site/index.html
+++ b/site/index.html
@@ -289,7 +289,7 @@
<a class="icon-btn" href="https://github.com/razorback16/cc-intelligent-ui">GitHub</a>
<a class="icon-btn" href="https://github.com/razorback16/cc-intelligent-ui/blob/main/docs/install.md">Install guide</a>
</div>
- <p class="fine">Needs Claude Code 2.1.298 or later, Typst 0.15 and macOS. An independent, community-made mod, not affiliated with or endorsed by Anthropic. Claude and Claude Code are trademarks of Anthropic, PBC. MIT licence.</p>
+ <p class="fine">Needs Claude Code 2.1.298 or later, Typst 0.15, and macOS or Linux. An independent, community-made mod, not affiliated with or endorsed by Anthropic. Claude and Claude Code are trademarks of Anthropic, PBC. MIT licence.</p>
</div>
</footer>