minecraftcli

A small Ruby CLI for looking up Minecraft player info — UUIDs, name history, and capes — straight from your terminal.

Features

• Look up a player's UUID and current profile
• View name change history
• List capes the player has owned
• Interactive REPL or one-shot lookups via flags

Install

Requires Ruby >= 2.7 and Chrome (used headlessly for NameMC fallback).

git clone https://github.com/johncastro/minecraftcli.git
cd minecraftcli
bundle install

Usage

Start the interactive session:

./bin/minecraftcli

Then use commands like:

lookup <username>
help
clear
exit

Or do a one-shot lookup:

./bin/minecraftcli --user <username>

Data sources

• Mojang API — UUID and profile
• Ashcon API — name history
• capes.dev — cape history
• NameMC — supplemental aliases/capes (via headless Chrome)

License

MIT

minecraftcli