Skip to content

How approvals protect you

An agent can run commands and edit files on your computer. Approvals are the check between what it wants and what it does.

In Regular mode the agent stops before an action that needs approval and waits. The card shows the exact command or file. Nothing runs until you choose Approve.

Risky actions carry a label: Destructive command, Network access, Writes outside workspace, Secret file, Package install, Git push, Publish, Changes what commands run or Changes remotxai control. Read those first.

  • Approve covers one action.
  • Approve similar covers the same kind of action in one workspace, and the card shows the rule it adds.
  • Approve all similar covers one tool for the rest of the session.

Start with the narrowest one. Wide approvals are convenient, and they approve actions you have not seen yet. Clear standing approvals in the session menu removes every remembered rule.

Your computer checks each approval. A phone paired as Viewer cannot answer one. A phone paired as Approver, Driver or Admin can. Pair each phone with the smallest role it needs.

The computer refuses to show or send files that hold credentials, such as the settings folders of your agent programs, ~/.remotxai, the GitHub CLI settings, keychains and browser profiles. An approval does not change that.

An agent runs as you, so it can run the remotxai command too. When a command that changes who controls the computer comes from a process an agent started, the computer does not run it. That covers pairing a phone, changing a device’s role, revoking a device, adding or editing standing approvals, trusting another computer, adding or removing an MCP server that runs a program (remotxai mcp add-stdio, mcp rm), and storing or removing a secret (remotxai secrets set, secrets rm). A secret’s card shows its name and where it goes, never its value. A card appears in that agent’s session instead, and the command runs only if a phone paired as Admin approves it there, within 10 minutes. The agent’s terminal shows that the command waits for a person, and the command keeps waiting for the answer. If the card is approved, the command runs. For remotxai tracker connect, remotxai tracker role, remotxai mcp and remotxai secrets its usual output appears in the agent’s terminal, and the card says so. Any other command tells the agent only whether it ran. If it is denied or nobody answers in time, the command fails and nothing runs. Running the same command again from the same session while the card is open waits on that card and opens no second one. Run the same command in your own terminal and it works as before. The card has no Tweak, so what runs is what you read. A command with no terminal of its own, such as one started by launchctl or by ssh without -t, is refused: run it in a terminal window.

A command the agent wants to run that uses remotxai or the ~/.remotxai folder carries the Changes remotxai control label. A standing approval never covers it, and you can’t approve it by voice.

Yolo mode approves everything without asking. No one reads what the agent does. What Yolo means.

Panic stop interrupts every session on a computer, cancels the sub-agents and switches off Yolo and remembered approvals. Press and hold it for 1.5 seconds.

A phone you pair only connects after you type its verification code at the computer. A device with no pairing and no organisation access to the computer cannot send an approval.