[Open Source] parallel-harness-pets: give every AI coding agent its own terminal pet

[TevvvB]

Project URL

https://github.com/TevvvB/parallel-harness-pets

Category

Go

Project Title

Give every AI coding agent its own terminal pet

Project Description

A Go CLI that gives every AI coding agent session its own creature in the terminal status line, with one den per git worktree. Its mood tracks how tidy that worktree is, so six agents at once are six pets you can tell apart.

Highlights

Most terminal pets belong to you: one creature, nurtured over time. This one belongs to the agent, which is what makes it useful rather than decorative. When six Claude Code or Codex sessions are running across six worktrees, the status line tells you which session you are looking at and which one is in trouble, because the creature is derived from the session and its mood is derived from the worktree's tidiness.

• 41 species across 5 rarity bands, plus shiny variants, and 16 cities that name the dens. pets den shows the collection: which species you have found and which places you have worked in.
• A creature is a hash, not a record. Nothing is persisted to decide identity, so there is no state to migrate or corrupt.
• The status-line path runs once a second in every open session, so it reads two small cache files and nothing else: no git, no network. The expensive work happens in a throttled background probe.
• Verified end to end against Claude Code. The Codex hooks are written but have not been tested against a real Codex, and the README says so. The tmux and shell-prompt modes need nothing from the agent at all, so they work with Aider, Amp, Gemini CLI or anything else.
• Installs itself into whichever agents you actually have, backs up every config it touches, and leaves your other hooks alone. pets uninstall reverses it.
• Single static binary, MIT, no runtime dependencies.

Example Code

# install, then wire into whichever agents are present
curl -fsSL https://raw.githubusercontent.com/TevvvB/parallel-harness-pets/main/install.sh | sh
pets install

# one line per live session, across every worktree
pets party

# the collection: species found, and cities worked in
pets den

Screenshots or Demo Videos