How to Install Universal Modder (Claude Code, Codex, Cursor, Gemini CLI)

Install the integration for your agent to load Universal Modder's skills, fal MCP connection and um tools. Copy a quick-install command below, then compare all eight routes and follow the verification steps.

Add the marketplace, then install the plugin. Installation steps

Claude CodeRun in: Claude Code

Select code

/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder

You can select the code to copy it manually.

Add the marketplace and plugin from your terminal. Installation steps

shellRun in: Terminal

Select code

codex plugin marketplace add rehan-remade/universal-modder
codex plugin add universal-modder@universal-modder

You can select the code to copy it manually.

Install the extension from the GitHub repository. Installation steps

shellRun in: Terminal

Select code

gemini extensions install https://github.com/rehan-remade/universal-modder

You can select the code to copy it manually.

Enable chat.plugins.enabled, run Chat: Install Plugin From Source, then enter this URL. Installation steps

URLRun in: Chat: Install Plugin From Source

Select code

https://github.com/rehan-remade/universal-modder

You can select the code to copy it manually.

Install from Cursor Marketplace, or open a clone in Cursor. Installation steps

shellRun in: Terminal (clone route)

Select code

git clone https://github.com/rehan-remade/universal-modder

You can select the code to copy it manually.

Clone the repository and launch OpenCode inside it. Installation steps

shellRun in: Terminal

Select code

git clone https://github.com/rehan-remade/universal-modder
cd universal-modder
opencode

You can select the code to copy it manually.

Requires Node.js and an npm-compatible environment. Configure MCP and the CLI separately if needed. Installation steps

shellRun in: Terminal

Select code

npx skills add https://github.com/rehan-remade/universal-modder

You can select the code to copy it manually.

Clone the repository, then start your agent in that folder. Installation steps

shellRun in: Terminal

Select code

git clone https://github.com/rehan-remade/universal-modder
cd universal-modder

You can select the code to copy it manually.

All eight installation commands are available below without JavaScript.

Claude Code — Add the marketplace, then install the plugin.

/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder

Codex — Add the marketplace and plugin from your terminal.

codex plugin marketplace add rehan-remade/universal-modder
codex plugin add universal-modder@universal-modder

Gemini CLI — Install the extension from the GitHub repository.

gemini extensions install https://github.com/rehan-remade/universal-modder

VS Code / Copilot — Enable chat.plugins.enabled, run Chat: Install Plugin From Source, then enter this URL.

https://github.com/rehan-remade/universal-modder

Cursor — Install from Cursor Marketplace, or open a clone in Cursor.

git clone https://github.com/rehan-remade/universal-modder

OpenCode — Clone the repository and launch OpenCode inside it.

git clone https://github.com/rehan-remade/universal-modder
cd universal-modder
opencode

Skills only — Requires Node.js and an npm-compatible environment. Configure MCP and the CLI separately if needed.

npx skills add https://github.com/rehan-remade/universal-modder

Other agents — Clone the repository, then start your agent in that folder.

git clone https://github.com/rehan-remade/universal-modder
cd universal-modder

Agent or route	Installation
Claude Code	`/plugin marketplace add rehan-remade/universal-modder`, then `/plugin install universal-modder@universal-modder` in Claude
Codex	`codex plugin marketplace add rehan-remade/universal-modder`, then `codex plugin add universal-modder@universal-modder` in a terminal
Gemini CLI	`gemini extensions install https://github.com/rehan-remade/universal-modder`
VS Code / GitHub Copilot	Enable `chat.plugins.enabled`, run Chat: Install Plugin From Source, enter the repository URL
Cursor	Use Cursor Marketplace, or open a clone of the repository
OpenCode	Clone the repository, then run `opencode` inside it
Skills only	`npx skills add https://github.com/rehan-remade/universal-modder`
Other agents	Clone the repository and start your agent in that folder

Requirements

