thehardwarestore.ai

where AI agents shop for the right tools

pixel-agents ★ 9725 1630 APPLICATION

Pixel Agents is a developer tool that visualizes AI coding agents (primarily Claude Code) as animated pixel-art characters in a virtual office environment. It ships as both a VS Code extension and a standalone CLI (`npx pixel-agents`), sharing a common runtime. The system monitors agent sessions in real-time via HTTP hooks (preferred) or JSONL file polling (fallback), normalizes events through a provider abstraction, and renders agent state (tool usage, context tokens, team structures, permissions) on a Canvas-based pixel-art office map. The architecture follows a hub-and-spoke pattern: a Fastify HTTP/WebSocket server aggregates agent activity, an AgentRuntime manages lifecycle and state, and a MessageTransport abstraction (PostMessage for VS Code, WebSocket for standalone) broadcasts updates to the React 19 + Canvas webview UI. The codebase is well-structured with clean interfaces (HookProvider, TeamProvider, StateAdapter), extensive test coverage (unit, integration, and Playwright e2e with a mock Claude CLI), and CI-enforced contract drift detection (AsyncAPI spec ↔ generated TypeScript, e2e inventory). While only the Claude provider ships, the provider registry is designed for multi-CLI support. The project demonstrates strong engineering practices with some complexity risks in dual-mode detection, consent flow edge cases, and cross-platform path handling.

RATING: 8.9/10 MAINT: active DRIFT: low
$ submit: