FAQ

FAQ

Is there a desktop app? Yes, but it's under active development and not feature-complete — see Home for exactly what's wired up so far. The CLI covers everything today.

Does this download mods for me? No. Source integration is deliberately manual-link-only — you find and download mods yourself (e.g. from GTA5-Mods.com or LCPDFR.com), then point this tool at the file. This was a deliberate scope decision, not a missing feature: no clear, verifiable public API/developer terms exist for either site, so automated fetching was ruled out to avoid a terms-of-service gray area.

Why doesn't it support .rar? No mature pure-Rust RAR decoder exists, and the format's licensing situation makes bundling a native unrar an awkward fit for an AGPL project. It's explicitly detected and rejected with a clear message — extract it yourself and point the tool at the folder. See Installing Mods.

Why doesn't it support .oiv directly? Every real .oiv package tested so far modifies RPF archive contents internally, which this tool doesn't do. Earlier versions tried to distinguish "simple" from "complex" .oiv packages, until a real EUP sample was found to be misclassified as simple when it actually rewrote RPF internals — after that, .oiv handling was simplified to "always redirect to OpenIV," which is safer than guessing wrong. See Safety Model.

Is the AI assistant required? No — off by default, opt-in, and the rest of the tool works fully without it. When enabled, you choose local Ollama (nothing leaves your machine) or your own cloud API key.

Does the AI assistant do anything automatically? No. Every suggestion expands to an explicit Plan you review before anything executes. Only two low-risk action kinds (enable/disable a mod) can ever be whitelisted to skip the manual confirmation step — nothing else, ever, even if you try to whitelist it.

Where's my data stored? See Data Locations and Logs — a local SQLite database, no cloud sync, no telemetry beyond what you explicitly opt into (crash reports you choose to submit, AI requests you choose to send).

Does it work on Linux / with Proton? Yes — detection covers Proton compatdata scanning, and a manual --game-path override is always available if auto-detection misses your setup.

Is this affiliated with Rockstar Games? No. This is an unofficial, non-commercial, open-source project. See TERMS.md.