AI Avatar

A VRM 3D character in your VS Code sidebar that reacts to Claude Code AI activity.

Features

• 🎭 Live reactions — character automatically reacts when Claude Code is thinking or responds
• 💬 Lipsync — mouth animates while Claude is replying
• 👀 Eye tracking — eyes and head follow your mouse cursor when idle
• 😊 Click to smile — click the avatar to trigger a smile
• 🙂 Nod on send — avatar nods when you send a message to Claude Code
• 🎥 OrbitControls — drag to rotate, scroll to zoom, right-click to pan
• 🔄 Change Avatar — swap your VRM character anytime with the button at the top
• 💃 VRMA Animations — play .vrma motion clips when Claude finishes responding (toggle ON/OFF)

Getting Started

No setup needed — comes with a built-in sample character. Just install and open VS Code.

To open the panel, click the AI Avatar icon in the activity bar on the side of VS Code.

Use Your Own VRM Character

You can create your own 3D avatar for free using VRoid — no 3D modeling skills needed. Design your character and export it as a .vrm file.

Option 1 — Button in the panel: Click the Change Avatar button at the top of the sidebar to pick a .vrm file.

Option 2 — Settings:

1. Open VS Code settings (Ctrl+,)
2. Search vroidCompanion.vrmFilePath
3. Set the absolute path to your .vrm file

VRMA Animations

The Animation button lets your avatar play .vrma motion clips when Claude finishes responding.

Animation files are not included in the extension because they cannot be redistributed under their license terms. Download them yourself for free from the official VRoid Project:

👉 VRM Animation 7-Pack by VRoid Project (free)

The pack includes 7 animations: Show full body, Greeting, Peace sign, Shoot, Spin, Model pose, and Squat.

How to set up:

1. Download and unzip the pack
2. Click the Animation: OFF button in the sidebar — it opens a file picker
3. Select the .vrma files you want to use
4. The button switches to Animation: ON and a random clip plays each time Claude responds

Commands

Open Command Palette (Ctrl+Shift+P):

Using with Claude Code VS Code Extension

You can display both panels side by side at the same time:

1. Right-click either extension's icon in the activity bar
2. Select Move to Secondary Side Bar

One panel goes to the left sidebar, the other to the right — you can choose which side each one is on.

Requirements

• VS Code 1.85+
• Claude Code CLI or VS Code extension (for automatic reactions)