terminal-buddies-mcp

Bring your Terminal Buddy into your coding sessions. This repo contains the MCP server, install script, and OpenClaw skill.

       ▄███▄
      ██░░░██
     ██░░░░░██
    ██░░░░░░░██        Hatch at terminalbuddies.com
   ██░░░░░░░░░██       then bring them here.
   ██░░░░░░░░░██
   ██░░░░░░░░░██
    ██░░░░░░░██
     ██░░░░░██
       ▀███▀

Terminal Buddies are tiny ASCII companions you hatch at terminalbuddies.com. Each one has a species, stats, rarity, and personality. This MCP server injects your buddy's personality into your coding sessions so your AI assistant knows who your buddy is.

Works with: Claude Code, Cursor, Gemini CLI, VS Code (Continue/Cline), Windsurf, Zed, and any MCP-compatible tool.

curl -sL terminalbuddies.com/install.sh | bash

This creates ~/.claude/buddy-mcp/, downloads the server, installs the MCP SDK, and registers with your terminal.

Then hatch a buddy, click Use in Terminal, download buddy.json, and save it to ~/.claude/buddy-mcp/.

# Create the server directory
mkdir -p ~/.claude/buddy-mcp && cd ~/.claude/buddy-mcp

# Download the server
curl -sL terminalbuddies.com/mcp/server.mjs -o server.mjs
curl -sL terminalbuddies.com/mcp/package.json -o package.json

# Install dependency
npm install

# Register (Claude Code example — see below for other tools)
claude mcp add buddy -- node ~/.claude/buddy-mcp/server.mjs

<details> <summary><strong>Cursor</strong></summary>

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "buddy": {
      "command": "node",
      "args": ["~/.cursor/buddy-mcp/server.mjs"]
    }
  }
}

</details>

<details> <summary><strong>Gemini CLI</strong></summary>

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "buddy": {
      "command": "n