ROOAGI · AGENT SUPERVISOR

Control every tool process your application starts.

Bound its output. Cancel it. Clean up its child processes. Record how it finished. Agent Supervisor brings those process responsibilities into one Rust library, so your application does not have to rebuild them around subprocess APIs.

Get started Explore on GitHub
OPEN SOURCERUSTAPACHE 2.0
EXECUTION FLOW01 — 04
01
YOUR RUNTIMEAuthorization
✓
explicit request
02
AGENT SUPERVISORPolicy + supervision
●
TIMEOUTPUTFILESYSTEMRESOURCES
bounded process
03
CHILD PROCESSTool, MCP server, pipeline
↗
SUPERVISEDbound → cancel → clean up → record
Rust core + Python APIone-shot execution and streaming
Native · OpenShell previewlocal execution and adapter experiments
Explicit policyno inferred authority
Structured outcomeswith lifecycle records

CONTROL THE EXECUTION

Own the process lifecycle.
Keep authority with your application.

Subprocess APIs start a process; your application still has to manage its output, cancellation, descendants, and final status. Agent Supervisor gives those jobs a shared API. Your runtime keeps credentials, identity, and authorization.

01 / BOUND

Keep output within limits

Set stdout, stderr, input, and deadline limits on an execution request, so a noisy or stuck tool cannot consume unbounded application resources.

Build an execution request
02 / CANCEL

Stop work and its descendants

Cancel natively supervised work and manage process groups through graceful shutdown and bounded forced cleanup, within the controls supported by the platform.

Explore supervision
03 / RECORD

Know how it finished

Collect output, termination reason, process identity, and lifecycle events as structured results for the runtime that started the work.

Understand the API boundary

A CLEAR CONTRACT

From authorized request to recorded outcome.

Your application chooses what may run. Agent Supervisor applies the requested process controls, supervises the lifecycle, and returns the outcome. Enforcement varies by platform and capability; the receipt and capability report show what actually happened.

Understand the API boundary
01DeclareExecutable · policy · limits
02LaunchPlatform backend applies controls
03SuperviseEvents · cancellation · cleanup
04RecordOutput · termination · identity

FOR DEVELOPERS BUILDING WITH PROCESSES

Stop rebuilding subprocess supervision in every application.

When a tool times out but its child keeps running, or an MCP server needs an orderly shutdown, custom wrappers grow quickly. Agent Supervisor puts execution, process groups, lifecycle handling, and outcomes behind one Rust API, with an async Python binding for bounded one-shot commands and output streaming. Choose native execution across Linux, macOS, and Windows, or experiment with a separate OpenShell developer adapter for one-shot commands in an existing managed sandbox.

Read the Python API guide
Read the OpenShell developer adapter contract
01Rust desktop and CLI appsEmbed process control in your application
02Agent frameworksShare execution and cleanup across tool adapters
03MCP server managersHandle startup, readiness, shutdown, and children
04Persistent subprocess workflowsTrack process groups, identity, and lifecycle events

AGENT SUPERVISOR · 0.1.2

Give every tool process a lifecycle.

Start with the Rust or Python guide. Set the limits you need, supervise the work, and inspect its recorded outcome.