Free tools

agent-sudo: Temporary Root Access for Trusted AI Agents

Apache licensed and free for commercial use.

Give a trusted AI agent or automation account time-limited root access on an Ubuntu machine, without sharing your administrator password or leaving a permanent passwordless sudo rule in place. Grant access for a few minutes, and revoke it whenever you like.

Stop choosing between babysitting and NOPASSWD

Coding agents and automation often need to install a package, restart a service or edit a system file. The usual options are awkward: type your password at every prompt, share the password, or add NOPASSWD: ALL to sudoers and hope you remember to remove it.

agent-sudo gives one existing account a short-lived token instead. You authenticate with sudo as normal, and agent-sudo never sees or saves your password. When the time runs out, or you revoke the grant, the token stops working.

How it works

1. Install once per machine

Run the installer and approve the normal sudo prompt. It finishes with Installed agent-sudo 1.0.3.

2. Grant access

agent-sudo agent 10 grants the existing non-root account agent root access for 10 minutes. Choose from 1 to 1,440 minutes.

3. Paste the line to your agent

Send the handoff line privately to the intended agent, replacing TOKEN with its access token:

see: https://simple-help.com/tools/agent-sudo | TOKEN

4. Check and revoke

List grants with agent-sudo admin list, revoke one with agent-sudo admin revoke GRANT-ID, or revoke every grant you issued with agent-sudo revoke all.

This is full root access

Only grant access to an account and agent you trust. A grant lets it run any command as root.

  • Expiry, revocation and reboot stop new commands. Root processes already started can outlive expiry and could set up persistent access.
  • Tokens only work for the granted account, on that machine, until the next reboot.
  • Processes sharing the granted account are not strongly isolated from each other.
  • Keep tokens out of shared or recorded terminals, logs, command arguments and environment variables. A lost token cannot be recovered: revoke it and grant again.

Install agent-sudo

agent-sudo 1.0.3 supports Ubuntu 24.04 and 26.04 on amd64 with systemd, using the documented local sudo policies. Run this in a terminal:

curl -fsSL https://tools.simplehelp.io/agent-sudo/install.sh | sh

The installer checks a pinned package checksum, which detects corrupted or mismatched downloads. It is not a signature and does not protect against a compromised download site. If you prefer to review first, download the package and source below.

To upgrade, run the install command again. Upgrading invalidates all existing grants, so issue fresh ones afterwards. To remove agent-sudo, run sudo /usr/local/libexec/agent-sudo-helper uninstall. Keep a separate administrator session open while upgrading or removing.

For agents with a token

An agent runs a root command with agent-sudo run -- /usr/bin/id </dev/null and enters its token at the hidden prompt. Automated launchers can pass the token on an open file descriptor with --key-fd instead. There is no terminal emulation, so editors and other full-screen programs will not work.

Receive the token privately from your administrator. You do not need the administrator password. Executable paths must be absolute. Redirect command input as needed; the hidden token prompt uses /dev/tty. Keep the token out of command arguments, environment variables and logs.

Use agent-sudo status to check access, agent-sudo revoke GRANT-ID to give up a particular grant, or agent-sudo revoke --all to give up all grants issued to your account. Run agent-sudo --help for the terminal guide. Expiry and revocation stop new commands; root processes already running can continue.

Downloads and testing

Release 1.0.3, 4 November 2026. Apache licensed and free for commercial use.

Release 1.0.3 was tested with its installed production binaries in disposable virtual machines: Ubuntu 24.04.5 with sudo 1.9.15p5, and Ubuntu 26.04.1 with sudo-rs 0.2.13. It passed 230 installed-VM checks and 38 public installation checks.

There has been no independent security audit. Other platforms and exhaustive power-loss recovery are untested.

Your questions, answered

Does agent-sudo see my password?

No. You authenticate with sudo as normal when you grant access, and agent-sudo never sees or saves your password. The agent receives a separate, time-limited token.

How long can a grant last?

From 1 to 1,440 minutes. Grants also end at the next reboot and do not renew. Expiry stops new commands, but root processes that are already running can continue.

Can I revoke access early?

Yes. Revoke a single grant, or every grant you issued, at any time. Other administrators' grants stay valid. Revocation blocks new commands; work already running can continue.

Which systems does agent-sudo support?

Ubuntu 24.04 and 26.04 on amd64 with systemd, using the documented local sudo policies. Other platforms are untested.

Is agent-sudo free?

Yes. agent-sudo is Apache licensed and free for commercial use, and the matching source is published with each release.

Do I need SimpleHelp to use agent-sudo?

No. agent-sudo is a standalone tool and does not need a SimpleHelp server or licence.

AI that works for your team, under your control

Cyana brings AI fleet management to SimpleHelp, with technician review, an audit trail and your choice of AI model. Try SimpleHelp free for 30 days.

Start Free Trial