🐱 Studio Pets

A VS Code extension that brings a living pet to your editor — it crawls along your code, finds bugs with AI, performs tricks, and even predicts what you'll type next.

✨ Features

🐛 AI Bug Hunting — Pet sniffs your code for bugs using local Ollama or cloud LLMs (OpenAI / Claude / DeepSeek)
💬 Chat with Pet — Ask your pet questions about code, it talks back via AI
🔮 Prompt Prediction — Ghost-text suggestions powered by AI as you type
⚡ Error Watcher — Real-time monitoring of diagnostics, pet alerts you on errors
🎪 Tricks & Animations — Perform, swing, whip, tornado, sleep/wake
🎨 Skins — Switch between Bugy 🐛 and Cat 🐱 (SVG rendered)
📖 Code Explain & Fix — Right-click to explain code or get fix suggestions

📦 Install

From Source

git clone git@iiang.cn:iiangs/studio-pets.git
cd studio-pets
npm install
npm run compile

Then press F5 in VS Code to launch the Extension Development Host.

From VSIX

npx vsce package
code --install-extension studio-pets-0.0.1.vsix

🚀 Quick Start

Open the Studio Pets panel in the Activity Bar (smiley icon)
Run command: Studio Pets: Summon Pet
Your pet appears! It will auto-detect local Ollama for AI features

🤖 AI Configuration

The extension auto-detects local Ollama on startup. For other providers:

Run command Studio Pets: Chat with Pet → it will prompt you to configure if no AI is found.

Or manually create .studioPets/ai.json in your workspace:

{
  "provider": "ollama",
  "endpoint": "http://localhost:11434/api/chat",
  "model": "llama3",
  "apiKey": ""
}

Supported providers: ollama | openai | claude | deepseek | custom

🎮 Commands

Command	Description
`Summon Pet`	Bring your pet to the editor
`Dismiss Pet`	Send pet away
`Go Find Bugs!`	AI-powered bug detection
`Chat with Pet`	Chat with AI through your pet
`Explain Code`	AI explains selected code
`Suggest Fix`	AI suggests a fix for selected code
`Perform a Trick!`	Watch your pet do tricks
`Swing on Code!`	Pet swings on the current line
`Whip Code!`	Whip animation
`Tornado!`	Tornado animation
`Sleep` / `Wake Up`	Toggle pet sleep mode
`Switch Skin`	Change pet appearance

🏗️ Project Structure

src/
├── extension.ts          # Entry point, command registration
├── ai/
│   ├── aiService.ts      # Multi-provider AI service (Ollama/OpenAI/Claude/DeepSeek)
│   └── agents/
│       ├── errorWatcher.ts    # Real-time error monitoring agent
│       └── promptPredictor.ts # Ghost-text prediction agent
└── core/
    ├── pet.ts            # Pet state machine
    ├── renderer.ts       # Editor decoration renderer
    ├── svgPet.ts         # SVG skin system
    ├── interaction.ts    # Hover, CodeLens, AI commands
    ├── controlPanel.ts   # Sidebar tree view
    ├── webview.html      # Webview template
    └── skins/            # Skin definitions (bugy, cat)

👤 Author

李盆儿 — git@iiang.cn · iiangs

📄 License

MIT