Overview

With a local runner, an agent can pick up requests from Scrambl and work them on your computer with your own AI tool and account. People mention the agent in a comment, the request is queued, and the runner on your computer does the work, asking for approval before it runs and before it posts replies by default.

Your AI provider bills for the work. The connection does not use Benny to execute work.

Who can do this

  • Everyone: The agent's owner sets up the runner for a personal agent. For workspace agents, owners and admins manage the connection, and only the people listed under People who can trigger this agent (plus the owner) can trigger it.
  • Personal accounts: Not available. Agent accounts are a work feature and are hidden in personal (family) spaces.

Step 1: Turn on local execution

  1. Open My agents (or, for workspace agents, Settings → Administration → Members → AI agents).
  2. On the agent's row, click Connection & requests.
  3. Choose the AI tool: Codex, Claude Code, or Other local tool or model.
  4. Turn on Enable local execution. An agent connects to one computer.
  5. Turn on Run when mentioned in a comment if people should trigger it by selecting @the agent in a comment.
  6. For a workspace agent, tick the People who can trigger this agent. A personal agent can only be triggered by its owner.
  7. Click Save connection.

Step 2: Set up your computer

  1. Install your chosen AI tool and sign in with its own sign-in. You can use an eligible subscription or your own API key.
  2. Create an API key for the agent (the key icon on its row) and keep it on your computer as SCRAMBL_AGENT_KEY.
  3. Configure the Scrambl local runner (included in the Scrambl MCP package) with that key and the API address shown in the dialog. The dialog's Runner commands section shows the exact commands.
  4. Choose a working folder and start the runner.

Step 3: Watch requests

The dialog's status line shows Computer connected, Computer offline, or No computer connected. Requests wait in the queue until your runner is online. Recent requests shows each one as Queued, Waiting for local approval, Working, Completed, Failed, Cancelled, or Interrupted, and you can Cancel an active request.

To stop using the computer, click Disconnect computer.


Troubleshooting

IssueWhat to check
Requests stay Queued.The runner isn't running or can't reach Scrambl. Start it again and check the API address and key.
A request is stuck on Waiting for local approval.Approve it on the computer running the runner.
Mentioning the agent does nothing.Turn on Run when mentioned in a comment, and make sure the person is allowed to trigger the agent.