Pocket Claudes

Pocket Claudes is a transparent, always-on-top desktop overlay that visualizes your live Claude Code sessions as little NPCs walking across your screen. Every running session spawns its own character. The NPCs animate to reflect what their session is doing in real time like reading files, editing code, running shell commands, browsing the web, thinking, or waiting on you.

It is a cosmetic background companion, not a productivity tool. It sits quietly above your editor and terminal so you can glance over and see, at a glance, what your AI is up to without alt-tabbing into a window.

# Features

- Manage Claude Code session live on your desktop screen
- Manage Claude Code agent and sub-agent states such as doing action, waiting for user input, need attention,...
- Alert sounds for when Claude Code need user permission or have finish the task
- Quick access to the Claude Code session's cmd by clicking directly on the NPC

# How to install

- Download the game
- Setup the PocketClaudes plugin in Claude Code (read the read-this-first.txt in the game's folder)
- Open the game and start your Claude Code session
- Enjoy :)