Agent Room Server — Development skill for Claude Code

AgentRoom server and macOS app

[](https://github.com/ethics-of-ai/agent-room-server/actions/workflows/ci.yml)

AgentRoom runs coding-agent sessions on a Mac and exposes them to clients over REST and WebSocket. The backend registers local folders as workspaces, starts Codex, Claude Code, DeepSeek Harness, Cursor, or an external ACP agent inside them, owns session state, and streams typed events. The macOS app is the operator console: it configures runners, keeps secrets in Keychain, registers workspaces, starts and supervises the backend, and shows diagnostics.

This repository holds the backend, the macOS app, and the Swift client library the Apple apps compile. It does not hold the visionOS app. That app is the main session client (threads, editor, source control, spatial diagrams) and is not open source yet. The Mac app's Threads view supervises sessions and can stop a turn, but it does not send prompts. With this repository alone you run the backend and drive turns through its API with `curl` or a client of your own; [Local Mac server](docs/operations/LOCAL_MAC_SERVER.md) walks through that.

flowchart TB
    client["your client"]

    subgraph mac["the operator's Mac"]
        operator["macOS operator app"]
        backend["Fastify backend"]
        workspaces["registered local workspaces"]
        agents["Codex, Claude Code, DeepSeek, Cursor, or ACP agent"]

        operator -->|launches, supervises, REST| backend
        backend -->|registers| workspaces
        backend -->|starts inside a workspace| agents
    end

    client -->|REST + WebSocket| backend

What is here

Path	Contents
apps/backend	Fastify API, workspace registry, sessions and turns, runner adapters, events, audit, file access, Git operations, terminal sessions, spatial document composition
apps/macos	SwiftUI operator app: backend supervision, runner