jefferysha0627/agent-office-3d

Agent Office 3D is a locally hosted, low-poly 3D office that visualizes what coding agents are doing: working, idle, done, or waiting on a permission prompt. It is aimed at people running several AI coding agents on macOS or Linux who want an at-a-glance status view rather than reading terminal tabs. The office is reached through a WebGL-capable browser at a local address after npm start (project README).

What it does

Each configured agent gets a desk with a status lamp and name tag; a red tag and "!" bubble mark the need-confirmation state. Clicking a staff member shows recent terminal output read-only, so the office cannot send keystrokes or approve prompts. Idle agents animate with coffee, a treadmill, or a nap, and the room also holds a bulletin board with to-dos, a bookshelf that reads configured project folders, and a task sidebar (feature overview).

The starting demo mode needs no agent at all: fake statuses rotate so the interface can be evaluated, and the README notes that all screenshots, staff, projects and figures are fictional (project README).

Connecting real agents

Status comes from a source adapter. The built-in option is Herdr, a terminal multiplexer for coding agents; set source.type to herdr and make each staff[].id match the agent name shown by herdr agent list (Herdr mode, Herdr). The office only invokes Herdr's read-only list and read commands through an allowlist. Other tools need a custom adapter in lib/sources.js returning the same shape of name, status and terminal tail. Up to eight staff are given fixed desk assignments; extra agents take remaining seats.

The Minecraft mechanic

Idle agents can be represented by rule-based Mineflayer bots that mine, chop trees and build in a shared world; each bot's first-person view is streamed to that agent's monitor (Minecraft section, Mineflayer). The README states these bots never call an AI model, so this idle activity does not consume tokens. Bots move only while their agent is idle and someone has the office page open, and they stop when the agent resumes work. With Minecraft enabled, game breaks are always Minecraft; real agents choose it about 12% of the time, while demo mode biases idle staff toward it.

The optional path requires Java 21+ and setup downloads a version 1.21.4 server jar from Mojang after verifying its SHA-1. You must read and accept the Minecraft EULA yourself by typing yes; declining means nothing is downloaded (Minecraft EULA). The server binds only to 127.0.0.1 and uses a whitelist. A human Minecraft Java player can join on the same computer at localhost:25570 in spectator mode if their name is added as a guest.

Requirements and caveats

• Node.js 20+ is required; Java 21+ and a Minecraft Java server are optional and only for the game feature. A WebGL browser is needed for the 3D view (requirements).
• macOS and Linux are supported. Windows is labeled experimental: CI runs install, syntax and demo smoke checks, but the author has not validated it on real Windows hardware, and Minecraft on Windows is untested.
• The office reads agents' terminal output, which may contain code, paths or secrets. Keep it local: the README explicitly says not to expose it through a public proxy or tunnel.
• The only write path is ticking a bulletin-board to-do, which updates a local JSON file.
• The repository ships no Mojang files; the server jar, EULA and world saves stay in a local, untracked minecraft/ folder. The project is MIT-licensed, and the README notes that block textures bundled with prismarine-viewer belong to Mojang and are subject to Minecraft terms (license).

HotRepo's take

On 2026-10-30 the project appeared on the NEW-REPOSITORY board for JavaScript with 104 total stars (repository). That is a single dated observation, not evidence of sustained growth or broader adoption.