v0.1 · FabricMC · Go

Shape your
Minecraft setup.

Anvil is a terminal-native instance and mod manager for FabricMC. Lightweight, fast, and built for the command line.

$ curl -fsSL https://raw.githubusercontent.com/huseyinhealth/anvil/main/install.sh -o /tmp/anvil-install.sh $ bash /tmp/anvil-install.sh

Linux & macOS  ·  Go 1.21+  ·  view source

Features

Everything you need,
nothing you don't.

Instance creation, mod installation, Java management — all from one binary, zero GUI.

Instance Management

Create, delete, and switch between fully isolated Minecraft instances. Each has its own mods, saves, config, and metadata.

Modrinth Integration

Search and install mods from Modrinth with automatic dependency resolution. No manual library hunting.

FabricMC Loader

Anvil talks directly to the FabricMC meta API to install the right loader and Fabric API version every time.

Java Runtime Manager

Downloads and manages JREs via Adoptium. No system Java conflicts — Anvil keeps its own isolated runtime store.

Microsoft Auth

Full Microsoft account authentication flow. Credentials stored locally in ~/.anvil/profile.json — no third-party relays.

Zero Config Start

Everything lives in ~/.anvil/. No root required, no system-wide changes, no setup wizard.

CLI

Built for
the terminal.

One binary. One command prefix. No Electron, no daemon, no GUI. Anvil stays out of your way.

~/.anvil/ ├── instances/ # game instances │ └── survival-1.21/ │ ├── anvil.json # metadata │ ├── mods/ │ ├── saves/ │ └── config/ ├── jre/ # java runtimes ├── cache/ # download cache └── profile.json # ms account
bash — ~
→ anvil new survival 1.21.1   → anvil install sodium The following mods will be installed: Sodium 0.5.11+mc1.21.1 (1.2 MB) Fabric API 0.100.8+1.21.1 (2.4 MB)   Total: 2 mods, 3.6 MB Proceed? [Y/n] y Installed 2 mod(s).   → anvil modlist Installed mods on instance "survival":   sodium - Sodium fabric-api - Fabric API   → anvil run

How it works

From zero to playing
in four steps.

Anvil handles every layer of the stack — auth, Java, mods, launch — so you don't have to.

01

Install

One command,
done.

A single curl command fetches the installer, compiles the binary from source, and drops it into your PATH. No package manager, no root, no dependencies.

$ curl -fsSL .../install.sh -o /tmp/anvil-install.sh $ bash /tmp/anvil-install.sh ✓ anvil installed to ~/.local/bin/anvil
02

Authenticate

Your account,
your way.

Anvil uses Microsoft's OAuth2 device code flow — visit a URL, enter a short code, done. Your credentials are stored locally in ~/.anvil/profile.json. Nothing goes through a third-party server.

$ anvil login Visit: microsoft.com/devicelogin Code: ABCD-1234 ✓ Logged in as cnhsync
03

Create & mod

Any version,
any mods.

Create a named instance for any Minecraft version. Search Modrinth and install mods by slug — one at a time or several at once. Dependencies are resolved automatically, no manual hunting.

$ anvil new survival 1.21.1 $ anvil install sodium lithium Installed 3 mod(s). (+1 dep)
04

Play

Launch and
forget.

Anvil fetches the right Java runtime via Adoptium, assembles the full classpath, and hands control to the Fabric launcher. Assets, libraries, saves — all scoped to the instance. Switch between instances instantly.

$ anvil select survival && anvil run Selected instance: survival Starting instance survival Version: 1.20.1 Fabric Version: 0.19.2

Roadmap

What's coming.

Core features are solid and shipped. Extended ecosystem support is on the way.

✓
Instance creation & management
✓
Modrinth mod installation with dependency resolution
✓
FabricMC loader & API management
✓
Java runtime management via Adoptium
✓
Microsoft account authentication
○
Mod update functionality
○
Auto-remove unused mod dependencies
○
Forge loader support
○
CurseForge integration
○
Minecraft server support

Built on the shoulders of

Open ecosystem.

Anvil integrates with these APIs and projects to deliver a seamless experience.

Modrinth FabricMC Adoptium Mojang