pixel-agents-hq/pixel-agents
Pixel Agents
Pixel Agents is a session manager and visualization dashboard for AI agents. It represents active agent sessions as animated pixel characters, allowing for real-time monitoring of presence, activity, and task progress within a virtual workspace.
The system features a grid-based workspace editor used to design custom office layouts and import pixel art assets via manifests. It tracks agent hierarchies by visualizing sub-agents as linked characters and monitors activity through session transcript polling to trigger real-time animations.
The project includes a desktop automation interface that performs operating system interactions, such as screen snapshots and mouse clicks, through a dedicated server. It also provides session management tools for discovering agents across multi-root environments and a mode to bypass tool permission prompts for automated workflows.
Diagnostic tools are available for verifying session connectivity, parsing integration logs, and debugging event data.
Features
- AI Agent Session Managers - Manages the lifecycle of AI agent sessions by linking them to terminal windows and adopting orphan session files.
- Automation Servers - Provides a backend automation server that bridges remote control interfaces to local operating system interactions.
- Agent Hierarchy Visualizations - Represents parent and sub-agent relationships by linking child characters to a primary agent identity.
- Agent Presence Rendering - Renders agents as animated pixel characters in a dedicated panel to provide a visual representation of presence.
- Agent Presence Visualizations - Represents active AI agent sessions as animated pixel characters to monitor presence and activity in real time.
- AI-Driven Desktop Automation - Provides capabilities for AI agents to interact with and control the computer display and input systems.
- Desktop Automation - Automates local desktop interactions, including screen snapshots and mouse clicks, via a specialized server.
- Agent Session Dashboards - Ships a visual dashboard that represents AI agents as animated characters to monitor their activity and session status in real time.
- AI Agent Activity Monitors - Provides real-time tracking of agent tool usage and sub-agent task progress through transcript polling.
- Grid Layout Engines - Implements a coordinate-based grid engine to position characters and furniture within a virtual office.
- Auto-Spawning - Automatically spawns active agents upon startup to provide immediate development assistance.
- Layout Persisters - Serializes and restores grid layout metadata and color configurations to ensure consistency across sessions.
- Sub-Agent Visual Tracking - Represents sub-tasks using temporary child characters that mirror the parent and forward permission requests.
- Manifest-Based Asset Mapping - Imports custom pixel art skins and furniture from local directories using predefined manifest files.
- Grid Canvas Editors - Provides a grid-based editor for organizing agent seating and defining office walls and dimensions.
- Workspace Layout Editors - Provides a grid-based design tool for creating custom virtual office layouts and importing assets.
- External Session Adoption - Identifies and adopts active agent sessions launched from external command line interfaces or editors.
- Visual Identity Mappings - Assigns unique animated characters to different terminal sessions and maps them to positions within a layout.
- Session File Discovery - Scans directories for session files to automatically link active agents to the visual dashboard.
- Activity Animations - Animates characters in real time based on terminal reading and writing events found in session transcripts.
- Agent Interaction Monitors - Tracks task progress and tool execution by polling session transcripts to trigger real-time interface updates.
- Customizable Workspaces - Enables the creation of customizable virtual office environments featuring walls and furniture via a grid editor.
- Agent Swarm Visualizations - Visualizes the structural relationships between parent agents and sub-agents using linked characters.
