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 分