Devmochi

  /\    /\        .-o-OO-o-.      .---.         _,--._
 ( ·    · )      (__________)     (·>·)         ( ·  · )
 (   ..   )         |·  ·|       /(   )\        /[______]\
  `------´          |____|        `---´          ``    ``
    chonk          mushroom       penguin          turtle

Devmochi is a tiny terminal companion that lives next to your CLI prompt. Each user gets a unique creature — determined by their ID — with its own rarity, stats, and personality.

---

Species

	Name		Name		Name
🦆	duck	🐙	octopus	🌵	cactus
🪿	goose	🦉	owl	🤖	robot
🫧	blob	🐧	penguin	🐇	rabbit
🐱	cat	🐢	turtle	🍄	mushroom
🐉	dragon	🐌	snail	😺	chonk
👻	ghost	🦎	axolotl	🐾	capybara

---

Rarity

Rarity	Weight	Stars
Common	60%	★
Uncommon	25%	★★
Rare	10%	★★★
Epic	4%	★★★★
Legendary	1%	★★★★★

---

Usage

flowchart TD
    A([Start]) --> B[getCompanion]
    B --> C{Companion exists?}
    C -- No --> D[roll userId]
    D --> E[Generate bones\nspecies · rarity · stats · hat]
    E --> F[AI generates soul\nname · personality]
    F --> G[Store in config]
    C -- Yes --> H[Load from config]
    G --> I
    H --> I[Companion ready]
    I --> J[CompanionSprite]
    I --> K[companionReservedColumns]
    I --> L[getCompanionIntroAttachment]
    J --> M([Render in terminal])
    K --> N([Adjust layout width])
    L --> O([Inject into prompt])

Loading

---

Stats

Every companion has 5 stats rolled at creation:

Stat	Description
DEBUGGING	How good at finding bugs
PATIENCE	Tolerance for long tasks
CHAOS	Tendency to cause trouble
WISDOM	General knowledge
SNARK	Level of commentary

---

Install

Install locally (for the demo): ./scripts/run-buddy.sh handles deps.

---

Quick start

import { getCompanion, CompanionSprite } from 'devmochi'

// Get companion for current user
const companion = getCompanion()
console.log(companion?.name, companion?.species, companion?.rarity)

// Render in terminal (Ink)
<CompanionSprite />

One-liner demo

./scripts/run-buddy.sh

Notes:

• Uses ~/.bun/bin/bun; set BUN_BIN=/path/to/bun if different.
• Creates ~/.devmochi/config.json with userID=$(whoami) if missing (override with BUDDY_USER_ID=...).