> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equa.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Approvals

# `equabot approvals`

Manage exec approvals for the **local host**, **gateway host**, or a **node host**.
By default, commands target the local approvals file on disk. Use `--gateway` to target the gateway, or `--node` to target a specific node.

Related:

* Exec approvals: [Exec approvals](/tools/exec-approvals)
* Nodes: [Nodes](/nodes)

## Common commands

```bash theme={null}
equabot approvals get
equabot approvals get --node <id|name|ip>
equabot approvals get --gateway
```

## Replace approvals from a file

```bash theme={null}
equabot approvals set --file ./exec-approvals.json
equabot approvals set --node <id|name|ip> --file ./exec-approvals.json
equabot approvals set --gateway --file ./exec-approvals.json
```

## Allowlist helpers

```bash theme={null}
equabot approvals allowlist add "~/Projects/**/bin/rg"
equabot approvals allowlist add --agent main --node <id|name|ip> "/usr/bin/uptime"
equabot approvals allowlist add --agent "*" "/usr/bin/uname"

equabot approvals allowlist remove "~/Projects/**/bin/rg"
```

## Notes

* `--node` uses the same resolver as `equabot nodes` (id, name, ip, or id prefix).
* `--agent` defaults to `"*"`, which applies to all agents.
* The node host must advertise `system.execApprovals.get/set` (macOS app or headless node host).
* Approvals files are stored per host at `~/.equabot/exec-approvals.json`.