A CLI tool that generates README files for your repository using LLMs, or offline without an API key.
SupportPages-io/wtfm
A plugin for Claude Code and Codex that writes end-user help articles from your source code, with screenshots rendered from your own UI markup.
- Stars
- 121
- Forks
- 10
- Open issues
- 7
- Last commit
- 2 days ago
What is it?
WTFM is a plugin for coding agents such as Claude Code and Codex that writes end-user documentation: how-to and troubleshooting guides for people who use a product rather than build it. The agent reads the relevant source, takes routes, button labels and flows from the code, and writes the steps in plain language.
Each screen in a guide is shown with a screenshot. WTFM rebuilds mockups from the project's own markup, styles and branding, then renders them to PNG in a local headless Chromium, so no running app or manual capture is needed. Articles are saved as Markdown folders with their images beside them, and each article passes structure, copy and screenshot checks before it is saved.
The tool runs locally with your own agent subscription. Publishing to SupportPages.io is optional and only happens when you choose it. macOS and Linux are supported, with Windows usable through WSL.
Key features
- 01Writes how-to and troubleshooting articles from the project's source code.
- 02Renders screenshots from the project's own markup, styles and branding without running the app.
- 03Outputs plain Markdown with images stored beside each article.
- 04Checks structure, copy and screenshots before saving.
- 05Works with Claude Code or Codex through a one-time setup command.
Use cases
- Writing a guide for customers who cannot find a feature in your product.
- Documenting admin tasks such as inviting team members or changing settings.
- Producing illustrated troubleshooting articles for a help centre.
- Keeping user documentation in the same repository as the product code.
Quick start
- 1
Run the official install script from the README
- 2
Set up your computer
wtfm setup - 3
Set up your project
wtfm init - 4
Ask Claude Code or Codex in your project to write an article
Things to know
- Supports macOS and Linux only; Windows users need WSL.
- Requires Claude Code or Codex installed and signed in, plus Git.
- Chromium for screenshots is downloaded the first time you run setup.
In collections
Topics
FAQ
- What is wtfm?
- A plugin for Claude Code and Codex that writes end-user help articles from your source code, with screenshots rendered from your own UI markup. WTFM is a plugin for coding agents such as Claude Code and Codex that writes end-user documentation: how-to and troubleshooting guides for people who use a product rather than build it. The agent reads the relevant source, takes routes, button labels and flows from the code, and writes the steps in plain language.
- Is wtfm free to use? What license does it have?
- wtfm is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
- Is wtfm still maintained?
- Actively maintained. The last commit to wtfm was on Nov 5, 2026.
- What can I use wtfm for?
- Writing a guide for customers who cannot find a feature in your product. Documenting admin tasks such as inviting team members or changing settings. Producing illustrated troubleshooting articles for a help centre. Keeping user documentation in the same repository as the product code.
- How do I install wtfm?
- Run the official install script from the README Set up your computer: wtfm setup Set up your project: wtfm init Ask Claude Code or Codex in your project to write an article
- Where can I get wtfm?
- The source code and installation instructions are on GitHub: https://github.com/SupportPages-io/wtfm
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A local browser-based review surface that lets you annotate agent plans, markdown, HTML and code diffs, then send feedback back to coding agents.
A free, self-hosted knowledge base web app built with PHP and MySQL, with a rich article editor and optional read-only JSON API.
A Rust CLI for managing git worktrees by branch name, built for running multiple AI coding agents in parallel.
A CLI app for running and switching between multiple AI coding agent sessions across Git worktrees and projects, without tmux.
A CLI and TUI for installing, curating and sharing a library of skills for AI coding agents, with the author's own bundled picks.