Agent Screen

Give each AI agent its own Mac screen.

Claude Code or Codex opens apps, clicks and types on a virtual display, while your cursor, keyboard and windows stay yours.

Install with Homebrew Download the DMG

A macOS menu bar app for macOS 15 or later. MIT licensed.

Sign-up form in Chrome
Budget in Numbers
Release notes in Pages
NotesFileEdit 9:41
Your notes

Reply to Sam, lunch at 1pm works for me.

Your display
Three of the twelve scripted sessions in the repo's fleet test, sped up 8×. Each runs on its own display while the one in the middle stays yours.

Keep working while the agent works

Built-in computer use drives your real mouse and keyboard, so you stop working while the agent works. Agent Screen moves the agent onto a display of its own.

You watch it from the menu bar, step in when it asks, and hand the screen back with one click.

Claude Code writes in TextEdit on its own display while the user types in their own notes. It asks for a check, the user takes over, adds a line and lets it continue. A scripted replay that makes the same calls the MCP tools make.

What you get

Compared with built-in computer use and a virtual machine

QuestionAgent ScreenBuilt-in computer useA virtual machine
You keep your mouse and keyboardYesNoYes
Works with your real apps and loginsYesYesNo, set them up again
Several agents at onceYes, one display eachNoOne VM each
Watch and step inMenu bar, one clickWatch your own screenVM window

Install

  1. Install with Homebrew

    It needs macOS 15 or later.

    brew tap fanzzzd/agent-screen
brew trust fanzzzd/agent-screen
brew install --cask agent-screen

    Homebrew loads casks from a tap outside its own only once you trust it, which brew trust does.

    Or download the DMG from the latest release and drag Agent Screen into Applications. Agent Screen is signed with a Developer ID and notarized by Apple, so it opens like any downloaded app.

  2. Open Agent Screen

    The setup window asks for Screen & System Audio Recording and Accessibility. Both stay on this Mac.

  3. Connect your agents

    Press Connect… in the setup window, or right-click the menu bar icon and choose Connect Claude Code and Codex, or run:

    "/Applications/Agent Screen.app/Contents/MacOS/AgentScreen" mcp install

    This registers the MCP server with Claude Code for all projects and adds it to ~/.codex/config.toml. For any other MCP client, add a stdio server with the command /Applications/Agent Screen.app/Contents/MacOS/AgentScreen and the argument mcp.

Then start a new session and ask your agent something like:

Use Agent Screen to open Calculator on your own display and work out 12 × 34.

Privacy and limits

Agent Screen runs on your Mac and sends nothing anywhere. Agents reach it through a socket only your user account can open, and a session can only see and drive its own display.

  • It uses private macOS APIs, so it can't be in the App Store, and a future macOS may break it.
  • Copy, paste and undo shortcuts do nothing in an app on an agent's display. Agents copy and paste through the accessibility tree instead.
  • Canvas apps and games that filter per-process events may ignore forwarded input.
  • The README lists every known limit.