pixtuoid
Health Gecti
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 491 GitHub stars
Code Gecti
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Terminal pixel-art office for AI coding agents
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 (Linux, macOS, or WSL2):
brew install pixtuoid
npm (any OS):
npm install -g pixtuoid
Then:
- Run
pixtuoid. - Press s and connect your agent CLI — pixtuoid wires up the integration, no separate install step;
pixtuoid doctordiagnoses a broken one. - Start that agent in another terminal — a coworker walks in from the elevator within a second.
Tab agent dashboard · t themes · m sound · click a coworker to bring its terminal to the front · ? every other key
More ways to install — Cargo, prebuilt binaries, and Debian packages (.deb) — are on the install guide ↗.
Features
| Feature | Description | |
|---|---|---|
| Multi-agent office | Every agent session gets its own desk — when a floor fills up, a new floor opens automatically | |
| 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 | Coworkers type, wait with a ?, sleep under little z's, and walk A*-routed paths between desks |
|
| Team palette | Shirt and pants take their colors from the working directory — same repo, same colors, so the room reads like an org chart. Hair and skin vary per agent; 16 curated outfits | |
| Per-tool monitor glow | Each desk's monitor glows with the tool in use — Edit blue, Bash orange, Read cyan — so you can read the whole room at a glance | |
| Token meter | Paper stacks up on a desk as its session burns tokens — the pile climbs through 250K / 2M / 16M tiers, a big spend drops a fresh sheet, and hovering shows the exact total (Σ) | |
| Agent tree dashboard | Tab opens a collapsible tree of every floor's agents — each badged with the CLI it runs, color-tinted by what it's doing, with tool-call counts | |
| 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 | |
| Office vibes | The sun and moon cross the skyline as the day goes by, weather rolls past the windows — rain, storm, snow, fog, overcast, windy, smog — and each theme gives the office a whole new look | |
| Lofi soundtrack | A lofi soundtrack synthesized entirely in code — no audio files shipped. Day and night tracks follow the office's clock and weather, typing sounds swell with activity, and the door chime, printer and vending machine play as coworkers come and go. m mutes, +/- volume |
|
| Floating desktop window | pixtuoid floating opens the office in a frameless, always-on-top window — on your desktop, not just in your terminal |
▶ See every feature live — floors, themes, weather, pets, the office tour →
Supported Tools
| Claude Code | Codex CLI |
| Antigravity CLI | DeepSeek-Reasonix |
| CodeWhale | Copilot CLI |
| opencode | Cursor CLI |
| Hermes Agent | Oh My Pi |
| OpenClaw | Grok Build |
| Kimi Code CLI | DeepSeek Harness |
Windows support is experimental — limited testing, unsigned binaries.
Configuration
Everything lives in ~/.config/pixtuoid/config.toml (created on first launch;
every key optional) — theme, desk cap and custom pet names. 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 the built-in palettes; your pick persists across sessions.
See docs/CONFIGURATION.md for the full key reference
(defaults, system-managed keys) and logging / troubleshooting (diagnostics go to ~/.cache/pixtuoid/logs/) — or browse it live
at /config.
How It Works
Agent CLIs emit events two ways — a hook shim (a bounded 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, with 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 (every CLI already wired up is 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 AGENTS.md.
Inspired by pixel-agents (VS Code), clawd-on-desk (desktop pet) and Claude Code's Buddy · MIT licensed
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi
