Skip to content
Back to search

supportpages

MarketplaceWorks with Claude CodeGitHub

WTFM by SupportPages.io: your coding agent writes the user docs from your codebase, screenshots included.

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/SupportPages-io/wtfm with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/SupportPages-io/wtfm'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/supportpages-io--wtfm/badge.svg)](/listings/supportpages-io--wtfm)

HTML

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

Install

Install instructions from the README

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

These steps run a script from the network that findsafeskills does not scan.

curl -fsSL https://wtfm.sh/install | bash

The installer downloads a checksum-verified release with its own Node.js, installs the `wtfm` command into `~/.local/bin` (no `sudo`), and offers to add it to your `PATH`. It also installs `supportpages` as an alias for `wtfm`.

**You'll need:**

- macOS or Linux, on ARM64 or x64 (on Windows, use WSL) - [Claude Code](https://claude.com/claude-code) or [Codex](https://github.com/openai/codex), installed and signed in - Git

Chromium for screenshots is downloaded the first time you run `wtfm setup`.

**Updating:** releases check for updates once a day and install them in the background. Run `wtfm update` to update now, or set `SUPPORTPAGES_AUTO_UPDATE=0` to turn automatic updates off.

Build from source

You'll need Node.js 22.12 or later, npm and Git.

git clone https://github.com/SupportPages-io/wtfm.git
cd wtfm
./install-cli.sh

This builds your checkout and installs it as `wtfm` (with the `supportpages` alias). Run `./install-cli.sh` again after pulling changes.

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 · 14 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": "supportpages",
  3. "owner": { "name": "SupportPages.io", "url": "https://supportpages.io" },
  4. "description": "WTFM by SupportPages.io: your coding agent writes the user docs from your codebase, screenshots included.",
  5. "plugins": [
  6. {
  7. "name": "wtfm",
  8. "description": "Your coding agent writes the user docs from your codebase, screenshots included.",
  9. "source": { "source": "url", "url": "https://github.com/SupportPages-io/wtfm.git", "ref": "claude-plugin" },
  10. "homepage": "https://github.com/SupportPages-io/wtfm#readme",
  11. "license": "Apache-2.0"
  12. }
  13. ]
  14. }
README.md · README · 437 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. <h1 align="center">WTFM</h1>
  2. <p align="center">
  3. <strong>Write the F***ing Manual.</strong><br>
  4. A plugin for your coding agent that writes the user docs. Screenshots included.
  5. </p>
  6. <p align="center">
  7. <a href="LICENSE"><img alt="License: Apache 2.0" src="https://img.shields.io/badge/license-Apache%202.0-blue.svg"></a>
  8. <img alt="Platforms: macOS and Linux" src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey.svg">
  9. <img alt="Works with Claude Code and Codex" src="https://img.shields.io/badge/works%20with-Claude%20Code%20%7C%20Codex-8A2BE2.svg">
  10. </p>
  11. <p align="center">
  12. <a href="#install">Install</a> ·
  13. <a href="#quick-start">Quick start</a> ·
  14. <a href="#examples">Examples</a> ·
  15. <a href="#cli-commands">CLI</a> ·
  16. <a href="#publish">Publish</a> ·
  17. <a href="#faq">FAQ</a> ·
  18. <a href="https://help.wtfm.sh/">Docs</a> ·
  19. <a href="https://supportpages.io/wtfm">Website</a>
  20. </p>
  21. <p align="center">
  22. <img src="docs/images/demo.gif" width="880" alt="Claude Code writing an illustrated guide to adding a site in Plausible Analytics: the prompt, the writer's progress, and the finished article with screenshots">
  23. <br>
  24. <sub>Real output from <a href="https://github.com/plausible/analytics">plausible/analytics</a>, replayed fast. A real run takes a few minutes.</sub>
  25. </p>
  26. **WTFM is a plugin for your coding agent that writes your user docs.** Ask
  27. [Claude Code](https://claude.com/claude-code) or [Codex](https://github.com/openai/codex)
  28. for a guide and it reads your source, writes the steps in plain language, and shows every
  29. screen with a screenshot rendered from your real templates and CSS. No running app, no
  30. manual captures, no account.
  31. Not API reference, not a README: docs for the people who will never read your code,
  32. like the customer who can't find the export button, or the admin inviting their team.
  33. > WTFM was formerly SupportPages Writer. The `supportpages` command still works as
  34. > an alias for `wtfm`, and existing installations, settings and `SUPPORTPAGES_*`
  35. > environment variables are unchanged.
  36. Set it up once in your terminal, then just ask your agent:
  37. ```sh
  38. curl -fsSL https://wtfm.sh/install | bash
  39. ```
  40. ```sh
  41. wtfm setup # once per computer
  42. ```
  43. ```sh
  44. wtfm init # once per project
  45. ```
  46. > **You → Claude Code:** Write an illustrated guide to inviting a teammate.
  47. ## Features
  48. - **Written from your source.** Routes, button labels and flows come from the code,
  49. not from a description you type, so the steps match what users actually see.
  50. - **Screenshots without running the app.** Mockups are rebuilt from your own markup,
  51. styles and branding, then rendered to PNG in a local headless Chromium.
  52. - **Plain Markdown output.** Each article is an `index.md` with its images beside it,
  53. ready to commit next to your code or drop into any docs site.
  54. - **Checked before it's saved.** Every article passes structure, copy and screenshot
  55. checks first.
  56. - **Uses the agent you already have.** Claude Code or Codex, with your own subscription
  57. and model settings.
  58. - **Local-first.** Nothing is sent to SupportPages.io unless you choose to publish.
  59. ## Examples
  60. The same loop on other open-source codebases. Each image is one screenshot from a
  61. guide WTFM wrote from that repository's source; the apps were never run.
  62. | [immich-app/immich](https://github.com/immich-app/immich) · SvelteKit | [paperless-ngx/paperless-ngx](https://github.com/paperless-ngx/paperless-ngx) · Angular | [maybe-finance/maybe](https://github.com/maybe-finance/maybe) · Rails |
  63. | --- | --- | --- |
  64. | <img src="docs/images/immich.png" alt="Immich albums page, from How to create a new album"> | <img src="docs/images/paperless.png" alt="Paperless-ngx Create new tag dialog, from How to create a tag and apply it to a document"> | <img src="docs/images/maybe.png" alt="Maybe Enter account balance dialog, from How to add a new account"> |
  65. | How to create a new album | How to create a tag and apply it to a document | How to add a new account |
  66. For a whole help centre, see [WTFM's own docs](https://help.wtfm.sh/): every
  67. article and screenshot there was written by WTFM from this repository.
  68. ## Install
  69. ```sh
  70. curl -fsSL https://wtfm.sh/install | bash
  71. ```
  72. The installer downloads a checksum-verified release with its own Node.js, installs
  73. the `wtfm` command into `~/.local/bin` (no `sudo`), and offers to add it to your
  74. `PATH`. It also installs `supportpages` as an alias for `wtfm`.
  75. **You'll need:**
  76. - macOS or Linux, on ARM64 or x64 (on Windows, use WSL)
  77. - [Claude Code](https://claude.com/claude-code) or [Codex](https://github.com/openai/codex),
  78. installed and signed in
  79. - Git
  80. Chromium for screenshots is downloaded the first time you run `wtfm setup`.
  81. **Updating:** releases check for updates once a day and install them in the background.
  82. Run `wtfm update` to update now, or set `SUPPORTPAGES_AUTO_UPDATE=0` to turn
  83. automatic updates off.
  84. ### Install in Codex
  85. WTFM is also a Codex plugin. You'll need Node.js 22.12 or later with npm on your
  86. `PATH`.
  87. ```sh
  88. codex plugin marketplace add SupportPages-io/wtfm
  89. codex plugin add wtfm@supportpages
  90. ```
  91. Then start a new Codex session. The first time the plugin starts, it installs its npm
  92. packages (without running their install scripts) and downloads Chromium for
  93. screenshots in the background. Codex asks you to review the plugin's two hooks in
  94. `/hooks` before they run; WTFM works without them. To update, run
  95. `codex plugin add wtfm@supportpages` again.
  96. ### Build from source
  97. You'll need Node.js 22.12 or later, npm and Git.
  98. ```sh
  99. git clone https://github.com/SupportPages-io/wtfm.git
  100. cd wtfm
  101. ./install-cli.sh
  102. ```
  103. This builds your checkout and installs it as `wtfm` (with the `supportpages` alias).
  104. Run `./install-cli.sh` again after pulling changes.
  105. ## Quick start
  106. Configure once in the terminal, then do everything else in your coding agent.
  107. ### 1. Set up your computer
  108. ```sh
  109. wtfm setup
  110. ```
  111. This connects Claude Code and/or Codex, adds the SupportPages.io writer to them and
  112. downloads the screenshot renderer. When it asks how you want to work, choose
  113. **Save articles in my projects without an account**.
  114. ### 2. Set up your project
  115. ```sh
  116. cd path/to/your-product
  117. wtfm init
  118. ```
  119. Pick where articles should be saved and which model to use. WTFM then
  120. studies the project's structure, styles and branding once, so every article starts
  121. from that analysis.
  122. ### 3. Ask your coding agent
  123. Open Claude Code or Codex in your project (restart any session that was already open)
  124. and ask for an article in plain words:
  125. > Write an illustrated guide to inviting a teammate.
  126. A few minutes later the article is in your project:
  127. ```text
  128. output/articles/how-to-invite-a-teammate/
  129. ├── index.md
  130. ├── block_open-settings.png
  131. ├── block_invite-form.png
  132. └── block_send-invite.png
  133. ```
  134. That's the whole loop. Some other things to ask:
  135. > What help articles do we have?
  136. > Write a troubleshooting article for when a sign-in link has expired.
  137. ## CLI commands
  138. You only need the terminal to set things up and keep them running. Writing happens in
  139. your coding agent.
  140. | Command | What it does |
  141. | --- | --- |
  142. | `wtfm setup` | Set up this computer: connect your coding agents and install the renderer |
  143. | `wtfm init` | Set up this project: where articles go, which model, project analysis |
  144. | `wtfm configure` | Change this project's agent, model, writing style or article folder |
  145. | `wtfm analyse` | Re-run project analysis after big changes (`--refresh`) |
  146. | `wtfm status` | Show this project's setup and article progress |
  147. | `wtfm doctor` | Check that everything is installed and connected |
  148. | `wtfm telemetry off` | Stop anonymous usage counts and crash reports (`on`, `status`) |
  149. | `wtfm update` | Install the latest release |
  150. | `wtfm uninit` | Forget this project's setup (keeps a recovery archive) |
  151. | `wtfm remove` | Disconnect from your coding agents (keeps projects and articles) |
  152. | `wtfm uninstall` | Remove WTFM from this computer; `--purge-config` also signs out and forgets project bindings |
  153. Run `wtfm --help` for every option. `status` and `doctor` accept `--json`.
  154. ## Your articles
  155. - **Where they go.** `output/articles/<slug>/` by default. To keep them in your repo,
  156. choose a folder like `docs/help` during `init` or with `wtfm configure`.
  157. - **Writing style.** Pick from friendly, minimal, technical or formal with
  158. `wtfm configure`.
  159. - **Screenshots.** Each article gets up to three. The main path gets them first;
  160. optional branches are described in text. Every screenshot carries a small
  161. "created automatically by supportpages.io" strip.
  162. ## How it works
  163. 1. `setup` connects a local [MCP](https://modelcontextprotocol.io) server and a
  164. writer agent to Claude Code or Codex.
  165. 2. `init` has your agent map the project once: framework, routes, layouts, CSS and
  166. branding.
  167. 3. When you ask for an article, the writer agent reads the relevant source, writes the
  168. steps, and builds each screenshot as an HTML mockup of your real UI.
  169. 4. The mockups are rendered to PNG with a local Chromium, checked against your source,
  170. and saved with the article.
  171. ## Publish
  172. **Give your users somewhere to read it.** A Markdown folder in your repo helps nobody
  173. who can't find it. [SupportPages.io](https://supportpages.io/?utm_source=wtfm&utm_medium=readme),
  174. made by the same team, turns the guides WTFM writes into a help centre your users can
  175. search and ask: on your own domain, in your branding, and kept current as the product
  176. changes.
  177. <p align="center">
  178. <img src="docs/images/help-centre.png" width="720" alt="help.supportpages.io, a help centre hosted on SupportPages.io: AI search, suggested questions and article categories">
  179. </p>
  180. - **Kept current on every merge.** When a pull request merges, SupportPages.io reads
  181. the diff and drafts the article updates for you to review.
  182. - **Video walkthroughs.** Each guide can come with a narrated video that clicks through
  183. the same steps, with captions.
  184. - **Answers, not just search.** Readers ask in their own words and get an answer drawn
  185. from your articles, with the sources linked.
  186. - Your branding on your own domain, an editor to review drafts before anyone sees them,
  187. and publishing straight from your coding agent.
  188. Everything above works without it, and a free account hosts up to 10 articles.
  189. The same pattern applies: connect once in the terminal, then work in your agent.
  190. **Connect a project:**
  191. ```sh
  192. wtfm publish
  193. ```
  194. You'll sign in or create an account in your browser and choose a help centre. Any
  195. articles you've already saved upload as drafts. (Setting up a new project? Choose
  196. **Publish them to a SupportPages.io help centre** during `wtfm init` instead.)
  197. **Then keep asking your agent:**
  198. > Write a guide to exporting a report.
  199. New articles arrive in the help centre as drafts, with a link to review them in the
  200. editor. Publishing is always a separate step: click **Publish** in the editor, or ask:
  201. > Publish the guide to exporting a report.
  202. | Command | What it does |
  203. | --- | --- |
  204. | `wtfm publish` | Sign in, pick a help centre and upload this project's saved articles |
  205. | `wtfm yolo` | Write the whole manual on SupportPages.io (account required; drafts only) |
  206. | `wtfm login` / `logout` | Sign this computer in or out |
  207. | `wtfm sync` | Refresh help-centre settings and article history |
  208. A help centre never needs access to your GitHub or Bitbucket. Only `wtfm yolo` does.
  209. ### `wtfm yolo`: write the whole manual
  210. Starting from nothing? `wtfm yolo` plans every guide your product needs and
  211. writes them all at once, on SupportPages.io's servers instead of your computer and your
  212. coding agent's usage.
  213. ```sh
  214. wtfm yolo
  215. ```
  216. It walks you through whatever is missing: browser sign-in, choosing or creating a help
  217. centre, and connecting your repository (SupportPages.io needs read access to write from
  218. your code). It then shows your plan's article allowance and asks before starting
  219. (`--yes` skips the question). The free plan covers your first 10 guides.
  220. Progress shows live: sections, recommended articles, then drafts as they are written.
  221. Everything lands as drafts; nothing goes live until you publish it in the editor, whose
  222. link is printed at the end. Ctrl+C only stops watching: the run keeps going, and
  223. `wtfm status` picks it up again. If a run fails, run `wtfm yolo` again to resume it
  224. without losing the drafts already written.
  225. ## Privacy
  226. - **Local projects send only anonymous usage counts and crash reports** to
  227. SupportPages.io (see below). Your coding agent and its model provider read your
  228. source, as they do for any other task.
  229. - **Publishing uploads** the article, its images and a small provenance record.
  230. Your source code is never uploaded.
  231. - **`wtfm yolo` writes on SupportPages.io** from the repository you connect there;
  232. it is the only command that gives SupportPages.io access to your code.
  233. - **Credentials** are stored in private files under `~/.config/supportpages`, never in
  234. your repository. Signing in also saves your account email there, to show which
  235. account is connected.
  236. - **Other network requests carry none of your code or articles.** Chromium for
  237. screenshots downloads from Google's Chrome for Testing storage, and the plugin's
  238. packages install from the npm registry. When a project's own styles can't be
  239. compiled, analysis fetches its CSS framework (Bootstrap, Bulma or Foundation) from
  240. the jsDelivr CDN, and a mockup with no project styles loads Tailwind from its CDN
  241. while rendering. An article's optional generated images use OpenAI only if you
  242. have set your own `OPENAI_API_KEY`; WTFM never sets it.
  243. - **Project analysis runs unattended.** `init` and `analyse` start your agent with its
  244. permission prompts off (`--dangerously-skip-permissions` for Claude Code,
  245. `--dangerously-bypass-approvals-and-sandbox` for Codex). Writing articles uses the
  246. agent's normal approval prompts.
  247. ### Plugin hooks
  248. Installed as a Claude Code plugin, WTFM registers two hooks. Neither sends anything
  249. over the network except the Chromium download, and neither can block or change a
  250. tool call.
  251. - **`SessionStart`** checks whether Chromium for screenshots is installed. If it
  252. isn't, it starts puppeteer's Chromium download in the background, once, and
  253. returns straight away without printing anything into the session.
  254. - **`PostToolUse`** runs after every tool call, but does nothing unless an article
  255. is being written (a `.rtfm-trace/CURRENT` marker in your project). During a run it
  256. appends one line per tool call to `.rtfm-trace/<article>.ndjson` in your project:
  257. the time, tool name, file path, search pattern and the first 500 characters of a
  258. shell command. The trace stays on your computer and is used to spot repeated
  259. work in a run. It prints nothing and always exits successfully.
  260. ### Anonymous usage counts and crash reports
  261. WTFM tells us how many installs are in use and when something breaks, so we
  262. can fix it. It says so the first time you set up a project, and it's easy to turn
  263. off. It is sent to SupportPages.io without your sign-in and stays anonymous until
  264. you sign in from this computer; after that, usage from this computer is linked to
  265. your account. Turning it off stops both.
  266. **What is sent**
  267. - A random install ID created on this computer (not derived from it), the WTFM
  268. version, the coding client's name (e.g. `claude-code`), your OS, CPU architecture
  269. and Node.js major version.
  270. - A count when WTFM is first used and when it is uninstalled (and whether its
  271. settings were kept), when a project is set up (local or hosted),
  272. and when an article or video walkthrough finishes: its outcome, where it went
  273. (local, uploaded or generated on SupportPages.io), an error code if it failed,
  274. and how many seconds it took; likewise when a `wtfm yolo` run starts and ends.
  275. - For unexpected errors only: the error type and code, and stack frames with every
  276. path outside WTFM replaced by `<external>`. Messages from other code are
  277. never sent.
  278. **What is never sent:** your code, file names or paths, article titles or content,
  279. repository or project names, or credentials. Your IP address is not stored. The
  280. install ID is also sent when you sign in from this computer, which is what links
  281. later usage from it to your account.
  282. **Turn it off** with any of these:
  283. - ask your coding agent to turn off SupportPages telemetry;
  284. - run `wtfm telemetry off`;
  285. - set `SUPPORTPAGES_TELEMETRY=0` or `DO_NOT_TRACK=1`.
  286. It is always off in CI. `wtfm doctor` shows whether it's on and why; set
  287. `SUPPORTPAGES_TELEMETRY_DEBUG=1` to print each report to stderr as it is sent.
  288. ## FAQ
  289. **Is this for API docs or READMEs?**
  290. No. WTFM writes end-user documentation: how-to and troubleshooting guides for the
  291. people who use your product, with screenshots. Your agent already handles developer
  292. docs well.
  293. **Why not just ask Claude Code to write the docs?**
  294. It will write you decent steps. It won't show the screen, and it guesses at labels it
  295. hasn't looked up. WTFM adds a project analysis, a renderer that builds screenshots from
  296. your own UI code, and checks that run before anything is saved.
  297. **What does it cost?**
  298. WTFM is free and Apache 2.0. Articles run on your own Claude Code or Codex subscription.
  299. `wtfm yolo` is the exception: it runs on SupportPages.io and needs an account; the free
  300. plan covers 10 guides.
  301. **`wtfm: command not found`**
  302. Open a new terminal, or run the `PATH` command the installer printed.
  303. **My agent can't see the SupportPages tools.**
  304. Restart any Claude Code or Codex sessions that were open during `wtfm setup`.
  305. **Setup won't finish.**
  306. Run `wtfm doctor`, fix what it reports, then run `wtfm init` again.
  307. **An article was interrupted halfway.**
  308. Ask your agent to continue it, or run `wtfm status` to see where it stopped.
  309. **Does it collect usage data?**
  310. Only anonymous counts and crash reports, never your code or articles. See
  311. [Anonymous usage counts and crash reports](#anonymous-usage-counts-and-crash-reports)
  312. to see exactly what is sent or turn it off.
  313. **Can I use it on Windows?**
  314. Yes, inside WSL.
  315. More on [supportpages.io/wtfm](https://supportpages.io/wtfm).
  316. ## Contributing
  317. Bug reports and pull requests are welcome. When reporting a bug, include your OS,
  318. `wtfm --version`, the command you ran and its output, with credentials and
  319. private code removed. For larger changes, open an issue first so we can agree on the
  320. approach.
  321. To work on the code:
  322. ```sh
  323. npm ci
  324. npm test
  325. node scripts/cli.mjs --help
  326. ```
  327. The article engine in `engine/` is synced from upstream on each engine release, so
  328. changes there are reviewed here and ported back by the maintainers.
  329. ## License
  330. [Apache 2.0](LICENSE). The UI stylesheets bundled under `engine/` keep their own
  331. licenses; see [NOTICE](NOTICE). The license doesn't cover the SupportPages name or logo.

Ratings and comments

Sign in to rate this skill.

Sign in

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