Parallel Harness Pets (parallel-harness-pets) is an open-source companion tool and harness plugin created by TevvvB. It is designed for developers running terminal-based AI coding agents, including Claude Code and OpenAI Codex CLI environments, providing ambient workspace and git health telemetry directly within the agent interaction stream. The tool operates via a Go-based CLI utility (cmd/pets) and an integrated Claude Code plugin manifest. During agent execution, it injects compact, monochrome-safe status strings into terminal hooks and status lines. It tracks key git metrics—such as uncommitted modifications, unpushed local commits, and branch divergence from trunk—alongside ASCII/Unicode pet avatars and health meters (hearts and glyphs). What distinguishes Parallel Harness Pets is its focused role as an unobtrusive telemetry companion rather than a complex multi-agent framework. It surfaces critical repository state to the developer while agents perform automated file edits, preventing branch drift and forgotten unpushed changes during parallel agent sessions. The project is available as an open-source repository on GitHub and distributes via standard Go binary builds and the Claude Code plugin mechanism.
Tags: agent harness, cli, coding agent, developer tools, OpenSource
.claude-plugin manifest support for automated loading and updates inside Claude Code sessions. - Agent hook status line — Emits compact, ANSI-safe status lines designed specifically to render cleanly within host agent terminal feeds. - Git synchronization telemetry — Monitors uncommitted changes, unpushed commits, and distance behind trunk in real time. - Visual health indicators — Visualizes workspace hygiene and branch drift using Unicode pet avatars and heart meters. - Lightweight Go runtime — Built in Go (cmd/pets) for minimal execution latency inside fast terminal agent loops.Designed for developers and engineers using CLI coding agents like Claude Code or Codex who want lightweight git state feedback directly in their terminal sessions. It is not meant for teams seeking a standalone autonomous coding model or full-stack agent sandboxing platform.
bash # Build from source using Go git clone https://github.com/TevvvB/parallel-harness-pets.git cd parallel-harness-pets go build -o pets ./cmd/petsbash ./pets If using with Claude Code, register the plugin from the repository root: bash claude plugin validatebash $ ./pets >(@_@)< crab ♥♡♡♡♡ 31△ 27↑ 250↓ · 27 unpushed. this branch only exists on your laptop.Part of CLI Coding Agents
Categories: AI Coding Agents, Developer Tools, Fun tools