claude-buddy

claude-buddy

A minimal, faceless terminal buddy for Claude Code. After each turn a Stop hook reads what just happened (what you said, what the assistant did) and generates one short in-character line with Haiku, in the background. The status line shows a small mood-colored dot and that occasional line, then model · context% · 5h/week usage · cost.

It is model-generated from the real conversation (not regex), so it's specific and funny. Personality is a plain text file you can swap or rewrite.

Install (from the marketplace)

In Claude Code:

/plugin marketplace add enkerewpo/claude-buddy
/plugin install claude-buddy@enkerewpo
/reload-plugins
/claude-buddy:setup        # one-time: sets up the status line (plugins can't set it themselves)

Then restart Claude Code. Requires jq, python3, and the claude CLI on PATH.

Update later

/plugin marketplace update enkerewpo
/plugin install claude-buddy@enkerewpo
/reload-plugins

Without the plugin (manual)

Clone this repo and run ./install.sh (does the copy + settings.json edits itself).

Commands

• /claude-buddy:persona <sidekick|savage|warm|chaos|your text> — switch personality
• /claude-buddy:settings — view/tune cooldown, talk chance, mute
• /claude-buddy:setup — install/repair the status line

How it works

• scripts/buddy-react.sh — Stop hook. Occasionally (cooldown + chance) summarizes the latest turn (buddy-context.py) and asks claude -p --model haiku for one line, per ~/.claude/buddy-persona.txt; caches it to ~/.claude/.buddy_quip. Background, non-blocking, recursion-guarded.
• scripts/buddy.py — status-line display: mood dot + the cached line (only if recent). No model call.
• scripts/statusline.sh — buddy + model/context/usage/cost.

Personalities

Presets in scripts/personas/: sidekick (default), savage, warm, chaos. Or edit ~/.claude/buddy-persona.txt directly (takes effect next turn).

Cost / mute

~one Haiku call per turn (a fraction of a cent), in the background. Tune cadence with env.BUDDY_COOLDOWN / env.BUDDY_CHANCE; mute with env.BUDDY=0 (status line stays).