Skip to content

Managing Installed Mods

SpaceSquare edited this page Aug 29, 2026 · 2 revisions

Managing Installed Mods

Listing

gtavmm list-mods

Shows every installed mod, its status (Active / Disabled / Uninstalled), install date, and source type. Known limitation: the database doesn't yet tag which mode/edition a mod belongs to, so this always lists everything — not filtered by Legacy vs. Enhanced vs. LSPDFR. The desktop app's Legacy/SP page discloses this same limitation on-screen rather than hiding it.

Searching

gtavmm search <keyword>

Local, case-insensitive keyword search across each mod's name/notes/link, ranked by which field matched. This is not natural-language search — it's a plain keyword filter, and the CLI help text says so deliberately. Search was scoped this way because the AI provider integration (see Advanced Tools) has never been end-to-end verified with a real Ollama/cloud connection on the dev machine, so search doesn't depend on it.

Enabling and disabling

gtavmm disable <id>
gtavmm enable <id>

Disabling moves a mod's files to internal staging and updates its status — it doesn't delete anything. Enabling reverses that. Both are recorded in history.

Uninstalling

gtavmm uninstall <id>

Deletes the mod's files and marks it Uninstalled. A backup snapshot goes to the recycle bin first, with an expiry — this isn't instant, unrecoverable deletion.

Reinstalling

gtavmm reinstall <id> --source path/to/new-version

Uninstalls the current files, then installs fresh from a source you provide (a different version, a fixed copy, whatever) under a new mod record. The tool never downloads anything on your behalf — you always supply the source file/folder yourself.

History

gtavmm history

Every install/uninstall/enable/disable action, in order. Useful for reconstructing "what did I actually do to get into this state" after a session of installing several mods.

Exporting your library

gtavmm export path/to/output.xlsx

Produces a styled .xlsx workbook with installed and uninstalled mods on separate sheets — a snapshot you can keep, share, or diff against later.

Clone this wiki locally