v0.3.0 is out now

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
3 pets to adopt
3 mini-games
local save file
bytepet-cli
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

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.

Feed

Raise hunger

Give your pet food, nudge happiness upward, and earn a little XP.

Sleep

Restore energy

Let the pet rest when energy drops and recover a bit of health.

Play

Open mini-games

Rock Paper Scissors, Number Guess, and Coin Flip now live in one menu.

Return

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.

daily workflow
$ 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.

Mini-game menu

Launch games directly with byte --play and choose Rock Paper Scissors, Number Guess, or Coin Flip.

Lifetime stats

Use byte --stats to see wins, losses, draws, XP earned from games, and the last played game.

Better recovery

If the save file is corrupted, bytepet-cli backs it up and creates a fresh save instead of leaving the CLI stuck.

Roadmap

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.

Install it, adopt a pet, and give your terminal one more reason to feel alive.