GET STARTED

Three ways in — pick one.

Just two prerequisites: Node.js 22.13+ (source mode only), and at least one of the Claude Code / Codex CLIs installed and signed in.

MACOS

One-line install

A self-contained app with its own runtime — no Node.js or npm needed.

curl -fsSL https://github.com/juinwei7/\
Pixel-Crew/releases/latest/download/\
install-pixel-crew-macos.sh | /bin/bash
WINDOWS

Portable build

Download the zip, unzip, and run — includes a SHA-256 checksum and setup guide.

# After downloading from Releases
install-pixel-crew.cmd
start-pixel-crew.cmd
SOURCE

Run from source

Any platform — this is the path for development and customization.

git clone https://github.com/\
juinwei7/Pixel-Crew.git
cd Pixel-Crew
npm install
npm run dev   # localhost:5173

REQUIREMENTS ─ Node.js 22.13+ (source mode only)・Claude Code or Codex CLI・macOS / Windows 10 22H2+ / Linux

FAQ

Frequently asked questions

How is a department different from assigning a task to one NPC?

Assigning a task directly means a single NPC handles it start to finish. A department has at least two NPCs sharing one workspace, one of them the lead — you just write a goal and acceptance criteria and hand it to the lead, who decides whether to consult an expert, ask for a review, or run a 2-to-5-step task chain, stopping to ask you only when something's actually blocked.

Will a department auto-commit or push my code?

No. Whether it's running Quick Consult, Quick Review, or a full Mission, a department never auto-commits, pushes, merges, tags, or releases, and it never touches your authentication; normal CLI approval prompts still apply.

Is it free? Does it use more of my allowance?

Pixel Crew itself is completely free and MIT-licensed. It never handles billing — you're using your own CLI subscription or account allowance, exactly as if you ran the CLI directly; the usage meters in the top bar help you keep an eye on it.

Which agents are supported?

It currently supports Anthropic's claude (Claude Code) and OpenAI's codex CLI. Both can share one office and hand work back and forth. Installing just one is enough to get started.

Where do my code and conversations go?

Traffic between an agent and its model provider is handled entirely by the official CLI, exactly as it would be if you ran that CLI directly. What Pixel Crew adds — conversation history, NPC settings — lives only in local SQLite; the server only binds to localhost, with no telemetry or cloud sync.

Is auto-approval safe?

It has three levels, set independently per NPC. "Safe" only allows a read-only command allowlist. "Full" still forces a manual confirmation for a blocklist of dangerous commands (rm and friends, disk operations, permission changes, etc). If you're unsure, leave it on the default "off" — every command will ask first.

Can I run a lot of agents at once?

Yes — up to 20 NPCs, and they can be split across different working folders (rooms). The personnel list on the left supports search and filters (running / needs attention / by provider), and the canvas pans and zooms, so it stays easy to navigate even with a full office.

Is Pixel Crew affiliated with Anthropic or OpenAI?

No. Pixel Crew is an independent, unofficial tool, not authorized, endorsed, or sponsored by Anthropic or OpenAI; "Claude," "Codex," and related trademarks belong to their respective owners. What it does is orchestrate and visualize the official CLIs you've installed and signed into yourself.