Docs
CLI reference
Every cpmm command, grouped by what it's for.
Mods can be referred to by their cpmm id, their Nexus id, or a unique fragment of their name. Run cpmm <command> --help for every flag.
Mods
| Command | What it does |
|---|---|
cpmm list [-l] | Mods in load order, with conflict counts when -l is given, plus read-only mod.io mods |
cpmm info <mod> | Details, requirements and files |
cpmm install <nexus id, URL or archive> | Download, verify, detect the layout and stage. --with-deps installs missing requirements; --file picks a Nexus file; --nexus <id> links a local archive to its Nexus page |
cpmm enable <mod>… / cpmm disable <mod>… | Turn mods on or off in the active profile |
cpmm remove <mod> | Uninstall: move the staged files to trash |
cpmm rename <mod> <new id> | Give a mod a new id |
cpmm verify [mod…] | Compare staged files with Nexus manifest hashes |
Load order and conflicts
| Command | What it does |
|---|---|
cpmm order <mod> --top / --bottom / --before X / --after X | Move a mod in the load order |
cpmm sort [--apply] | Dependency-aware sort: show the plan, or save it |
cpmm rule <mod> --after <other> | Pin a winner between two mods (--remove, --list) |
cpmm conflicts [mod] [--base] | Loose-file overlaps and redscript @replaceMethod clashes |
cpmm archives [--all] | Resource conflicts inside .archive files |
cpmm hide <mod> [paths] / cpmm unhide <mod> [paths] | Hide a mod’s files from the game, or restore them |
cpmm prefer <mod> [paths] | Make a mod win its conflicts by hiding the other copies |
Requirements and updates
| Command | What it does |
|---|---|
cpmm deps [--refresh] | Missing and disabled requirements of enabled mods |
cpmm deps --fix | Install missing hard requirements and enable disabled ones |
cpmm deps --ignore <mod> <id> / --unignore | Accept a missing requirement on purpose |
cpmm updates [--refresh] | Newer uploads of the files you installed |
cpmm update <mod>… / cpmm update --all | Install them |
cpmm changelog <mod> [--all] | The mod’s Nexus changelog, newest versions first |
Nexus Mods
| Command | What it does |
|---|---|
cpmm nexus-key <KEY> / --check / --remove | Manage your API key |
cpmm register-handler [--check / --unregister] | Handle Nexus nxm:// links |
cpmm tracked [--install] [--untrack] | Install mods you pressed Track on at nexusmods.com |
cpmm collection show / install / list | Nexus Collections |
cpmm downloads [--install] | Archives in the watched download folder |
Profiles
| Command | What it does |
|---|---|
cpmm profile | List profiles; * marks the active one |
cpmm profile create <name> [--from P / --empty] [--switch] [--own-saves] | Create a profile |
cpmm profile switch <name> | Make a profile active |
cpmm profile rename <old> <new> / cpmm profile delete <name> | Rename or delete; deleting keeps every mod installed |
cpmm profile saves <name> own [--copy] / shared | Give a profile its own saves, or share the game’s |
Launching and the game directory
| Command | What it does |
|---|---|
cpmm run -- %command% | The Steam launch wrapper |
cpmm launch-options [--apply] | Show or set Cyberpunk’s Steam launch options |
cpmm exec -- <cmd> | Run a tool that sees the modded game directory |
cpmm status | The running session and its layers |
cpmm overwrite / move <mod> / clear | What the game wrote at runtime; keep it as a mod, or drop it |
cpmm unmanaged [--modified] [--flat] | Files in the game directory that no mod owns |
cpmm import [--apply] / cpmm adopt <id> <paths…> | Take over a hand-made install |
cpmm eject [--apply] | Copy every enabled mod back into the game directory |
Health and safety
| Command | What it does |
|---|---|
cpmm doctor [--ack <finding>] [--all] | Crash and stutter risks, with suggested fixes |
cpmm history <mod> / cpmm rollback <mod> [--to <ts>] | Earlier versions of a mod, and going back to one |
cpmm undo-update [batch] | Revert a whole update run |
cpmm crashes | Match crash reports to sessions and show what changed |
cpmm errors | New and resolved errors in mod framework logs since the last launch |
cpmm patch | After a game patch, check native mods for newer releases |
cpmm vanilla on | Make the next launch mod-free, once |
cpmm saves [--snapshot / --restore <name>] | Save snapshots |
cpmm modio [--ack] | mod.io subscriptions and their conflicts with cpmm’s mods |
Setup and housekeeping
| Command | What it does |
|---|---|
cpmm setup | First-run setup in the terminal |
cpmm settings / set <key> <value> / reset [key] | Show or change settings |
cpmm steam-shortcut [--remove] [--dry-run] | Add the GUI to your Steam library, with artwork |
cpmm clean | Empty trash, temporary files and cached downloads |