Turn on the Sandbox
- Open a chat with the Agent in the Chat Window, SmartBar, the Dynamic Island, the App Sidebar, or a Project’s lead chat.
- Click the Permissions chip next to the run mode.
- Turn on Sandbox.
What a sandboxed command can reach
Every program a command starts runs inside the Sandbox too. Enconvo uses macOS’s own sandbox, the one App Store apps use.
When the Sandbox stops a command
When a command tries to reach something the Sandbox keeps from it, macOS refuses, and a line under the step says what was stopped, such as a write to a folder or a read of a key file.- Click the line to see what was stopped and why.
- To let the command do it, click Run outside. The command runs once with your full access, then shows in the chat like any other command. Nothing is remembered.
Why Enconvo asks before a command
The Agent’s Permission mode decides what asks, with or without the Sandbox. See Approve actions.
Enconvo reads each command part by part, so a harmful step hidden inside a quoted, nested, chained, or piped command still asks, and harmless ones, such as an echo or listing a folder, don’t.
Even at Full access, Enconvo asks with Allow once and Deny before a change that could harm your computer, such as deleting a critical folder, editing your shell startup files or SSH keys, or reading saved passwords, however the command spells the path.
With Approve for me, a command the rules can’t judge is checked against what you asked for. When you wouldn’t expect it to run on its own, Enconvo asks you and gives the reason.
Each approval card names the setting that made it ask, such as “Asked because this Project is on Approve for me.”
Other actions that ask
- Computer Use asks before a keyboard shortcut that deletes, sends, pays, quits an app, or signs out, as it does for clicks.
- A command that calls a plugin page’s own routes asks first.
- Approving a plugin’s tool shows what the tool is about to send.
- An Agent asks before it calls or messages your friends and teammates, except at Full access, where it doesn’t ask.
- An Agent can’t answer its own approval cards, raise its own Permissions, or answer a card meant for you, such as a plugin install or the points cap.
Troubleshooting
Related
Agents
Permission modes and approval cards.
Code Runner
How an Agent runs shell commands.
Privacy and Security
Where your data goes and how to control it.
macOS Permissions
The access macOS grants Enconvo itself.