petsonality
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
A tiny ASCII pet that lives in the corner of your terminal while you code. It watches what you do, reacts to your errors, celebrates when tests pass, and speaks with a personality shaped by MBTI — all in 5 lines of art.
It's not a notification system. It's a companion. The kind that's still there at 2am when you're stuck on a bug, and glances at your screen like "...that logic looks off" — and somehow you feel less alone.
16 Animals, 16 Personalities
ST | SF | NF | NT | |
I_ _J | Beaver·ISTJ | Elephant·ISFJ | Wolf·INFJ | Raven·INTJ |
I_ _P | Cat·ISTP | Panda·ISFP | Deer·INFP | Owl·INTP |
E_ _J | Lion·ESTJ | Golden·ESFJ | Labrador·ENFJ | Bear·ENTJ |
E_ _P | Cheetah·ESTP | Parrot·ESFP | Dolphin·ENFP | Fox·ENTP |
Every animal speaks differently. The Fox asks "Are you sure?" with a smirk. The Cat just closes its eyes. The Parrot repeats what you said but louder. The Bear says "Fix it." and waits.
MBTI | Animal | Archetype | How It Talks |
INTJ | Raven | Cold Strategist | Quiet. Speaks like writing prophecy |
INTP | Owl | Night Scholar | Asks questions you didn't think to ask |
ENTJ | Bear | Iron Captain | Commands only. No questions |
ENTP | Fox | Trickster Advisor | Challenges everything with a grin |
INFJ | Wolf | Silent Ally | Says one sentence that cuts deep |
INFP | Deer | Soft Poet | Talks about code like it's weather |
ENFJ | Labrador | Warm Coach | Sighs first, then asks if you drank water |
ENFP | Dolphin | Spark of Ideas | Can't stop suggesting new approaches |
ISTJ | Beaver | Project Manager | "Wrong order." "Fix the structure first." |
ISFJ | Elephant | Memory Keeper | "You solved this before. Remember?" |
ESTJ | Lion | Throne Inspector | Expects results. Not excuses |
ESFJ | Golden Retriever | Enthusiastic Support | Tail spin when you fix anything |
ISTP | Cat | Cold Observer | 90% actions. Occasionally one word |
ISFP | Panda | Slow Artist | Frowns at ugly indentation |
ESTP | Cheetah | Sprint Lead | "Don't think. Run it." |
ESFP | Parrot | Loud Echo | Repeats your words back, but with commentary |
Related MCP server: buddy-mcp
Install
Works with Claude Code and OpenClaw.
Terminal CLI only. The pet renders in the terminal status line, which is a CLI feature. The Claude Code desktop app and web client (claude.ai/code) don't expose a status line, so the animated pet won't appear there. MCP tool output (e.g.
/pet show) still works in any client.Windows note. Claude Code for Windows has an upstream status-line trust regression in some versions. If the status line is configured but does not render, accept the project trust dialog or ensure the project is marked trusted in
~/.claude.json, then restart Claude Code.
npm / npx
npx petsonalityThis is the recommended path for most users. It installs the MCP server, /pet skill, hooks, and status line assets, then stores runtime files in ~/.petsonality/.
Claude Code plugin
claude plugin install github:nanami-he/petsonalityUse this if you prefer Claude Code's plugin install flow. The plugin runs the built Node.js server from dist/, so it does not require Bun.
From source
Use this path if you want to develop Petsonality locally or inspect the code before installing. Requires Bun.
git clone https://github.com/nanami-he/petsonality.git
cd petsonality && bun install && bun run build
bun run install-petsonalityRestart your AI coding assistant, then type /pet in the chat.
How It Speaks
Pets don't just react to errors. They have a rhythm:
What happens | Pet reacts? |
Your code throws an error | Always |
Tests pass, git commit succeeds | Sometimes (12–30%) |
Normal file edits, searches | Occasionally (3–15%) |
Nothing happened for a while | Guaranteed (won't stay silent forever) |
Chatty pets (Fox, Parrot) speak every 30 seconds. Silent pets (Cat) might go 6 minutes. Each animal has 638 unique reactions across 7 event types, validated against personality constraints.
Commands
Command | What it does |
| Show your pet or start adoption |
| Give your pet attention |
| Restart the adoption flow |
| See all 16 animals |
| Mute / unmute reactions |
| Rename your pet |
What petsonality modifies
npx petsonality is an installer — it touches a few files on your system. Honest list, with backups noted:
~/.claude.json— adds apetsonalityentry undermcpServers. Other entries left alone.~/.claude/settings.json— adds astatusLineand two hooks (PostToolUse,Stop). If you already had astatusLine, the original is backed up to~/.petsonality/statusline.bakfirst.~/.claude/skills/pet/SKILL.md— copies the/petcommand skill.~/.petsonality/— runtime directory (pet state, reactions cache, server, hooks, status-line scripts).
If OpenClaw is detected, also touches ~/.openclaw/openclaw.json and (until PR #65886 merges) applies a small reversible patch to OpenClaw's TUI source. Both backed up.
To remove everything: npx petsonality uninstall. To audit current state: npx petsonality doctor.
Full breakdown + other common questions in the FAQ.
Roadmap
16 MBTI animals with full personality profiles
Animated status line with speech bubbles
Companion rhythm (daily triggers, milestones, silent streak guardrail)
638 animal-specific reactions
Multi-host support (Claude Code + OpenClaw)
Node.js powered (no python/jq dependency)
Published on npm
Multi-language support (auto zh / en via
LANG, 638 reactions per language)Growth system (level up through interaction)
Hat / skin DLC
Multi-pet collection
Vibe-pick: MBTI quiz for new users
~/.petsonality/
├── pet.json Your pet's state
├── status.json What the status line reads
├── reaction.*.json Current speech bubble
└── reactions-pool.json 638 pre-built reactions
petsonality/
├── dist/ Built JS (Node.js runtime)
├── server/ MCP server (TypeScript)
├── hooks/ PostToolUse + Stop hooks
├── statusline/ Terminal animation (bash + PowerShell)
├── skills/ /pet command routing
└── cli/ Install, doctor, npx entryRequirements
Node.js 20+
Claude Code or OpenClaw
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
AI colleagues that keep your standards, your project and their reasoning between sessions
AI coding streaks and leaderboards: profiles, heatmaps, who coded with AI today.
AI personas with a lasting, encrypted memory per project, for Claude Code. Hosted in France.
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…
Related MCP Servers
- AlicenseAqualityDmaintenanceASCII art & kaomoji for AI agents, CLI tools, and chatbots.1182 npm1MIT
- AlicenseBqualityFmaintenanceA terminal-native creature collection game for Claude Code. Hatch rare digital buddies, build their affection through interaction, and complete your collection in the BuddyDex.951 npmMIT
- AlicenseBqualityCmaintenanceEnables AI assistants to create, animate, and export ASCII art using natural language, with live browser sync.9656 npm12MIT
- FlicenseNot gradedqualityBmaintenanceThe terminal AI agents can drive: a cross-platform desktop terminal (macOS/Linux/Windows, MIT) that runs a local MCP server. Spawn tabs/panes, run commands with structured output, read screens and full scrollback, take scrolling screenshots, record sessions with secret redaction, switch identity profiles. Auto-registers with Claude Code / Codex / Gemini CLI on install.19-