Approvals
Sidemesh collects pending actions from providers into a single Approvals inbox. This lets you review and approve or reject agent actions without watching the chat scroll.
Approval types
Section titled “Approval types”| Type | What the agent wants | Your options |
|---|---|---|
| Command | Run a shell command | Approve once, approve always, or reject |
| File change | Edit, create, or delete a file | View diff, approve, or reject |
| Permissions | Access a tool or scope | Approve or reject |
How approvals work
Section titled “How approvals work”- The agent proposes an action during a turn
- The provider emits an
action_openedevent - The app surfaces the action in the chat and the approvals tab
- You respond via
POST /api/actions/:id/respond - The provider continues or aborts based on your response
Provider differences
Section titled “Provider differences”- Codex: Full approval support with granular always/once/reject options
- Pi: Does not expose gating; approvals are not available
- Copilot: Supports permission requests via the Copilot SDK
- Fake: Deterministic approval triggers for testing (
approval:command,approval:file,approval:permissions)
Skipping approvals
Section titled “Skipping approvals”You can configure auto-approval for specific action types in the provider’s native config. Sidemesh still shows the action in the chat stream, but it does not block the turn.