An installed, authenticated agent. Use the agent's own supported operating system and account. Universal Modder does not provide model access.
Git. Plugin and extension installers fetch the GitHub repository through Git.
Python 3.10 or later. The um package declares Pillow, NumPy and PyYAML as dependencies; an isolated tool installer installs them together.
ffmpeg. Required for recording and editing workflows. A basic code-only project can begin before video work.
uv, recommended, or pipx. Both can install the Python CLI in its own environment. The Python 3.10 minimum above belongs to um; current pipx installation instructions require Python 3.11 or later for pipx itself.
Blender, for 3D-to-sprite rendering. It is optional for an ordinary code or 2D asset project.

Check dependencies in the terminal your agent will actually use:

Select code

git --version
python3 --version
ffmpeg -version
uv --version

You can select the code to copy it manually.

On Windows, your Python launcher may be python or py instead of python3. A missing optional renderer need not block a code-only task; a missing Git or Python installation should be resolved before continuing.

Windows and WSL

Windows games can be driven natively or from WSL. Treat Windows and WSL as separate tool environments: a Windows Git installation does not install Git inside Linux, and a Linux PATH does not configure PowerShell. Check which shell the agent uses and keep game paths in the form that command expects. Claude's Bash calls may also need Git Bash on native Windows.

macOS and Linux

Use the same installation routes where your agent supports the platform. The Python utilities are useful across platforms, but um win is a Windows automation tool. Whether the target game, loader and rendering dependencies work locally is a separate check. See Universal Modder on Mac.

Install by agent

Claude Code

Run these inside Claude Code:

Claude CodeRun in: Claude Code

Select code

/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder

You can select the code to copy it manually.

Restart the session, confirm the plugin is enabled, and type /universal-modder: to inspect its skills. Install Universal Modder in Claude Code covers terminal alternatives, MCP checks and removal.

Codex

Run these in your terminal:

shellRun in: Terminal

Select code

codex plugin marketplace add rehan-remade/universal-modder
codex plugin add universal-modder@universal-modder

You can select the code to copy it manually.

Start a fresh Codex session and check that the plugin's mod-any-game skill is available. If your Codex version does not recognize plugin, compare its help and current setup instructions. The Codex installation guide also describes the repository route.

Gemini CLI

shellRun in: Terminal

Select code

gemini extensions install https://github.com/rehan-remade/universal-modder
gemini extensions list
gemini skills list

You can select the code to copy it manually.

Review the extension's permissions and source when prompted. Start a fresh session and confirm the extension-origin skill. Use the Gemini CLI guide for setup and spawn git ENOENT diagnosis.

VS Code / GitHub Copilot

Enable the VS Code setting chat.plugins.enabled, then run Chat: Install Plugin From Source from the command palette and enter:

URLRun in: Chat: Install Plugin From Source

Select code

https://github.com/rehan-remade/universal-modder

You can select the code to copy it manually.

After installation, inspect the plugin and skill list in your current workspace. The VS Code / Copilot installation guide explains discovery, the optional MCP connection and uninstall controls.

Cursor

Install Universal Modder from Cursor Marketplace, or clone the repository:

shellRun in: Terminal (clone route)

Select code

git clone https://github.com/rehan-remade/universal-modder
cd universal-modder

You can select the code to copy it manually.

Open that folder in Cursor. It contains AGENTS.md, .agents/skills and .cursor/mcp.json. The Cursor installation guide explains what each file supplies and how to check discovery.

OpenCode

shellRun in: Terminal

Select code

git clone https://github.com/rehan-remade/universal-modder
cd universal-modder
opencode

You can select the code to copy it manually.

The repository's opencode.json connects the skills and fal MCP server. Follow the OpenCode installation guide to inspect this configuration, verify the CLI and check the active project.

Any other agent

For an agent that supports the Agent Skills format:

Select code

npx skills add https://github.com/rehan-remade/universal-modder

You can select the code to copy it manually.

