Repolode
Submit
pixel-agents-hq

pixel-agents-hq/pixel-agents

A VS Code extension and standalone browser app that shows your Claude Code terminal agents as animated pixel-art characters working in a virtual office.

View on GitHub
Stars
10,091
Forks
1,715
Open issues
111
Last commit
3 days ago

What is it?

Pixel Agents turns each Claude Code session into an animated pixel-art character in a small office. Characters walk to their desks, type while editing files, read while searching, and show a speech bubble when they are waiting for input or permission. It helps developers running several agents at once see at a glance which ones are busy and which need attention.

The project ships in two forms from one codebase: a VS Code extension that launches agents into VS Code terminals and renders the office in a panel, and a standalone CLI (`npx pixel-agents`) that starts a local server and serves the same office in a browser, which suits tmux, remote, and non-VS Code workflows. Office layouts can be edited with floors, walls, furniture, carpets, pets, and named areas, and exported as JSON.

Claude Code is the only supported agent today. The integration sits behind a typed provider interface, so other CLIs are meant to be added as a subdirectory, and the project lists Codex, Gemini, and Cursor on its roadmap.

Key features

  • 01Each Claude Code terminal gets its own animated character that reflects its current activity.
  • 02Speech bubbles and optional sound alerts flag agents waiting for input or permission.
  • 03Sub-agents and Agent Teams appear as separate characters.
  • 04Built-in layout editor for floors, walls, furniture, carpets, and animated pets.
  • 05Runs as a VS Code extension or as a standalone browser app via npx.

Use cases

  • Keeping track of several Claude Code sessions running in parallel in VS Code.
  • Monitoring agents from a browser when working in tmux or over a remote machine.
  • Spotting which agent is stuck waiting for approval without switching terminals.

Quick start

  1. 1

    Install the VS Code extension from the Marketplace or Open VSX

  2. 2

    Run the standalone CLI from your project folder

    npx pixel-agents
  3. 3

    Or install the CLI globally, then run it

    npm install --global pixel-agents

Things to know

  • Only Claude Code is supported today; other AI tools are on the roadmap.
  • Requires the Claude Code CLI to be installed and configured, plus VS Code 1.105.0+ or Node.js 20+.

In collections

Claude Code tools, skills & pluginsOpen-source AI agent frameworks & appsCLI & terminal toolsDiagrams, charts & animated visualizations

Topics

#ai-agents#claude-code#vscode-extension#developer-tools#visualization#terminal#typescript

FAQ

What is pixel-agents?
A VS Code extension and standalone browser app that shows your Claude Code terminal agents as animated pixel-art characters working in a virtual office. Pixel Agents turns each Claude Code session into an animated pixel-art character in a small office. Characters walk to their desks, type while editing files, read while searching, and show a speech bubble when they are waiting for input or permission. It helps developers running several agents at once see at a glance which ones are busy and which need attention.
Is pixel-agents free to use? What license does it have?
pixel-agents is open source under the MIT license. Check the license terms before using it in commercial products.
Is pixel-agents still maintained?
Actively maintained. The last commit to pixel-agents was on Nov 3, 2026.
What can I use pixel-agents for?
Keeping track of several Claude Code sessions running in parallel in VS Code. Monitoring agents from a browser when working in tmux or over a remote machine. Spotting which agent is stuck waiting for approval without switching terminals.
How do I install pixel-agents?
Install the VS Code extension from the Marketplace or Open VSX Run the standalone CLI from your project folder: npx pixel-agents Or install the CLI globally, then run it: npm install --global pixel-agents
Where can I get pixel-agents?
The source code and installation instructions are on GitHub: https://github.com/pixel-agents-hq/pixel-agents

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects