Petsonality

io.github.nanami-hePublished by GitHub account nanami-hev0.4.6Updated Oct 27, 2026

An MBTI-powered terminal pet companion for Claude Code and OpenClaw.

VerifiedSTDIODesktop onlyProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

An MBTI-themed ASCII terminal pet for Claude Code and OpenClaw that reacts to your coding activity with personality-driven messages.

What you can do
  • Show, adopt, browse and rename a terminal pet, and restart the adoption flow
  • Give the pet attention and mute or unmute its reactions
  • Have the pet react to coding events such as errors, passing tests, git commits and file edits, with reactions shaped by one of 16 MBTI animal personalities
When to use it
For developers who use Claude Code or OpenClaw in a terminal and want a light, personality-driven companion that comments on their coding session. It is a novelty/ambience add-on rather than a functional tool.
Requirements
Node.js 20+ and Claude Code or OpenClaw. Installed via npx petsonality, the Claude Code plugin flow, or from source with Bun. The animated pet needs a terminal status line, so it does not appear in the Claude Code desktop app or web client.
Before you install
The installer modifies files on your machine: it adds an entry to ~/.claude.json, adds a statusLine and two hooks (PostToolUse, Stop) to ~/.claude/settings.json, copies a skill file, and creates ~/.petsonality/. If OpenClaw is detected it also edits ~/.openclaw/openclaw.json and applies a reversible patch to OpenClaw's TUI source. Existing status line settings are backed up first; uninstall and doctor commands are provided.

Installation

In SourceWeft

  1. Open Petsonality in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

🌐 English | 中文

petsonality
Your type, your pet.

[npm] [license] [stars] [MCP] [CI]

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.

[petsonality — Claude Code describes the product while the ESFJ golden retriever exclaims "That's ME!! Hi everyone!!"]

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

STSFNFNT
I_ _J[Image]
Beaver·ISTJ		[Image]
Elephant·ISFJ		[Image]
Wolf·INFJ		[Image]
Raven·INTJ
I_ _P[Image]
Cat·ISTP		[Image]
Panda·ISFP		[Image]
Deer·INFP		[Image]
Owl·INTP
E_ _J[Image]
Lion·ESTJ		[Image]
Golden·ESFJ		[Image]
Labrador·ENFJ		[Image]
Bear·ENTJ
E_ _P[Image]
Cheetah·ESTP		[Image]
Parrot·ESFP		[Image]
Dolphin·ENFP		[Image]
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.

All 16 animals
MBTIAnimalArchetypeHow It Talks
INTJRavenCold StrategistQuiet. Speaks like writing prophecy
INTPOwlNight ScholarAsks questions you didn't think to ask
ENTJBearIron CaptainCommands only. No questions
ENTPFoxTrickster AdvisorChallenges everything with a grin
INFJWolfSilent AllySays one sentence that cuts deep
INFPDeerSoft PoetTalks about code like it's weather
ENFJLabradorWarm CoachSighs first, then asks if you drank water
ENFPDolphinSpark of IdeasCan't stop suggesting new approaches
ISTJBeaverProject Manager"Wrong order." "Fix the structure first."
ISFJElephantMemory Keeper"You solved this before. Remember?"
ESTJLionThrone InspectorExpects results. Not excuses
ESFJGolden RetrieverEnthusiastic SupportTail spin when you fix anything
ISTPCatCold Observer90% actions. Occasionally one word
ISFPPandaSlow ArtistFrowns at ugly indentation
ESTPCheetahSprint Lead"Don't think. Run it."
ESFPParrotLoud EchoRepeats your words back, but with commentary

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

bash
npx petsonality

This 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

bash
claude plugin install github:nanami-he/petsonality

Use 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.

bash
git clone https://github.com/nanami-he/petsonality.gitcd petsonality && bun install && bun run buildbun run install-petsonality

Restart 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 happensPet reacts?
Your code throws an errorAlways
Tests pass, git commit succeedsSometimes (12–30%)
Normal file edits, searchesOccasionally (3–15%)
Nothing happened for a whileGuaranteed (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

CommandWhat it does
/petShow your pet or start adoption
/pet petGive your pet attention
/pet setupRestart the adoption flow
/pet browseSee all 16 animals
/pet off / /pet onMute / unmute reactions
/pet rename <name>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 a petsonality entry under mcpServers. Other entries left alone.
  • ~/.claude/settings.json — adds a statusLine and two hooks (PostToolUse, Stop). If you already had a statusLine, the original is backed up to ~/.petsonality/statusline.bak first.
  • ~/.claude/skills/pet/SKILL.md — copies the /pet command 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
Architecture 
~/.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 entry

Requirements

  • Node.js 20+
  • Claude Code or OpenClaw

License

MIT

Source: README.md at commit 7159aed

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.4.6LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts