Agent runtime

Tool approvals

When a tool call needs permission, the editor shows an overlay with the requested action and your response choices.

Image ยท 16/10tool-approval-overlay
slot
fill me

What the overlay shows

The overlay turns tool calls into plain language. For known tools it says that AgentsOS wants to read a file, create or overwrite a file, edit a file, or run a command.

For unknown tools, it shows the tool name and primary argument so you can decide whether to allow it.

Responses

  • Allow read, Allow write, Allow edit, or Allow run: approve the specific call.
  • Deny: block the call and let the agent continue with that result.
  • Feedback input: type an alternative instruction, then press Enter to deny with that message.

Interactive questions

Some agent runtimes can ask structured questions. The question overlay supports choice and confirmation prompts, multi-step navigation, Back, Submit, and optional refusal.

Reducing prompts

Use Safe Mode for normal work and Full Permission when you want the native agent to run without approval prompts. For MCP tools, prefer enabling Auto-approve only on the specific trusted server instead of relaxing the whole session.