Skip to the content

Install without administrator rights

Install AgentGarm as yourself from the tarball, and what that gives up.

From the tarball

Unpack the .tar.gz for your platform into a directory that will stay where it is (the services run from it), put its bin on your PATH, then install the user services and the default policy, in audit mode:

mkdir -p ~/.local/opt && tar -xzf agentgarm-X.Y.Z-<target>.tar.gz -C ~/.local/opt
export PATH="$HOME/.local/opt/agentgarm-X.Y.Z-<target>/bin:$PATH"   # and in your shell profile
agentgarm install --user
agentgarm doctor

What you give up

Without root, everything runs as you, so an agent could interfere with AgentGarm. It still records and decides, but the session is rated lower and agentgarm install --user prints the level that applies. Approvals are not hardware-backed. Agents whose hooks live in system files, such as Claude Code and Codex, get no hooks, so they are governed only when you start them with agentgarm run.

Next

Upgrade

Verify the new release's tarball, unpack it into its own directory, point your PATH at its bin, and run agentgarm install --user from it, which rewrites the user services to run the new programs; then restart them, since a running service keeps the old programs until it restarts. Your policies, the audit log and the store carry over.

tar -xzf agentgarm-X.Y.Z-<target>.tar.gz -C ~/.local/opt
export PATH="$HOME/.local/opt/agentgarm-X.Y.Z-<target>/bin:$PATH"   # and in your shell profile
agentgarm install --user
systemctl --user restart agentgarmd agentgarm-session   # Linux
launchctl kickstart -k gui/$(id -u)/com.agentgarm.agentgarmd   # macOS
launchctl kickstart -k gui/$(id -u)/com.agentgarm.session      # macOS
agentgarm doctor

Remove it

agentgarm uninstall --user

It removes the hooks and services it installed, and keeps your policies, the audit log and state. Then delete the unpacked directory.