Linux CLI · Free & Premium

nexmod

Nexus Mods management for Linux, done in the terminal.

Vortex is great — it just doesn't run on Linux. nexmod fills that gap: a simple CLI so you (and your LLM agents) can install, update, and manage mods with minimal friction. Less configuring, more playing.

$ pipx install nexmod
bash — nexmod

Features

Everything a mod manager should do.

No GUI wrapper. Auditable state in a local SQLite DB. Every operation is atomic — the DB is never written unless extraction completes.

Install & track
Paste a full Nexus URL or pass a game slug + mod ID. Atomic download with MD5 verification before extraction. Supports .zip, .tar.gz, .7z. Detects conflicts before touching disk. Free accounts: use nexmod import to install a manually-downloaded archive — no Premium needed.
nexmod install darktide 1234 nexmod import darktide ~/Downloads/mod.zip --dry-run
Load order management
Reads mod.json and .mod files for declared dependencies, then sorts topologically. Cycles are surfaced, not silently buried at the end of the file.
nexmod order darktide --dry-run cycle detection
Profile hotswap
Snapshot the current load order as a named profile. Load it back in one command — including automatically installing any mods missing from that profile. Useful for separating a stable set from an experimental one.
nexmod profile save darktide stable nexmod profile load darktide stable --install
Safety net
doctor checks your whole environment before you touch anything. rollback restores from auto-saved version snapshots. fsck --fix repairs DB drift; fsck --scan finds untracked folders and offers to track them. Dep scan runs on every update so gaps can't accumulate.
nexmod doctor nexmod rollback darktide 1234 nexmod fsck --scan
Search & discover
Search Nexus Mods by name from the terminal — no browser needed. Results include mod ID, summary, downloads, and endorsements sorted by popularity. Pass --json for structured output that LLM agents and scripts can parse directly. info --remote fetches full mod details without installing first.
nexmod search darktide "enemy health" --json nexmod info darktide 1234 --remote
MCP server
Native Claude / LLM tool integration — no subprocess, no text parsing, just typed tool calls. Install once, then ask Claude to manage your mods directly. pip install nexmod[mcp]
claude mcp add nexmod -- nexmod mcp-server 12 tools

Compatibility

Honest about what's tested.

nexmod was built for Darktide and is used there daily. The install/update pipeline is wired for other games, but they haven't been tested in the wild yet.

Darktide ✓ Verified Daily driver. Load order, NXM handler, missing-dep detection, rollback snapshots, enable/disable patch — all battle-tested.
Skyrim SE ⊘ Untested Install/update pipeline is wired. Load order sorting uses a different system than Darktide — not implemented. Needs community verification.
Baldur's Gate 3 ⊘ Untested Install/update pipeline wired. Needs someone to put it through real use and report back.
Cyberpunk 2077 ⊘ Untested Install/update pipeline wired. Needs community testing.
Fallout 4 ⊘ Untested Install/update pipeline wired. Needs community testing.
Other games ⊘ Untested Any Nexus domain works for download/extract. Set the mod directory manually with nexmod path set <game> <dir> and it'll use the standard pipeline.
Help expand the verified list. Tested nexmod on a game not listed above? Open an issue with your experience and what worked (or didn't), and we'll update the table.

Quick start

Up in four steps.

Nexus Mods Premium unlocks direct API downloads (nexmod install). Free accounts can use nexmod import to install a manually-downloaded archive — no Premium needed.

# 1. Install $ pipx install nexmod # 2. Add your API key (nexusmods.com → avatar → Settings → API Keys) $ nexmod config set-key <your-key> # 3. Verify everything's wired up $ nexmod doctor # 4a. Install a mod by URL $ nexmod install https://www.nexusmods.com/warhammer40kdarktide/mods/1234 # 4b. Or by slug + ID $ nexmod install darktide 1234 # Check for updates whenever you feel like it $ nexmod update darktide -y
🐧 OS Linux
🐍 Python 3.10+
🔑 Account Nexus Premium
📦 Optional 7z (for .7z archives)
🍷 Optional Wine (legacy .exe fallback only)