Action documentation

API

The Action agent WebSocket protocol over authenticated private action.sock

Updated Edit on GitHub →

The Action agent is a local WebSocket server inside Action.app. This page documents its raw RPC protocol. Most agents use the Action MCP server instead (see Agent setup). The MCP server adds sessions, target resolution, recording status, stage, and private layers on top of this protocol.

Source of truth: ActionAgentProtocol.swift and ActionAgentRuntime.swift.