aibou

Typet — MBTI Pet Companion

A personality-based terminal pet companion. Each pet has a unique MBTI personality, speaks in character, and lives in your terminal status line.

Features

• 16 MBTI Animals — Each with distinct personality, voice, and behavior
• ASCII Art — Animated pets with blinking, head movement, paw gestures
• Speech Bubbles — Pets react to your code with in-character comments
• MBTI Matching — Mirror (like you) and Complement (balances you) recommendations
• MCP Server — Works with any MCP-compatible client

Quick Start

# Clone and install
git clone https://github.com/nanami-he/typet.git
cd typet
bun install

# Register with your MCP client
bun run install-typet

Restart your MCP client, then type /pet to adopt your companion.

Commands

Command	Action
/pet	Show your pet or start adoption
/pet pet	Interact with your pet
/pet setup	Start adoption flow
/pet browse	Browse all 16 pets
/pet off	Mute reactions
/pet on	Unmute reactions
/pet rename <name>	Rename your pet

The 16 Animals

Group	Animals
NT Analysts	Raven (INTJ), Owl (INTP), Bear (ENTJ), Fox (ENTP)
NF Diplomats	Wolf (INFJ), Deer (INFP), Labrador (ENFJ), Dolphin (ENFP)
SJ Sentinels	Beaver (ISTJ), Elephant (ISFJ), Lion (ESTJ), Golden Retriever (ESFJ)
SP Explorers	Cat (ISTP), Panda (ISFP), Cheetah (ESTP), Parrot (ESFP)

How It Works

• MCP Server — Runs as stdio transport, spawned automatically by the client
• Status Line — Animated pet with speech bubble in your terminal
• Stop Hook — Extracts <!-- pet: ... --> comments from responses
• PostToolUse Hook — Detects errors/test failures, pet reacts in character

Requirements

• Bun runtime
• jq for JSON processing
• Any MCP-compatible client

Architecture

~/.mbti-pet/
├── pet.json          — Pet state (adopted, mood, interactions)
├── status.json       — Compact state for status line
├── reaction.*.json   — Session-specific speech bubbles
└── config.json       — User preferences

typet/
├── server/           — MCP server (TypeScript)
│   ├── index.ts      — Tools: setup, adopt, show, pet, react
│   ├── engine.ts     — MBTI mappings, types, colors
│   ├── art.ts        — ASCII art (16 animals x 3 frames)
│   ├── pets.ts       — Full personality profiles
│   ├── voice.ts      — Speech constraints + validation
│   ├── reactions.ts  — Event-based reaction templates
│   ├── state.ts      — Persistence layer
│   └── utils.ts      — CJK display width helpers
├── statusline/       — Terminal status line (bash)
├── hooks/            — Stop + PostToolUse hooks
├── skills/           — Skill routing
└── cli/              — Install, doctor, show, backup

License

MIT