From 8353e598e2f5edb40308a5986b2eed8e2755ddf0 Mon Sep 17 00:00:00 2001 From: J Date: Thu, 29 Oct 2026 17:41:00 -0700 Subject: [PATCH 1/3] Add the listing's privacy, terms and support links The plugin directory warns about a listing without a privacy policy, terms or a support link. plugin.json now names all three: - privacyPolicyUrl: PRIVACY.md, which says the author collects nothing, what the mod keeps on the machine and where, that only the opt-in summary lines leave it (what each request carries, and whose policy covers it), and how to delete what it keeps; - termsOfServiceUrl: the MIT license; - supportUrl: the repository's GitHub issues. Both READMEs and the CHANGELOG link to them, and PRIVACY.md joins the format check. scripts/listing.test.ts checks that each listing link is an https URL into the repository and that a file it names is here. --- CHANGELOG.md | 1 + PRIVACY.md | 27 ++++++++++++++++++++ README.md | 4 +-- justfile | 4 +-- scripts/listing.test.ts | 36 +++++++++++++++++++++++++++ sessionpad/.claude-plugin/plugin.json | 3 +++ sessionpad/README.md | 6 ++++- 7 files changed, 76 insertions(+), 5 deletions(-) create mode 100644 PRIVACY.md create mode 100644 scripts/listing.test.ts diff --git a/CHANGELOG.md b/CHANGELOG.md index 2a930c8..e6f873a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,6 +12,7 @@ ### Added - An icon and a README of its own in the plugin folder, for a listing in Anthropic's plugin directory. The icon's source is `assets/icon.svg`. +- The listing's links in `plugin.json`: a privacy policy (`PRIVACY.md`: the author collects nothing, and only the opt-in summary lines leave your machine), the terms (the MIT license) and support (GitHub issues). ## 0.3.0 (2026-10-29) diff --git a/PRIVACY.md b/PRIVACY.md new file mode 100644 index 0000000..4b0c786 --- /dev/null +++ b/PRIVACY.md @@ -0,0 +1,27 @@ +# Session Pad privacy policy + +Session Pad is a mod for Claude Code, made by J and published at [github.com/j127/sessionpad](https://github.com/j127/sessionpad). This policy covers the mod itself. + +## What the author collects + +Nothing. The mod has no server, no account, no analytics and no telemetry, and it makes no network calls of its own. Nothing you write in it, and nothing about how you use it, is ever sent to the author. + +## What stays on your machine + +Everything the mod keeps is stored on your computer. The two `~/.claude` folders below are under `CLAUDE_CONFIG_DIR` instead when that is set. + +- each session's headline and notes, an index of sessions with each one's working folder, repository root and when it was last seen, each worktree's measured size, the running total of summary calls, whether the summary offer was answered, and when the last prune ran, in the mod's key-value store under `~/.claude/plugins/store/`; +- one timeline file a session under `~/.claude/sessionpad/timeline/`, with when each turn ended and how long it ran, the prompt's first 200 characters, a one-line summary, up to 25 paths written, the number of commands run, the branch, the worktree's path and the turn's token counts; +- exports under `~/.claude/sessionpad/exports/`, or at the path you give `/pad-export`. + +## What leaves your machine + +Only the summary lines, and only if you turn them on. They are off until you set `summaryModel` to `haiku`. With them on, after each turn the mod asks Claude Haiku for a one-line summary, through Claude Code's own model access, on the plan or API key your session already uses. Each request carries the first 200 characters of your prompt, the start of Claude's final answer (1,500 characters at most), the names of the files written (not their paths or contents) and the number of commands run. It goes to Anthropic like every other request your session makes, under [Anthropic's privacy policy](https://www.anthropic.com/legal/privacy), and the mod never reads a key, token or credential itself. + +## Deleting what it keeps + +A session nobody has opened for `retentionDays` (90 by default) is pruned: its pad, its timeline file and its index row are deleted. Uninstalling the mod leaves your notes and timelines where they are. To remove them, delete `~/.claude/sessionpad/` and the mod's file under `~/.claude/plugins/store/`. + +## Changes and questions + +This policy changes with the mod, and its history is in the repository. Ask a question or report a problem on [GitHub issues](https://github.com/j127/sessionpad/issues). diff --git a/README.md b/README.md index 73e5908..66f0b18 100644 --- a/README.md +++ b/README.md @@ -103,7 +103,7 @@ For the Desktop app, add the folder to `CLAUDE_CODE_PLUGIN_DIRS` in the `env` bl ## What is stored, and where -Everything stays on your machine, with one exception: the summary line. The mod makes no network calls of its own. +Everything stays on your machine, with one exception: the summary line. The mod makes no network calls of its own. [PRIVACY.md](PRIVACY.md), the privacy policy the plugin directory's listing links to, says the same in one page. - The headline and notes for each session live in the mod's key-value store, a JSON file under `~/.claude/plugins/store/`, under the key `notes:`. - A small index, `index`, records each session's working directory, repository root and when it was last seen. Pruning reads it, and an all-sessions view could later. @@ -215,4 +215,4 @@ Decisions made while building, and places where this build of Claude Code (2.1.3 ## License -MIT. See [LICENSE](LICENSE); the same file ships inside `sessionpad/`, the folder people install. +MIT. See [LICENSE](LICENSE); the same file ships inside `sessionpad/`, the folder people install. The license is also the terms the plugin directory's listing links to. Ask questions and report problems on [GitHub issues](https://github.com/j127/sessionpad/issues). diff --git a/justfile b/justfile index 304aba0..98774c1 100644 --- a/justfile +++ b/justfile @@ -36,11 +36,11 @@ script_test: # Check formatting of the mod, the scripts, the marketplace file and the docs format_check: - bunx prettier --check sessionpad scripts .claude-plugin README.md CHANGELOG.md package.json + bunx prettier --check sessionpad scripts .claude-plugin README.md CHANGELOG.md PRIVACY.md package.json # Rewrite files into Prettier's format format: - bunx prettier --write sessionpad scripts .claude-plugin README.md CHANGELOG.md package.json + bunx prettier --write sessionpad scripts .claude-plugin README.md CHANGELOG.md PRIVACY.md package.json # Read the mod, then the marketplace file that lists it, the way Claude Code # will, treating warnings as errors diff --git a/scripts/listing.test.ts b/scripts/listing.test.ts new file mode 100644 index 0000000..dc2629e --- /dev/null +++ b/scripts/listing.test.ts @@ -0,0 +1,36 @@ +// The links the plugin directory's listing shows, read from plugin.json: +// each is an https URL, and one that points at a file of this repository +// on main names a file that is here, so the link works once it is merged. + +import { describe, expect, test } from "bun:test"; + +const REPOSITORY = "https://github.com/j127/sessionpad"; +const LINKS = [ + "homepage", + "repository", + "supportUrl", + "privacyPolicyUrl", + "termsOfServiceUrl", +] as const; + +const manifest = (await Bun.file( + "sessionpad/.claude-plugin/plugin.json" +).json()) as Record; + +describe("the listing's links in plugin.json", () => { + for (const field of LINKS) { + test(`${field} is an https URL into the repository`, async () => { + const url = manifest[field]; + expect(typeof url).toBe("string"); + expect(String(url).startsWith(`${REPOSITORY}`)).toBe(true); + const file = /\/blob\/main\/(.+)$/.exec(String(url))?.[1]; + if (file !== undefined) { + expect(await Bun.file(file).exists()).toBe(true); + } + }); + } + + test("support goes to the repository's issues", () => { + expect(manifest.supportUrl).toBe(`${REPOSITORY}/issues`); + }); +}); diff --git a/sessionpad/.claude-plugin/plugin.json b/sessionpad/.claude-plugin/plugin.json index 9f0062d..e45d516 100644 --- a/sessionpad/.claude-plugin/plugin.json +++ b/sessionpad/.claude-plugin/plugin.json @@ -9,6 +9,9 @@ "homepage": "https://github.com/j127/sessionpad", "license": "MIT", "repository": "https://github.com/j127/sessionpad", + "supportUrl": "https://github.com/j127/sessionpad/issues", + "privacyPolicyUrl": "https://github.com/j127/sessionpad/blob/main/PRIVACY.md", + "termsOfServiceUrl": "https://github.com/j127/sessionpad/blob/main/LICENSE", "types": "./types/index.d.ts", "userConfig": { "showBand": { diff --git a/sessionpad/README.md b/sessionpad/README.md index 6b5707c..512a43e 100644 --- a/sessionpad/README.md +++ b/sessionpad/README.md @@ -63,6 +63,10 @@ From the author's own marketplace instead: in a terminal session, `/plugin insta The full README, with the design notes, how to run the tests and what each setting does in detail, is at [github.com/j127/sessionpad](https://github.com/j127/sessionpad). +## Privacy and support + +The [privacy policy](https://github.com/j127/sessionpad/blob/main/PRIVACY.md) says what the mod keeps and sends, as above: the author collects nothing. Ask questions and report problems on [GitHub issues](https://github.com/j127/sessionpad/issues). + ## License -MIT. See [LICENSE](LICENSE). +MIT. See [LICENSE](LICENSE). The license is also the mod's terms of use. From 244f0c2227b2402b0e4dd88b1e1ea195a9e4df03 Mon Sep 17 00:00:00 2001 From: J Date: Thu, 29 Oct 2026 17:41:32 -0700 Subject: [PATCH 2/3] Make the beta note a plain paragraph, without the warning The READMEs opened with a warning callout that said to use the mod at your own risk, which reads as a reason not to install it. They now say it is beta software in a plain paragraph, with the same advice to keep what you can't lose elsewhere and the same pointer to /pad-export. --- CHANGELOG.md | 2 +- README.md | 3 +-- sessionpad/README.md | 3 +-- 3 files changed, 3 insertions(+), 5 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index e6f873a..ab32b28 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,7 +4,7 @@ ### Changed -- The READMEs call sessionpad beta software rather than alpha. +- The READMEs call sessionpad beta software rather than alpha, in a plain note at the top instead of a warning. - The Timeline tab's summary offer says how to turn summary lines on (set `summaryModel` to `haiku`) and has a **Got it** button, instead of a **Turn on summaries** button that changed the setting: the plugin directory accepts no settings call from a mod that keeps its engine for later, as every button and timer in this one does. A change in `/config` reloads the mod with the new value. - The modules in `sessionpad/src` no longer take Claude Code's `$`. The hooks module builds one object from it, `ioOf($)`, with every call the mod makes written out there, and hands them that: the plugin directory reads a mod's calls from its hooks module alone and refuses `$` passed to another file. What the mod does is unchanged. - `just dollar_check` applies the plugin directory's rule for `$` and `on` (`scripts/dollar_check.ts`) and lists every place that breaks it, and `just check` runs the script's tests (`just script_test`). diff --git a/README.md b/README.md index 66f0b18..4cceee4 100644 --- a/README.md +++ b/README.md @@ -2,8 +2,7 @@ A Claude Code mod that gives every session a small notepad: a one-line headline that says what the session is for, plus notes written by you or by Claude. Open any session after a few days away and see at a glance what it was doing and what is left to do. -> [!WARNING] -> **sessionpad is beta software. Use it at your own risk.** A later version may change how it stores your notes. Keep anything you can't lose somewhere else as well; `/pad-export` writes a session's notes and timeline to a Markdown file. +sessionpad is beta software. A later version may change how it stores your notes. Keep anything you can't lose somewhere else as well; `/pad-export` writes a session's notes and timeline to a Markdown file. > [!NOTE] > **Summary lines spend some of your Claude usage, so they are off until you turn them on.** With them on, the mod asks Claude Haiku for a one-line summary after each turn. A call sends about 500 tokens and gets about 20 back. At the API prices of October 2026 that is about $0.00006 a turn on Haiku 5.5 ($0.10 and $0.50 per million tokens in and out), or about 6 cents per 1,000 turns; if your Claude Code's `haiku` is Haiku 4.5 ($1 and $5), ten times that. On a Pro or Max plan it counts against your usage limits instead of costing money, and a single turn of your own conversation usually uses thousands of times as much. The Timeline tab's last line shows the running total. diff --git a/sessionpad/README.md b/sessionpad/README.md index 512a43e..a5a6281 100644 --- a/sessionpad/README.md +++ b/sessionpad/README.md @@ -2,8 +2,7 @@ A notepad for each Claude Code session. Give a session a one-line headline that says what it is for, keep notes beside the chat (yours, or ones Claude takes when you ask), and see a timeline of what each turn did and where the session's work lives on disk. Open a session after a few days away and see at a glance what it was doing and what is left to do. -> [!WARNING] -> **Session Pad is beta software. Use it at your own risk.** A later version may change how it stores your notes. Keep anything you can't lose somewhere else as well; `/pad-export` writes a session's notes and timeline to a Markdown file. +Session Pad is beta software. A later version may change how it stores your notes. Keep anything you can't lose somewhere else as well; `/pad-export` writes a session's notes and timeline to a Markdown file. Session Pad is a Claude Code mod: it runs in Claude Code 2.1.299 or later, in the Desktop app's Code tab or a terminal, and not in claude.ai chat, Cowork or the Desktop app's WSL sessions. From 56955762cca5345e3cc155e02ab8eac7bdfec501 Mon Sep 17 00:00:00 2001 From: J Date: Thu, 29 Oct 2026 17:48:27 -0700 Subject: [PATCH 3/3] Make the privacy policy match what the mod sends and keeps The review found that PRIVACY.md said only the summary lines leave the machine, but the notes_read tool hands the model the headline and the newest notes when the user asks about the pad, and those go out with the conversation. Both cases are now named, along with where those requests actually go: wherever the session's other requests go, under the same terms. The READMEs and the CHANGELOG said the same and are corrected. The policy also now says what the mod looks at, names the store file (sessionpad_..json, one per copy), gives the steps to delete everything in order, says what pruning removes and that exports are never pruned, says when it takes effect, and asks for no private details in public issues. scripts/listing.test.ts pins the privacy and terms links exactly, checks the files with git ls-files (tracked, spelled the same), refuses a URL that only starts like the repository's, and runs from any folder. --- CHANGELOG.md | 2 +- PRIVACY.md | 31 ++++++++++++++++++++------- README.md | 2 +- scripts/listing.test.ts | 46 +++++++++++++++++++++++++++++++---------- sessionpad/README.md | 2 +- 5 files changed, 61 insertions(+), 22 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index ab32b28..8ad0e53 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,7 +12,7 @@ ### Added - An icon and a README of its own in the plugin folder, for a listing in Anthropic's plugin directory. The icon's source is `assets/icon.svg`. -- The listing's links in `plugin.json`: a privacy policy (`PRIVACY.md`: the author collects nothing, and only the opt-in summary lines leave your machine), the terms (the MIT license) and support (GitHub issues). +- The listing's links in `plugin.json`: a privacy policy (`PRIVACY.md`: the author collects nothing, and what leaves your machine goes only through Claude Code's own model requests, as the notes Claude reads when you ask about the pad and the opt-in summary lines), the terms (the MIT license) and support (GitHub issues). ## 0.3.0 (2026-10-29) diff --git a/PRIVACY.md b/PRIVACY.md index 4b0c786..51fd283 100644 --- a/PRIVACY.md +++ b/PRIVACY.md @@ -1,27 +1,42 @@ # Session Pad privacy policy -Session Pad is a mod for Claude Code, made by J and published at [github.com/j127/sessionpad](https://github.com/j127/sessionpad). This policy covers the mod itself. +This policy applies from version 0.4.0 of Session Pad, a mod for Claude Code made by J and published at [github.com/j127/sessionpad](https://github.com/j127/sessionpad). It covers the mod itself. ## What the author collects Nothing. The mod has no server, no account, no analytics and no telemetry, and it makes no network calls of its own. Nothing you write in it, and nothing about how you use it, is ever sent to the author. +## What it looks at + +To build each session's timeline, the mod looks at each prompt you send and at each Edit, Write, NotebookEdit and Bash call, and keeps only what the next section lists; the text of a Bash command is never kept, only how many ran. It runs `git`, read-only, for the branch and the worktrees, and `du` for their sizes, and their output stays on your machine. It reads the environment variables `HOME`, `USERPROFILE` and `CLAUDE_CONFIG_DIR`, and never reads a key, token or credential. + ## What stays on your machine -Everything the mod keeps is stored on your computer. The two `~/.claude` folders below are under `CLAUDE_CONFIG_DIR` instead when that is set. +Everything the mod keeps is stored on your computer. Every `~/.claude` path in this policy is under `CLAUDE_CONFIG_DIR` instead when that is set. -- each session's headline and notes, an index of sessions with each one's working folder, repository root and when it was last seen, each worktree's measured size, the running total of summary calls, whether the summary offer was answered, and when the last prune ran, in the mod's key-value store under `~/.claude/plugins/store/`; -- one timeline file a session under `~/.claude/sessionpad/timeline/`, with when each turn ended and how long it ran, the prompt's first 200 characters, a one-line summary, up to 25 paths written, the number of commands run, the branch, the worktree's path and the turn's token counts; -- exports under `~/.claude/sessionpad/exports/`, or at the path you give `/pad-export`. +- In the mod's key-value store, a file named `sessionpad_…json` in `~/.claude/plugins/store/` (one per copy of the mod): each session's headline and notes; an index of sessions, with each one's working folder, repository root and when it was last seen; each worktree's measured size, keyed by its path; the running total of summary calls; whether the summary offer was answered; and when the last prune ran. +- One timeline file a session in `~/.claude/sessionpad/timeline/`, each entry holding when the turn ended and how long it ran, the prompt's first 200 characters, a one-line summary, up to 25 paths written, the number of commands run, the branch, the worktree's path and the turn's token counts. A timeline file the mod can't read is copied aside, as `.json.corrupt-