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.

pixel-agents-hqpixel-agents

Features

Star history