pixtuoid

Your AI coding agents, visualized as pixel-art coworkers in a terminal office.

_{pixel + tui + (agent-)oid}

🖥︎ Live demo ↗  ·  Architecture  ·  Configuration  ·  Contributing

Why?

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.

Quick Start

Pick one — Homebrew on macOS, or npm on any OS:

Homebrew (macOS):

brew install IvanWng97/pixtuoid/pixtuoid

npm (any OS):

npm install -g pixtuoid

Then launch:

pixtuoid

Press 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 ↗.

Features

▶ See every feature live — floors, themes, weather, pets, the office tour →

Supported Tools

Also supported: Antigravity CLI, DeepSeek-Reasonix, CodeWhale, Copilot CLI, opencode, Cursor CLI, Hermes Agent, OpenClaw.

→ Full tool × OS support matrix on the site

* experimental — limited testing, unsigned binaries.

Adding a new tool? Implement the Source trait — or, for a hook-only CLI, just a hook decoder + an install Target — then add a row to site/src/sources.json (its supported set is pinned to the code by a test). One file, one channel, done.

Configuration

Everything lives in ~/.config/pixtuoid/config.toml (created on first launch; every key optional) — theme, desk cap, custom pet names, and sprite packs. CLI flags override the file (pixtuoid run --theme dracula).

The setting you'll reach for most is the theme — press t in the TUI for a live-preview picker across six built-in palettes; your pick persists across sessions.

See docs/CONFIGURATION.md for the full key reference (defaults, system-managed keys), the custom sprite-pack workflow, and logging / troubleshooting (diagnostics go to ~/.cache/pixtuoid/log) — or browse it live at /config.

How It Works

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. Five Rust crates, zero terminal deps in the core.

Full architecture with diagrams → · single source: docs/ARCHITECTURE.md

Privacy & Security

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.

Contributing

PRs welcome — especially new themes, sprite/decoration polish, and Source adapters for agent CLIs we don't support yet (the ten 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.

Acknowledgments

Inspired by pixel-agents (VS Code), clawd-on-desk (desktop pet), and Claude Code's Buddy.

License

MIT

Star History

  <img alt="star history chart for IvanWng97/pixtuoid" src="https://api.star-history.com/svg?repos=IvanWng97/pixtuoid&type=Date" width="640" />

_{Enjoying the little office? ☕ Buy me a coffee · ⭐ Star the repo}