BYTEPET CLI v0.3.0 /\_____/\ ( ^ ^ ) ( =^.^= ) Pixel the Cat (--m-m----) Level 3 - 245/300 XP Health ██████████ 100% Hunger ███████░░░ 70% Happiness ████████░░ 80% Energy █████░░░░░ 55% [f] Feed [p] Play [s] Sleep [q] Quit $ byte --play [1] Rock Paper Scissors [2] Number Guess [3] Coin Flip
A tiny pet for your command line.
bytepet-cli gives your terminal a small companion with moods, stats, XP, mini-games, and local saves. It is quick to check in on, easy to reset, and weirdly satisfying to keep alive.
$ npm install -g bytepet-cli
$ byte --status && byte --play
The pet loop stays small on purpose.
The CLI is made for short terminal check-ins: see the current mood, fix the stat that is slipping, earn XP, then get back to work.
Raise hunger
Give your pet food, nudge happiness upward, and earn a little XP.
Restore energy
Let the pet rest when energy drops and recover a bit of health.
Open mini-games
Rock Paper Scissors, Number Guess, and Coin Flip now live in one menu.
Stats decay away
Your pet remembers time between sessions, so check-ins still matter.
Built to fit the terminal you already use.
No cloud account, dashboard, or extra service. Install the package, run the command, and keep the save file on your own machine.
$ byte --status Pixel the Cat happy Level 3 health 100% hunger 70% happiness 80% energy 55% $ byte --play [1] Rock Paper Scissors [2] Number Guess [3] Coin Flip $ byte --stats games played 18 wins 10 draws 4 XP from games 145 last game Coin Flip $ byte --reset start fresh whenever you want a new pet
What changed in v0.3.0
The last update made play more visible without losing the original pet-care idea.
Launch games directly with byte --play and choose Rock Paper Scissors, Number Guess, or Coin Flip.
Use byte --stats to see wins, losses, draws, XP earned from games, and the last played game.
If the save file is corrupted, bytepet-cli backs it up and creates a fresh save instead of leaving the CLI stuck.
Next updates move deeper into the pet side: evolution stages, accessories, multiple pets, and seasonal events.
bytepet-cli questions, answered.
Quick answers for search engines, answer engines, and developers deciding whether this is the terminal pet they want to install.
What is bytepet-cli?
bytepet-cli is a tiny terminal pet CLI game for developers. You adopt a cat, dog, or dragon and care for it directly from the command line.
How do I install bytepet-cli?
Install it with npm install -g bytepet-cli or
pip install bytepet-cli, then run byte or
bytepet.
Does bytepet-cli save progress?
Yes. bytepet-cli stores progress locally in
~/.byte-cli/pet.json, including pet stats and game history.
What changed in v0.3.0?
v0.3.0 added the mini-game menu, lifetime game stats, and better recovery when a local save file becomes corrupted.