McSH Launcher

Features

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.

Import any Modrinth modpack with one command. McSH handles the instance, loader, and all downloads automatically.

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
`instance kill <name>`	Force-kill the running instance
`console`	Attach to a running instance's console

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.

Terminal

C:\> mcsh

__ __ _____ _ _

| \/ |___/ ____| || |

| |\/| / __\__ \| __ |

|_| |_\___/___/|_||_|

v0.3.2 | 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)...