@unleashwp/ai-forge
v0.3.0
Published
UnleashWP AI Forge — a hub for WordPress release tooling. Runs a browser UI, a zero-dependency CLI, and an MCP server (`uwp mcp`) so Claude Code and Codex can query its tools and skills live.
Downloads
163
Readme
UnleashWP AI Forge
The AI tool for WordPress, by UnleashWP.
AI Forge is a small program you run on your own computer. It is two things at once:
- A home for WordPress plugins. You keep the ones you want; AI Forge runs them and gives them one clean interface.
- A bridge to your AI. AI Forge plugs into Claude Code, Claude Desktop and Codex, so your assistant can use those plugins directly and hand you the results.
It comes with one plugin to start: the Changelog Generator — it builds the list of everything that changed in a WordPress release between two dates, ready to paste into a release post. More plugins will follow.
You can use it three ways: type one command, click buttons in your browser, or just ask Claude or Codex.
Install in about a minute
Using Claude Code? Add it as a plugin — two lines, then restart:
/plugin marketplace add unleash-wp/ai-forge
/plugin install uwp-ai-forge@unleashwp-ai-forgePrefer the command line? You need Node.js 18 or newer, then:
npm install -g @unleashwp/ai-forgeThat puts uwp-ai-forge on your PATH (uwp and forge are aliases).
Connect WordPress.org — required
AI Forge reads WordPress.org Trac to count changes and contributors. Trac blocks logged-out scripts with a bot wall, so without a logged-in WordPress.org session the contributor and Core ticket counts come back inaccurate. Connect once — AI Forge imports the cookie from a browser you're already signed in to:
uwp-ai-forge cookie-import <chrome|safari|firefox|edge>Or open the app (uwp-ai-forge serve), go to Setup → Connectors, and sign in
to WordPress.org there. The cookie stays on your own computer and is sent only to
WordPress.org. Until you connect, the tools refuse rather than return wrong numbers.
Let your AI install it for you
Use Claude Code or Codex? Paste this and send it:
Install "UnleashWP AI Forge" (npm package @unleashwp/ai-forge, command
"uwp-ai-forge"). First ask me whether I want to use its browser app or do
everything here in chat, then do the setup yourself — install it, connect it to
you as an MCP server, and connect WordPress.org (required, or the counts are
wrong). Run the commands, and after each step tell me in one sentence what
happened. Stop and ask me only when something truly needs my decision.Your assistant checks Node, installs AI Forge, wires it up, walks you through the required WordPress.org connection, and tests it.
Use it
- Type a command — run
uwp-ai-forge -hto see everything it can do:uwp-ai-forge changelog --since 2026-07-15 --until 2026-07-22 --milestone 7.1 --post - Click instead of type — run
uwp-ai-forge serve, then open http://localhost:4321. Pick your dates, press a button, copy the result. - Just ask your AI — once it's connected:
- "Give me the WordPress 7.1 changelog for July 15 to 22, as a post."
- "Draft the WordPress 7.1 release post and link every highlight to its source."
Do I need a GitHub token?
No — that one is optional. A GitHub token only lets AI Forge ask GitHub more often per hour (60 → 5,000). No password, no special permissions. Add it later in Settings → Connectors if AI Forge tells you it hit a limit.
(The WordPress.org connection above is required — that's the one credential AI Forge can't work correctly without.)
Want more?
- 📖 Handbook — the complete guide: what it is, all install paths, example prompts, connectors, the changelog generator, and how to build a plugin.
- Quick Start — the short version of this page.
- Wiki — reference pages on GitHub.
- CONTRIBUTING.md — add your own plugin. Every plugin is just a folder.
An independent project by UnleashWP (Benjamin Zekavica, Morvance). Not affiliated with the WordPress Foundation or Automattic Inc.
