1. Install once per machine
Run the installer and approve the normal sudo prompt. It finishes with Installed agent-sudo 1.0.3.
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.
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.
Run the installer and approve the normal sudo prompt. It finishes with Installed agent-sudo 1.0.3.
agent-sudo agent 10 grants the existing non-root account agent root access for 10 minutes. Choose from 1 to 1,440 minutes.
Send the handoff line privately to the intended agent, replacing TOKEN with its access token:
see: https://simple-help.com/tools/agent-sudo | TOKENList 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.
Only grant access to an account and agent you trust. A grant lets it run any command as root.
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 | shThe 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.
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.
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.
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.
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.
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.
Ubuntu 24.04 and 26.04 on amd64 with systemd, using the documented local sudo policies. Other platforms are untested.
Yes. agent-sudo is Apache licensed and free for commercial use, and the matching source is published with each release.
No. agent-sudo is a standalone tool and does not need a SimpleHelp server or licence.
Give a trusted AI coding agent temporary root access on Ubuntu without sharing an admin password. Grant, check and revoke tokens with agent-sudo.
Read guideUse VMRelay and agent-sudo to run trusted AI agents in disposable Ubuntu VMs. Keep root grants in the guest and review network access, data and cleanup.
Read guideCreate, import and run KVM virtual machines on a remote Ubuntu or Debian host from a terminal app, over SSH.
ExploreUse AI for IT operations without sending data to a cloud you do not choose. Cyana works with on-premise models and the provider of your choice.
ExploreManage your fleet in plain language with Cyana, the AI for SimpleHelp RMM, with technician review and your choice of AI model.
ExploreCyana 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