v0.1.21

agents-office

Real-time observability dashboard for AI coding agent sessions. Each running Claude Code, OpenCode, or Antigravity session shows up as an animated agent in a web-based office.

GitHub npm License

Architecture

Quick start

Server — one-command (Ubuntu/Debian)

curl -fsSL https://raw.githubusercontent.com/lessch4os/agents-office/main/scripts/install-server.sh | bash

Downloads the prebuilt binary, sets up systemd service. No Bun needed.

macOS — Homebrew

brew tap lessch4os/agents-office
brew install agents-office
brew services start agents-office

Any platform — npm (requires Bun)

npm install -g @lessch4os/agents-office
agents-office --port 8080

Pre-built binary (download from GitHub Releases)

curl -L https://github.com/lessch4os/agents-office/releases/download/v0.1.21/agents-office-linux-x64 -o agents-office
chmod +x agents-office
./agents-office --port 8080

Open http://localhost:8080 in your browser.

All platforms — from source

git clone https://github.com/lessch4os/agents-office
cd agents-office
bun install
bun run build:local
./daemon/agents-office --port 8080

Upgrading

Method	Upgrade command
Server (systemd)	`curl -fsSL ...install-server.sh \| bash`
Homebrew	`brew upgrade agents-office && brew services restart agents-office`
npm	`npm update -g @lessch4os/agents-office`

Commands

Command	Description
agents-office	Start the daemon
agents-office doctor	Run diagnostics (binary versions, socket, hooks, DB, logs)
agents-office reload	Gracefully restart CC/OC + daemon (SIGINT + systemctl)
agents-office install	Install CC hooks + OC plugin
agents-office-forwarder	Forward local hooks to remote server
agents-office-hook	Claude Code hook shim (internal)

Features

Multi-source — Claude Code, OpenCode, and Antigravity agents on one dashboard
Real-time — animated agents, live activity feed, token usage tracking
Remote — forwarder relays laptop hooks to a server; view from anywhere
Historical — SQLite-backed session persistence with search and filters
Model pricing — cost tracking per session with context window monitoring
Subagent tree — parent-child session visualization for task hierarchies

Supported sources

Claude Code — via hook shim + JSONL watcher
OpenCode — via plugin or native SSE watcher
Antigravity — via JSONL brain file watcher

Installation methods

Method	Runtime dependency
Prebuilt binary	None (standalone ELF/Mach-O)
Homebrew	None (compiled binary bottle)
npm	Bun `curl -fsSL https://bun.sh/install \| bash`
Debian package	None (.deb on GitHub Releases)