Skip to content

SpaceO

Give AI agents their own macOS displays. Keep your screen, cursor, and focus.

Install

$git clone https://github.com/ParthJadhav/SpaceO

Install command taken from the project's README or registry entry. Always review code before running it.

Give AI agents their own screen on your Mac.

Let agents work in real apps while you keep using your computer. SpaceO runs agent apps on separate, headless displays.

Get started · How it works · FAQ · Setup guide · Releases · Reference

Recorded from the real SpaceO Viewer using synthetic preview sessions and sample screen content. View the still screenshot.

[!NOTE] Latest release · latest signed SpaceO release. Install it with one command, which verifies the signed, notarized release for you. You can also download the DMG from the Releases page.

Supported scope: native apps and Chromium browsers. Managed Electron apps such as Cursor and VS Code are refused before launch because they can take desktop focus. These editors can still connect to SpaceO as MCP clients to drive supported apps.

A screen for every agent

You keep working Your agents keep working
Your physical display stays available Apps render on headless virtual displays
Your pointer stays where you put it Accessibility actions and targeted events operate apps
You decide when to intervene Viewer shows sessions, activity, pause, and human handoff
Multiple agents can share one Mac Sessions own apps, windows, and display tiles

SpaceO is a native Swift app, a CLI, and an MCP server. Agents can read interface elements, click controls, enter text, inspect screenshots, and check what actually happened. Sessions can use dedicated displays or share a display in separate tiles.

What an agent can do

Capability MCP tools
Own a workspace spaceo_session_create, spaceo_session_destroy, spaceo_session_list, spaceo_pool_status, spaceo_pool_trim
Launch and place apps spaceo_open_app, spaceo_open_url, spaceo_adopt_app, spaceo_place_window, spaceo_list_windows
See the interface spaceo_read_screen, spaceo_find, spaceo_read_text, spaceo_screenshot, spaceo_wait_for
Act on it spaceo_click, spaceo_type, spaceo_press_key, spaceo_scroll, spaceo_drag, spaceo_menu, spaceo_select_text
Batch and verify spaceo_run_steps, spaceo_verify_isolation, spaceo_events
Hand off to you spaceo_session_pause, spaceo_session_resume, per-session clipboard broker

Actions prefer Accessibility elements over coordinates, and every receipt says whether the result was confirmed, unconfirmed, or refused. The reference lists every tool and CLI command.

How it works

flowchart LR
  You["You · keyboard + mouse"] --> Physical["Your physical display"]
  Physical --> Work["Your apps and work"]
  AgentA["Agent A"] --> SessionA["Session A · virtual display"]
  AgentB["Agent B"] --> SessionB["Session B · virtual display / tile"]
  SessionA --> AppA["Browser · research"]
  SessionB --> AppB["Editor · documents"]
  Viewer["SpaceO Viewer"] -. "observe · pause · take control" .-> SessionA
  Viewer -. "observe · pause · take control" .-> SessionB
  style Physical fill:#eaf5ef,stroke:#24845b,color:#163a29
  style SessionA fill:#edf0ff,stroke:#6172cb,color:#25345f
  style SessionB fill:#edf0ff,stroke:#6172cb,color:#25345f

Similar plugs

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Java 面试 & 后端通用面试指南,覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io