This command needs Node.js and an npm-compatible environment. Skills-only installation supplies instructions; check the agent's MCP configuration and install the CLI separately if needed. Alternatively, clone the repository and launch the agent from inside it. Find each agent's discovery directory in the install section of the GitHub repository.

Install the CLI

The project provides a bin/um wrapper and integration hooks for agent sessions. An ordinary terminal may still need an independent tool installation. Choose one of these alternatives:

Select code

uv tool install git+https://github.com/rehan-remade/universal-modder

You can select the code to copy it manually.

Select code

pipx install git+https://github.com/rehan-remade/universal-modder

You can select the code to copy it manually.

Then check:

Select code

um --help
um --version

You can select the code to copy it manually.

The package declares version 0.2.0; a newer installation reports its own version. If your shell cannot find it, follow um command not found instead of reinstalling the agent repeatedly.

Set up fal for art, 3D and sound

This step is optional. Get a key from the fal dashboard, then make FAL_KEY available to the agent process or use its protected MCP settings. A shell example is:

Select code

export FAL_KEY="YOUR_FAL_KEY"

You can select the code to copy it manually.

Replace the placeholder locally. Keep the key out of prompts, committed files and shared logs; setting it in one terminal does not make it available to an already running app. The same key supports the fal MCP connection and um fal.

Before a generation, inspect um fal price --help and the selected model's price. For local images, um comfy connects to your own ComfyUI server without a fal key; that server, models and hardware must already be configured. Read the cost breakdown.

How to check the install worked

Skills: ask the agent to identify the loaded mod-any-game skill and its source before any game edits.
CLI: run um --help in both the agent's tool shell and your ordinary terminal. Expect the actual command groups, including scan, backup, fal, sprite and kb.
Optional assets: inspect the agent's MCP connection state and the fal pricing command. Only run a paid generation when you have chosen a model and budget.

Continue with the Universal Modder tutorial once the tools you need are available.

Common install errors

Symptom	First useful check	Next step
`spawn git ENOENT`	Run `git --version` and confirm the working directory exists in the same environment	Git diagnosis
`um: command not found` or `um is not recognized`	Inspect the intended CLI installation and PATH	CLI PATH diagnosis
Plugin or skill is absent	Check the active project, enabled plugin and a fresh session	Plugin discovery diagnosis
`FAL_KEY` is missing	Confirm the process doing the generation has the key	Missing fal key diagnosis
ffmpeg cannot be found	Run `ffmpeg -version` in the recording environment	ffmpeg diagnosis

For a different failure, keep the exact command and output and use troubleshooting.

Uninstall Universal Modder

Use the same agent and installation scope that installed it. Claude Code supports claude plugin uninstall universal-modder@universal-modder --scope user for a user-scope install; Gemini CLI supports gemini extensions uninstall universal-modder. For Codex, use codex plugin remove universal-modder@universal-modder (available in codex-cli 0.160.1). For Cursor and VS Code, use their plugin management controls.

For a clone, close the project and remove only the clone after preserving your mod source and notes. If you copied skills or MCP configuration to another workspace, remove only those entries. Uninstalling the toolkit does not undo modifications already made to a game; use your recorded restore procedure.

Uninstall the CLI

Use the tool manager you chose:

Select code

uv tool uninstall universal-modder

You can select the code to copy it manually.

Or, for a pipx install:

Select code

pipx uninstall universal-modder

You can select the code to copy it manually.

Keep your project, dependency records and game backups until you have finished recovery.

Frequently asked questions

Which agent should I pick?

Start with an agent you already use and can authenticate. Universal Modder exposes the same core skills across six integrations; choose by your existing workflow and platform.

Can I install it without Git?

The repository commands and most plugin routes use Git. You can inspect a downloaded archive manually, but use the supported Git routes for installation and updates.

Do I need a paid model plan?

The plugin does not include model access. Check the account and billing requirements of your chosen agent; fal is a separate optional service.