# Petsonality

Petsonality puts an MBTI-based ASCII pet in the terminal. It reacts to coding events and gives you /pet commands for interaction.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: nanami-he
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nanami-he/petsonality
- Updated: 2026-06-11
- HTML: https://affpapa.org/en/nevibecode/mcp/petsonality

## What it does

Petsonality runs a small ASCII companion in the terminal and gives it a personality based on MBTI. It reacts when code fails, may celebrate passing tests or successful commits, and speaks up after a quiet stretch. The `/pet` commands let you view the pet, browse the animals, rename it, or mute its reactions.

The MCP server is launched through `npx` and can be connected to Claude Code, Codex, Cursor, GitHub Copilot, and the other listed clients. Its installer includes the `/pet` skill, hooks, and status-line assets. It also updates `~/.claude.json` and `~/.claude/settings.json`; a source install requires Bun.

The animated pet needs a terminal status line. It will not render in the Claude Code desktop app or web client, although MCP output such as `/pet show` still works from any client.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add petsonality -- npx -y petsonality
```

### Codex

**Platform CLI**
```bash
codex mcp add petsonality -- npx -y petsonality
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "petsonality": {
            "command": "npx",
            "args": [
                "-y",
                "petsonality"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "petsonality": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "petsonality"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add petsonality npx -y petsonality
```

## When to use it
- show a pet in the terminal status line
- react to coding errors during agent work
- acknowledge passing tests and successful commits
- browse and rename the selected animal
- mute or restore pet reactions

## Example prompts
- Show my pet with `/pet`.
- List all available animals using `/pet browse`.
- Mute the pet with `/pet off`.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
