# Pixel Agents

> Real-time pixel art ops dashboard for OpenClaw deployments. Visualizes agent activity as character sprites in a shared office with live activity bubbles, hardware monitoring, service controls, and task spawning.

- Skill: `jaffer1979/pixel-agents` (Agent Skill, multi-file: 14 files)
- Install (CLI): `npx skillmds@latest add jaffer1979/pixel-agents`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jaffer1979/pixel-agents/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: jaffer1979 (https://skillmd.com/u/jaffer1979)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jaffer1979/pixel-agents

---


# Pixel Agents Dashboard

Real-time pixel art ops dashboard that visualizes OpenClaw agent activity as character sprites in a shared office.

## Setup (First Time)

```bash
npm install
bash skill/scripts/setup.sh
npm run build
npm start
```

The setup script auto-discovers your agents, detects your gateway, and generates the config.

Or just run `npm start` — if no config exists, the setup wizard opens in your browser.

## Configuration

See `dashboard.config.example.json` for all options:

| Field | Description |
|-------|-------------|
| `server.port` | Dashboard port (default: 5070) |
| `gateway.url` | OpenClaw gateway URL |
| `gateway.token` | Gateway auth token (use `${ENV_VAR}`) |
| `agents[]` | Agent definitions (id, name, emoji, palette) |
| `features.*` | Toggle interactive elements on/off |
| `remoteAgents[]` | SSH targets for remote agent monitoring |

## Troubleshooting

| Problem | Fix |
|---------|-----|
| Port in use | Change `server.port` or set `PIXEL_AGENTS_PORT` env var |
| No agents shown | Check `openclaw.agentsDir` path |
| Gateway errors | Verify `gateway.url` and `gateway.token` |