Project instructions, skills, subagents, HOI4 tools, and an offline wiki for Claude Code, Codex,
Cursor, and many more coding clients.
Two ways to use it:
- Desktop app (recommended): the full setup for Windows, macOS, and Linux.
- Web edition: lighter and faster for the basics, with nothing to install.
Desktop app (recommended)
Writes into your mod after you review every change, with a backup and Undo changes, and can
update, repair, or remove its setup later.
Open it, choose Create new mod or Import existing mod, and follow the steps. The app
updates itself; release notes list the
signing details.
Windows or macOS shows a warning the first time? The builds are free and not signed with a paid
certificate, so this is expected. On Windows click More info, then Run anyway. On macOS open
System Settings, Privacy & Security, and click Open Anyway. The
step-by-step guide has the details.
What each system gets:
| Windows | macOS | Linux x64 |
|---|
| Instructions, skills, subagents, offline wiki | Yes | Yes | Yes |
| hoi4-imagegen | Yes | Yes | Yes |
| HOI4 Agent Tools | Yes | Not yet | Yes |
| HOI4 Live Tools, 3D models workflow | Yes | No | No |
| Clausewitz MCP live testing | Through WSL | Through SSH to Linux | Native |
An unavailable item shows as "Not available on this computer" and never blocks the rest of the setup.
Web edition (lightweight)
Open the web edition → Nothing to install and
nothing uploaded. Start a new mod or drop your mod's folder, review the result, and download a ZIP to
unpack over a copy of your mod. When you want more later, download the extra pieces manually or use
the desktop app for the fuller install.
Existing mods
Your descriptor.mod, thumbnail.png, README.md, and mod content are never overwritten. Importing
only reads the folder. Updating again shows only the files you edited, and an interrupted install can
be undone. Details in the user guide.
What it installs
Setup downloads only what you select, checks every file before applying it, and registers the tools
with your coding client.
- Agentic HOI4 Modding is the workflow
kit: project instructions, skills, subagents, and an offline wiki that teach your AI client how
HOI4 modding works.
- HOI4 Agent Tools is an MCP server with
local references, visual previews, and tools for focus trees, interfaces, and maps.
- hoi4-imagegen is an MCP server that makes
and edits graphical assets, then processes, validates, and exports them as DDS. Setup installs it
with one checkbox and offers the ChatGPT sign-in. Sign-in, providers, and troubleshooting are in its README.
- HOI4 Live Tools is an experimental MCP server
that lets your AI client test the mod and play the game. Stable on Windows. The alternative is
Clausewitz MCP by smerss, which needs native Linux.
- ComfyUI portraits are
identity-preserving leader portrait workflows, run on Comfy Cloud, your own ComfyUI, or RunPod.
- 3D models workflow prepares
Meshy and Blender on Windows. A missing
Meshy key leaves only this workflow incomplete.
- Coding clients: Claude Code, Codex, Cursor, and many
more each get their own native package. You pick one primary client and any others.
Learn more
Privacy
No telemetry. Provider keys stay in Windows Credential Manager, macOS Keychain, or
Linux Secret Service (desktop) or in the open tab's memory (web); secret values
are never written into your mod. The web edition lists every network request it
makes under Network.
License
Apache License 2.0. See LICENSE.
