A fast, lightweight Minecraft launcher for the terminal.
No GUI. No bloat. Just Minecraft.
A fast, lightweight Minecraft launcher for the terminal.
No GUI. No bloat. Just Minecraft.
Everything you need. Nothing you don't.
Launches in under 200ms. No splash screens, no telemetry, no background processes phoning home.
The launcher itself uses under 30MB of RAM — leaving the rest for the game where it belongs.
Create, run, rename, and delete isolated instances. Switch between them instantly with a single command.
Full Microsoft Device Code Flow with automatic token refresh. Authenticate once, stay signed in.
Search, install, and manage mods, resource packs, shaders, and plugins directly from the terminal.
Search Modrinth for modpacks, pick any version from a grouped version picker, and install everything — mods, configs, resource packs — in one command.
modpack update checks all your modpack instances against Modrinth, shows what's outdated, and upgrades in one step — optionally copying your worlds.
Skip the REPL entirely: mcsh run <name> launches an instance straight from any terminal window.
Missing Java or wrong version? McSH downloads and manages the exact JDK each modpack requires — no admin rights, no PATH changes.
Six built-in color themes — Crimson, Arctic, Forest, Amber, Violet, Steel. Switch instantly and it persists across restarts.
All commands available in the McSH REPL.
| Command | Description |
|---|---|
instance create | Create a new Minecraft instance (guided wizard) |
instance list | List all instances with running status |
instance run [name] | Launch an instance — prompts if none selected |
instance info [name] | Show version, loader, RAM, mods, path |
instance open [name] | Open instance folder in File Explorer |
instance clone <name> | Duplicate an existing instance |
instance rename <name> | Rename an instance |
instance delete <name> | Delete an instance |
instance import <path> | Import a .mrpack modpack file |
| Command | Description |
|---|---|
instance run [name] | Launch the active instance |
run <name> | Quick-launch from any terminal without entering the REPL |
instance kill <name> | Force-kill the running instance |
console | Attach to a running instance's console |
| Command | Description |
|---|---|
modpack search <query> | Search Modrinth for modpacks |
modpack install <#> | Install with version picker — grouped by MC version |
modpack update | Check all modpack instances for newer versions on Modrinth |
instance import <path> | Import a local .mrpack file |
| Command | Description |
|---|---|
mod search <query> | Search Modrinth for mods |
mod install <#> | Install a mod from search results |
mod details <#> | View full mod details and install prompt |
mod list | List installed mods |
mod update | Update all installed mods |
mod toggle <#> | Enable or disable a mod |
resourcepack search <query> | Search for resource packs |
shader search <query> | Search for shaders |
plugin search <query> | Search for plugins |
| Command | Description |
|---|---|
auth login | Sign in with Microsoft Device Code Flow |
auth logout | Remove stored credentials |
auth status | Show current authentication state |
Download the installer, run it, and type mcsh in any terminal. That's it.
C:\> mcsh
__ __ _____ _ _
| \/ |___/ ____| || |
| |\/| / __\__ \| __ |
|_| |_\___/___/|_||_|
v0.3.4 | Type 'help' to begin
> instance create
Version: 1.21.4
Loader: Fabric
Name: my-instance
Instance created.
[my-instance]> launch
Launching Minecraft 1.21.4 (Fabric)...
_