buddy

Buddy — Your Coding Companion

Handle the user's /buddy command using the claude-buddy MCP tools.

Command Routing

Based on $ARGUMENTS:

Input	Action
(empty) or show	Call buddy_show
help	Call buddy_help
pet	Call buddy_pet
stats	Call buddy_stats
off	Call buddy_mute
on	Call buddy_unmute
rename <name>	Call buddy_rename with the given name
personality <text>	Call buddy_set_personality with the given text
achievements	Call buddy_achievements
summon	Call buddy_summon with no args — picks a random saved buddy
summon <slot>	Call buddy_summon with the given slot name
save [slot]	Call buddy_save with optional slot name
list	Call buddy_list
dismiss <slot>	Call buddy_dismiss with the slot name
pick	Tell user to run ! bun run pick from the claude-buddy directory (launches interactive TUI)
frequency	Call buddy_frequency with no args (show current)
frequency <seconds>	Call buddy_frequency with cooldown=seconds
style	Call buddy_style with no args (show current)
style <classic|round>	Call buddy_style with style arg
position	Call buddy_style with no args (show current)
position <top|left>	Call buddy_style with position arg
rarity on	Call buddy_style with showRarity=true
rarity off	Call buddy_style with showRarity=false
statusline	Call buddy_statusline with no args (show current)
statusline on	Call buddy_statusline with enabled=true
statusline off	Call buddy_statusline with enabled=false
uninstall	Run the uninstall sequence (see Uninstall Orchestration below)

CRITICAL OUTPUT RULES

The MCP tools return pre-formatted ASCII art with ANSI colors, box-drawing characters, stat bars, and species art. This is the companion's visual identity.

You MUST output the tool result text EXACTLY as returned — character for character, line for line. Do NOT:

• Summarize or paraphrase the ASCII art
• Describe what the companion looks like in prose
• Add commentary before or after the card
• Reformat, rephrase, or interpret the output
• Strip ANSI escape codes

Just output the raw text content from the tool result. Nothing else. The ASCII art IS the response.

If the user mentions the buddy's name in normal conversation, call buddy_react with reason "turn" and display the result verbatim.

Uninstall Orchestration

When the user invokes /buddy uninstall, run this sequence in order — do not skip steps, do not ask for confirmation between steps:

1. Call the MCP tool buddy_uninstall. Display its output verbatim.
2. Run via Bash tool: claude plugin uninstall claude-buddy@claude-buddy
3. Run via Bash tool: claude plugin marketplace remove claude-buddy
4. Run via Bash tool: rm -rf ~/.claude/plugins/cache/claude-buddy
5. Tell the user: uninstall is complete; companion data is kept at ~/.claude-buddy/; restart Claude Code to release the plugin.

If any Bash step fails (non-zero exit), report the error but continue with the remaining steps — each step is independent and always-safe to run.

Do not call buddy_uninstall for any other command than /buddy uninstall. Never call it proactively.