IvanWng97/pixtuoid

pixtuoid – a terminal‑based visual dashboard for AI coding agents

What it is – pixtuoid is a Rust‑written TUI (terminal user interface) that turns every running AI‑powered coding assistant (Claude Code, Codex, Antigravity, etc.) into a tiny pixel‑art “coworker” inside a simulated office. Each agent gets its own desk, a colored monitor, a token‑usage meter, and animated behaviours (typing, waiting, sleeping). The office can span multiple floors, has themed décor, weather effects, background lofi music, and even roaming pets. It is purely local – it only reads the agents’ stdout/JSONL transcripts and a tiny non‑blocking hook, never sending data anywhere.

Quick start (from the README)

Install – choose one of the provided package managers:
```
# Homebrew (macOS, Linux, WSL2)
brew install pixtuoid

# npm (any OS)
npm install -g pixtuoid
```
(Cargo, pre‑built binaries, and .deb packages are also available.)
Run the dashboard:
```
pixtuoid
```
Press s to open the Sources panel and point pixtuoid at the CLI of the coding agent you want to watch (Claude Code, Codex, etc.). Start that agent in another terminal; a pixel‑art character will walk in from the elevator within a second.
Use the keyboard shortcuts shown in the README (q quit, p pause, t themes, Tab dashboard, etc.) to navigate floors, change themes, mute the soundtrack, etc.

Core features (as listed in the README)

Feature	What you see
Multi‑agent office	Each agent runs at its own desk; new floors appear automatically when needed.
Multi‑floor office	Switch floors with `PageUp/PageDown` or `↑/↓` – the view slides smoothly.
Office spaces	Distinct zones (cubicles, lounge, pantry) give the layout personality instead of a plain grid.
Animated characters	Agents type, raise a `?` when they need input, sleep (z’s), and walk using A*‑routed paths.
Team palette	Shirt/pants colors are derived from the current working directory, so agents from the same repo share a hue.
Per‑tool monitor glow	Desk monitors glow blue for editing, orange for Bash, cyan for reading, etc., giving an instant visual cue of what tool the agent is using.
Token meter	A stack of paper on the desk visualises token consumption (250 K → 2 M → 16 M tiers); hovering shows the exact total.
Hover tooltips	Hover over an agent for session length, tool‑call count, active‑time %; hover over furniture for its name.
Agent tree dashboard	Press `Tab` to open a collapsible tree view of all agents, colour‑coded by activity and showing call counts.
Office pets	A roaming cat or dog (one per floor) that can be petted with a click.
OpenClaw gateway mascot	A lobster that wanders the office; its movement visualises the health of the OpenClaw gateway.
Office vibes	Day/night cycle, weather (rain, snow, fog, etc.) and six built‑in colour themes.
Lofi soundtrack	Procedurally generated music that changes with time of day and activity; sound effects for typing, doors, printer, vending machine.
Floating desktop window	`pixtuoid floating` opens the office in a frameless, always‑on‑top window outside the terminal.
Hook‑safe	The tiny shim that agents talk to always exits with status 0, so a misbehaving hook can’t block the agent.

Supported AI coding tools

Tool	Platforms
Claude Code	macOS, Linux, Windows*
Codex CLI	macOS, Linux, Windows*
(and many others – Antigravity, DeepSeek‑Reasonix, CodeWhale, Copilot CLI, Cursor CLI, Hermes Agent, OpenClaw, Grok Build, Kimi Code CLI, etc.)

The full matrix of tools × OS is on the site, and adding a new tool only requires implementing the Source trait (or a simple hook decoder) and updating sources.json.

How it works (high‑level, from the README)

Agent CLI → Hook shim – Each supported agent writes a tiny fire‑and‑forget event (via a Unix socket or Windows named pipe) every time it performs an action.
Agent CLI → JSONL transcript – The CLI also emits a line‑delimited JSON stream of its activity.
pixtuoid core – A reducer consumes both streams, merges them into a single office‑state model.
Renderer – Five Rust crates render that state as half‑block pixel art directly in the terminal (or in a floating window). No external terminal UI libraries are used in the core.
Safety – The hook shim is designed to never block; even if it hangs, the agent continues to run.

Configuration & extensibility

Config lives in ~/.config/pixtuoid/config.toml (created on first launch). All keys are optional; CLI flags override the file.
Themes can be switched live with t; six built‑in palettes are provided.
Users can add custom sprite packs, rename pets, and adjust desk capacity via the config file.
Adding a new agent integration is a matter of implementing the Source trait and adding a row to sources.json – the project includes a test that pins the supported set.

Privacy & security

Local‑only – No network traffic, no telemetry.
Reads agent transcripts read‑only.
Dependency list is audited daily with cargo‑deny.
Security considerations (hook shim permissions, socket ownership, etc.) are documented in SECURITY.md.

Who might use it?

Developers who run several LLM‑based coding assistants in parallel and want a glanceable overview of their status.
Teams that like a playful visual cue for token consumption and agent health.
Anyone who enjoys a bit of retro‑pixel art while watching AI agents work.

License

MIT – free for personal or commercial use.

Bottom line: pixtuoid is a fully‑featured, open‑source visual dashboard that turns multiple AI coding agents into an animated pixel‑art office, giving developers an at‑a‑glance view of activity, token usage, and tool state—all without sending any data off‑machine.