Petsonality

io.github.nanami-he由 GitHub 账号 nanami-he 发布v0.4.6更新于 Oct 27, 2026

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

已验证STDIO仅桌面效率与工作流开发者工具

概览

AI 生成的概览

一款基于 MBTI 人格的 ASCII 终端宠物，运行在 Claude Code 和 OpenClaw 中，会根据你的编码活动以不同性格做出反应。

可以做什么
  • 查看、领养、浏览和重命名终端宠物，并重新开始领养流程
  • 抚摸宠物给予关注，以及静音或恢复它的反应
  • 让宠物对报错、测试通过、git 提交和文件编辑等编码事件做出反应，反应风格由 16 种 MBTI 动物人格之一决定
适用场景
适合在终端中使用 Claude Code 或 OpenClaw、希望有个带性格的小宠物对编码过程发表评论的开发者。它属于趣味陪伴类附加组件，而非功能性工具。
运行要求
需要 Node.js 20+ 以及 Claude Code 或 OpenClaw。可通过 npx petsonality、Claude Code 插件流程安装，或使用 Bun 从源码构建。动画宠物依赖终端状态栏，因此在 Claude Code 桌面应用和网页客户端中不会显示。
安装前请注意
安装程序会改动本机文件：在 ~/.claude.json 中添加条目，在 ~/.claude/settings.json 中添加 statusLine 和两个钩子（PostToolUse、Stop），复制技能文件，并创建 ~/.petsonality/。若检测到 OpenClaw，还会修改 ~/.openclaw/openclaw.json 并对 OpenClaw 的 TUI 源码打一个可回退的补丁。原有状态栏设置会先备份，并提供卸载和 doctor 检查命令。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Petsonality，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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[图片]
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.

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

来源：README.md，提交 7159aed

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.4.6最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分