Skip to the content

How-to guides

Step-by-step guides for governing AI agents with AgentGarm: policy rollout, approvals, secrets, cost and recovery; CI and Central Lite fleets in preview.

The guides are written for macOS and Linux. Windows is a preview, and no guide walks it yet.

61 guides

Getting started

For one machine: bring your agents under AgentGarm, with hooks or without, start a policy in audit mode, check that protection is on, turn on the macOS sentinels, follow what it denies or asks, run it on Windows, see the local AI runtimes on it and keep it up to date. 6 of its 12 guides are in preview.

  • Guide 1

    Watch your agent for a week, then enforce

    Start a policy in audit mode, see what enforcing it would have blocked in your own history, fix the rules that get in the way, then switch it to enforce.

  • Guide 2

    Govern Claude Code

    Install the Claude Code pack, put AgentGarm's hooks in Claude Code's managed settings, run it through the launcher and proxy, and check what is enforced.

  • Guide 3

    Govern Codex CLI

    Install the Codex pack, add its hooks to Codex's managed requirements.toml on a root install, start Codex through the launcher, and check what is enforced.

  • Guide 4

    Govern Cursor, Copilot CLI, Devin, Cline and otherspreview

    Install your agent's policy pack in audit mode, put AgentGarm's hooks where that agent reads them, and read what its hooks cannot do.

  • Guide 5

    Govern an agent with no hooks

    Run an agent AgentGarm has no hook adapter for inside the same sandbox and proxy, and know which of your policy's rules that leaves unenforced.

  • Guide 6

    Route other model providers through the proxypreview

    Send Gemini, Bedrock, Vertex, Azure, OpenRouter, DeepSeek and local-runtime calls through the proxy, accounted, budgeted and checked for secrets.

  • Guide 7

    Check that protection is on

    See whether AgentGarm's services are up, what assurance level each agent session has and why, and what to do about a bypass alert.

  • Guide 8

    Turn on the macOS sentinelspreview

    Activate AgentGarm's Endpoint Security and Network Extension on a Mac, approve them by MDM or by hand, and check that they hold the agent's processes.

  • Guide 9

    Get told when an agent is denied or askspreview

    Follow each denial, approval ask and alert as it happens: in a terminal, as desktop notifications, or through your own Linux notifier.

  • Guide 10

    Run AgentGarm on Windowspreview

    Install the Windows preview, start agents in its Job Object sandbox, use the tray, know what Windows enforces next to macOS and Linux, and remove it.

  • Guide 11

    See the AI runtimes and desktop AI apps on a machinepreview

    List the local model runtimes and desktop AI apps on a machine, see which ones no governed session used, and route local model calls through the proxy.

  • Guide 12

    Check for and verify AgentGarm updates

    Find the newest AgentGarm release, check its signature and checksums before you run it, never go back to an older one, and upgrade in place.

Writing policy

For whoever writes a machine's policy: which commands, files and hosts an agent may use, Touch ID and Windows approvals, poisoned configs, agent versions, and testing a policy before it ships. Of its 7 guides, 1 is in preview and 4 have preview steps.

Protecting secrets and data

Keep secrets, tokens and your browser profile from the agent and its model provider: prompt redaction, what agents upload to paste sites and webhooks, sealed cloud and MCP credentials, the MCP gateway, prompt injection in MCP tool output, browser agents, computer-use agents and what agents can capture on screen; gateway keys and the signed MCP registry need Central Lite. Of its 11 guides, 10 are in preview and 1 has preview steps.

Cost

For one machine: budget each task, see what each task cost by provider and model, and reconcile the spend with your provider's own reports. Of its 3 guides, 1 is in preview and 1 has preview steps.

Investigating and recovering

On one machine, when you need to know what happened: trace what a task did, undo its changes, find out why an agent stopped, verify and export the audit log, export a task's evidence, send events to your SIEM from each machine or from Central Lite, and write a support bundle. Of its 8 guides, 4 are in preview and 3 have preview steps.

CI, containers and servers

For machines with no one at the keyboard: a server or container whose asks are denied instead of waiting, and a CI job whose risky step you approve from your laptop. Of its 2 guides, 1 is in preview and 1 has preview steps.

Running a fleet with Central Lite

For a Central Lite admin: tour its console in the demo, stand it up, keep its keys in an HSM, deploy machines with MDM, sign in through your identity provider, provision people with SCIM, give roles, enrol machines, roll out policy and outbound inspection, stop one task or agents across the fleet, investigate a task's incident, attribute spend, and manage identities, retention, works-council packs and backups. Every guide here is in preview.