Demo

Overview

campy brings delightful ASCII pets to your terminal sidebar. Pets animate through states, react to coding events, and display contextual speech bubbles—adding personality to your coding sessions.

Features

• 4 Pet Types: Cat, Hamster, Ghost, and Robot
• 7 Animation States: idle, happy, sleeping, eating, playing, excited, sad—with multi-frame animations and blinking
• Speech Bubbles: Context-aware messages ("Edited file!", "Thinking...", "Need a hand?")
• Happiness System: Feed, play, or pet your companion to increase happiness
• Event Reactions: Automatic responses to tool use, file edits, errors, and idle states
• Multi-agent: One CLI + per-agent adapters for Claude Code, OpenCode, Pi, Gemini CLI, Codex CLI, Cursor CLI, and Aider
• MCP server: One stdio server unlocks Gemini / Codex / Cursor at once

Installation

Prerequisite: bun (curl -fsSL https://bun.sh/install | bash). The CLI is a single TypeScript file with a #!/usr/bin/env bun shebang — no build step.

campy isn't on npm yet. Pick one of these:

Option 1 — install straight from GitHub (recommended)

# via bun
bun add -g github:dropdevrahul/campy

# or via npm
npm install -g github:dropdevrahul/campy

This registers campy on your $PATH. Verify:

campy status

Option 2 — clone and symlink

git clone https://github.com/dropdevrahul/campy.git ~/work/campy
cd ~/work/campy && bun install
chmod +x cli/campy.ts
ln -s "$PWD/cli/campy.ts" ~/.bun/bin/campy   # or any dir on $PATH

Auto-detect & wire every agent you have installed

campy setup

This detects which agents are installed on your machine (~/.claude, ~/.gemini, ~/.codex, ~/.cursor, ~/.pi, .opencode/, .aider.conf.yml) and wires each natively. Or install for one agent:

campy install claude-code   # | opencode | pi | gemini | codex | cursor | aider

Render the pet

campy watch     # run inline in any terminal
campy attach    # auto-split a side pane (tmux / zellij / wezterm / kitty)

Per-agent setup

For agents with no built-in render surface, run campy attach in a side pane.

Token usage

The Claude Code adapter is zero-token for normal operation. Hooks and the statusline are bash scripts run outside the model. Slash commands (/campy:feed, etc.) cost a small prompt when you invoke them.

Slash Commands

The slash-command prefix depends on the host:

• OpenCode / Pi: /pet feed, /pet play, /pet robot, …
• Claude Code: /campy:feed, /campy:play, /campy:pet, /campy:switch <pet>
• MCP agents (Gemini / Codex / Cursor): call the tools campy_feed, campy_play, campy_pet, campy_switch, campy_status

Available Pets

File Structure

core/             # portable pet logic (animation, store, runtime, render)
cli/campy.ts      # the campy binary (bun)
adapters/
├── claude-code/  # hooks + statusline + slash commands
├── pi/           # in-process TUI widget
├── mcp/          # stdio MCP server (Gemini / Codex / Cursor)
└── gemini/       # gemini-extension.json + GEMINI.md
.opencode/        # OpenCode plugins (re-export from core/)
.claude-plugin/   # Claude Code marketplace manifest
ghost-pet/        # legacy standalone Bash plugin (kept for back-compat)

See CLAUDE.md for the full architecture, and docs/superpowers/specs/2026-06-13-cli-agent-support-design.md for the multi-agent design spec.

License

MIT