by IvanWng97
Terminal pixel-art office for AI coding agents
# Add to your Claude Code skills
git clone https://github.com/IvanWng97/pixtuoidLast scanned: 6/6/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-06-06T06:52:37.071Z",
"npmAuditRan": true,
"pipAuditRan": true
}pixtuoid is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by IvanWng97. Terminal pixel-art office for AI coding agents. It has 356 GitHub stars.
Yes. pixtuoid passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/IvanWng97/pixtuoid" and add it to your Claude Code skills directory (see the Installation section above).
pixtuoid is primarily written in Rust. It is open-source under IvanWng97 on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh pixtuoid against similar tools.
No comments yet. Be the first to share your thoughts!
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/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 an agent to bring its terminal to the front (f in the dashboard)
More ways to install — Cargo, prebuilt binaries, and Debian .debs — are on the install guide ↗.
| 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 |
| 🦞 | OpenClaw gateway mascot | A live OpenClaw gateway shows up as a wandering lobster whose motion tracks gateway health |
| 🎛️ | Vibing | A sun and moon arc the skyline as the day turns, weather rolls past the windows (rain, storm, snow, fog, overcast, windy, smog), and six themes reskin the office |
| 🐾 | 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 |
| 🗂️ | Agent tree dashboard | Tab opens a foldable tree of every floor's agents — badged by CLI, with activity tints and tool-call counts |
| 🧭 | Office spaces | Cubicles, a meeting lounge, and a pantry — the office is laid out in distinct furnished zones, not just a grid of identical desks |
| Animated characters | Typing, waiting (?), sleeping (z's), walking with A*-routed pathfinding |
|
| Team palette | Shirt + pants colored by working directory (same repo → same color, a glanceable org-chart); hair/skin per agent. 16 curated outfits | |
| Per-tool monitor glow | Edit = blue, Bash = orange, Read = cyan — scannable at a glance | |
| 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 | |
| Hook-safe | The shim always exits 0 — a stuck visualizer can never block your agent |
| 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, Hermes Agent, Oh My Pi, 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.
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.
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
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 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.
Inspired by pixel-agents (VS Code), clawd-on-desk (desktop pet), and Claude Code's Buddy.