Your AI coding agents, visualized as pixel-art coworkers in a terminal office.
pixel + tui + (agent-)oid
🖥︎ Live demo ↗ · Architecture · Configuration · Contributing
Running several coding agents means alt-tabbing between terminals to find out who's stuck, who's waiting on a permission prompt, and who finished ten minutes ago. pixtuoid puts them all in one tiny pixel-art office you can watch from above — every session is a character at a desk: typing while it works, raising a ? when it needs you, dozing off when it's done.
A little bit Black Mirror, a little bit The Sims — and the most glanceable multi-agent dashboard you'll ever use.
Pick one — Homebrew on macOS, or npm on any OS:
Homebrew (macOS):
brew install IvanWng97/pixtuoid/pixtuoidnpm (any OS):
npm install -g pixtuoidThen launch:
pixtuoidPress s to open the Sources panel and connect your agent CLI (Claude Code, Codex, Antigravity, Reasonix, …) — pixtuoid wires up the integration for you, no separate install step. In another terminal, start that coding agent. A character walks in from the elevator within a second; disconnect in the same panel and it walks back out. The panel also flags a source whose hooks are connected but broken (run pixtuoid doctor for the full health report).
Keyboard shortcuts: q quit · p pause · s sources (connect / health) · t themes · Tab agent dashboard · ? help · ↑↓/jk/PgUp/PgDn floors · click to pin tooltip
More ways to install — Cargo, prebuilt binaries, and Debian .debs — are on the install guide ↗. Upgrading from ascii-agents? See docs/MIGRATION.md.
| Feature | Description | |
|---|---|---|
| 🏢 | Multi-agent office | Each agent session gets a desk; overflow agents auto-fill new floors |
| 🛗 | Multi-floor office | PageUp/PageDown/↑↓/jk to navigate floors with slide transition |
| 🪟 | Floating desktop window | pixtuoid floating opens a frameless, always-on-top desktop window of the office — not just a terminal TUI |
| 🎭 | Animated characters | Typing, waiting (?), sleeping (z's), walking with A*-routed pathfinding |
| 💡 | Per-tool monitor glow | Edit = blue, Bash = orange, Read = cyan — scannable at a glance |
| 🎨 | Per-agent identity | Deterministic shirt/hair/skin palette from session hash, 16 curated outfits |
| 🦞 | OpenClaw gateway mascot | A live OpenClaw gateway shows up as a wandering lobster whose motion tracks gateway health |
| 🌧️ | Weather effects | Rain, storm, snow, fog, overcast, windy — cycles every 10 min + sunset golden hour |
| 🔎 | Hover tooltips | Hover an agent for session duration, tool-call count and active-time %; hover any furniture — desks, sofas, plants, vending machine, printer — for its name |
| 🐾 | Office pets | A cat or dog (one per floor) roams desks, pantry, sofas; sleeps near idle agents. Click to pet — pixel-art hearts float up |
| 🛡️ | Hook-safe | The shim always exits 0 — a stuck visualizer can never block your agent |
▶ See every feature live — floors, themes, weather, pets, the office tour →
| Tool | Runs on |
|---|---|
| Claude Code | macOS · Linux · Windows* |
| Codex CLI | macOS · Linux · Windows* |
Also supported: Antigravity CLI, DeepSeek-Reasonix, CodeWhale, Copilot CLI, opencode, Cursor CLI, OpenClaw.
→ Full tool × OS support matrix on the site
* experimental — limited testing, unsigned binaries.
Adding a new tool? Implement the
Sourcetrait — or, for a hook-only CLI, just a hook decoder + an installTarget— then add a row tosite/src/sources.json(itssupportedset is pinned to the code by a test). One file, one channel, done.
Press t to cycle the built-in themes with live preview. Your choice persists across sessions:
Settings live in ~/.config/pixtuoid/config.toml — theme, desk cap, custom pet
names, and sprite packs. CLI flags override the file (pixtuoid run --theme dracula).
See docs/CONFIGURATION.md for the full key reference
(defaults, system-managed keys), the custom sprite-pack workflow, and logging /
troubleshooting (the TUI writes warnings to ~/.cache/pixtuoid/log) — or browse it
live at /config.
Agent CLIs emit events two ways — a hook shim (a 200ms fire-and-forget write to a Unix socket, or a named pipe on Windows, that can never block your agent) and JSONL transcript watching. Both feed one channel; a reducer folds events into office state; the renderer draws it as half-block pixel art. Four Rust crates, zero terminal deps in the core.
Full architecture with diagrams → · single source: docs/ARCHITECTURE.md
pixtuoid is local-only and telemetry-free — it makes no network connections,
ships no analytics or "phone home", and reads your agent transcripts read-only to
animate the office. Your session data never leaves your machine. The dependency
set is audited for advisories daily (cargo-deny). For the trust boundaries (the
hook shim, the owner-only socket, and how hook installation edits another tool's
config), see SECURITY.md.
PRs welcome — especially new themes, sprite/decoration polish, and Source adapters for agent CLIs we don't support yet (the nine already wired up are in Supported Tools). See CONTRIBUTING.md for the build/test workflow, conventions, the review process, and how to add a new agent CLI. Architecture and the load-bearing invariants live in CLAUDE.md.
Inspired by pixel-agents (VS Code), clawd-on-desk (desktop pet), and Claude Code's Buddy.
Enjoying the little office? ☕ Buy me a coffee · ⭐ Star the repo
