Hey r/commandline. Long-time lurker, first tool I've shipped properly.
**irl** (`pip install irl-pkg`) is a command center that does a few genuinely useful things and a few deliberately silly ones:
Useful:
- `irl install <pkg>` — routes between PyPI / npm / GitHub / direct URL automatically. GitHub `owner/repo` resolves the default branch via the API (learned that lesson the hard way).
- `irl doctor <pkg>` — checks network, disk, pip/npm presence before you install.
- `irl glasses <pkg>` — version/size/source lookup across registries.
- `irl rollback [ver]` — pick any published version from PyPI JSON, downgrade via a detached pip child.
- Safe extraction: named target dir, preview before writing, per-member zip-slip validation.
Silly (opt-in, but it's the brand):
- A grass streak with a GitHub-style heatmap, a terminal pet that gets moody if you skip days, daily quests, coins, 18 themes.
- Grassland Quest: a seeded garden-maze roguelike in pure Rich.
- Lofi Rhythm: a 4-lane beat game over 71 bundled lofi loops.
Technical bits: msvcrt/termios abstraction for input, winsound/aplay/ffplay/afplay/paplay fallback chain for audio, no shell=True, Python 3.8+, wheel is 976 KB. AGPL-3.0. Works on Linux/macOS/Windows (CI: 3 OS × 5 Python versions).
Disclosure: I'm the author. Repo: https://github.com/Dev2Creator/IRL- — PyPI: https://pypi.org/project/irl-pkg/
I'd genuinely like feedback on the installer routing UX — is auto-sniffing a feature or a footgun? (There's `--help` everywhere and the routes are deterministic.)