Nomlings

A virtual pet for your Claude Code sessions. A little 3D device floats next to your terminal; the 8-bit pet on its screen eats the tokens your sessions burn, celebrates when tasks finish, gets grumpy when tools error, and evolves as you ship.

Download the latest release · Website · Owner's manual

---

This repository hosts the official binary releases of Nomlings. The source code is closed; issues and feature requests are welcome here.

Download

Grab the latest version from the releases page.

File	What it is
Nomlings_x.y.z_x64-setup.exe	Windows installer (recommended). Per-user, no admin rights needed. Puts nomling on your PATH and registers the Claude Code hooks for you.
Nomlings_x.y.z_portable.zip	Portable build. Unzip anywhere; contains nomling.exe (the CLI) and nomling-desktop.exe (the pet widget).
SHA256SUMS.txt	Checksums for verifying your download.

Older releases

Every past version stays downloadable from the full releases list, and each release page doubles as its changelog.

Heads up: only the latest release is supported. Older builds are provided as-is for convenience; they may contain bugs or security issues fixed in newer versions, they receive no fixes, and the in-app update check will keep suggesting the latest version. Unless you have a specific reason, grab the latest release.

System requirements

• Windows 10 or 11, 64-bit
• About 3 MB on disk, no admin rights
• Claude Code installed (the pet feeds on your sessions)

Install and quick start

Installer (recommended)

1. Run Nomlings_x.y.z_x64-setup.exe. No admin prompt; it installs per-user, adds nomling to your PATH, and registers the Claude Code hooks.
2. Start nomling instead of claude. The pet appears next to your terminal and your tokens become food.

Portable

1. Unzip the portable .zip somewhere permanent, for example C:\Tools\nomling.
2. Add that folder to your PATH, then check it works with nomling --help.
3. Run nomling setup to register the Claude Code hooks. This is an additive edit to ~/.claude/settings.json (a backup is made) and fully reversible with nomling uninstall-hooks.
4. Start nomling instead of claude.

For care, feeding, evolution, and everything else, see the owner's manual.

Windows SmartScreen

The binaries are not yet code-signed, so Windows SmartScreen may warn on first run. Click More info, then Run anyway. If you want to be sure the file is genuine, verify its checksum first (below). Only download Nomlings from this repository or from nomlings.cc.

Verifying your download

Every release includes a SHA256SUMS.txt. Compare it against your file in PowerShell:

Get-FileHash .\Nomlings_0.1.0_x64-setup.exe -Algorithm SHA256

The printed hash should match the corresponding line in SHA256SUMS.txt.

Privacy

Nomlings reads token counts and hook event types only. It never reads your prompts or code, and it sends nothing over the network.

Free forever, with an optional Cosmetic Pack

The app and the pet are 100% free, no account, no trial. If you want more species, shell styles, and custom colors, there is a one-time Cosmetic Pack (never a subscription). Manage an existing license at nomlings.cc/license.

Uninstall

• Installer build: uninstall from Windows Settings > Apps, like any other app.
• Portable build: delete the folder.
• Either way, run nomling uninstall-hooks first if you want the Claude Code hooks removed from ~/.claude/settings.json.

Support

Found a bug or have an idea? Open an issue. Docs live in the owner's manual. For security reports, see SECURITY.md.

---

Copyright (c) 2026 Francesco Gruosso. All rights reserved. Nomlings is free to use; see EULA.md for the terms.