mmcli

A command-line Valheim mod manager for macOS and Linux. Installs mods from Thunderstore, manages profiles, and launches the game with BepInEx.

Install

Shell script (recommended)

curl -fsSL https://raw.githubusercontent.com/jneb802/mod-manager-cli/main/install.sh | bash

The installer uses a user-writable location and does not require a password. It updates an existing writable mmcli install, installs to a writable directory already on your PATH, or installs to ~/.local/bin.

If it installs to ~/.local/bin and your shell cannot find mmcli, the installer adds this to your shell profile:

export PATH="$HOME/.local/bin:$PATH"

Restart your terminal, or run the source command printed by the installer.

Homebrew

brew install jneb802/tap/mmcli

Manual download

Download the latest binary for your platform from Releases, then:

mkdir -p ~/.local/bin
binary=mmcli-linux-amd64 # or mmcli-darwin-arm64 / mmcli-darwin-amd64
chmod +x "$binary"
mv "$binary" ~/.local/bin/mmcli

Getting Started

mmcli init

This detects your Valheim install, installs BepInEx, and creates a default profile.

Interactive TUI

mmcli tui

A terminal UI for browsing, toggling, installing, updating, and removing mods with keyboard shortcuts.

Launching the Game

mmcli start

Launches Valheim with BepInEx loaded and streams logs to the terminal.

Installing Mods

mmcli install RandyKnapp-EpicLoot

Dependencies are resolved and installed automatically.

Managing Mods

mmcli list                        # show installed mods
mmcli remove <mod>                # remove a mod and orphaned dependencies

Profiles

Profiles let you maintain separate sets of mods (e.g. one for solo, one for a modded server).

mmcli profile create <name>
mmcli profile switch <name>
mmcli profile list
mmcli profile delete <name>
mmcli profile import <url|code>   # import from r2modman/Thunderstore profile code
mmcli profile open                # open profile folder in Finder