Skip to main content

agentsitter.ai

A baby sitter for your ai agents.

Agent Sitter is a layer 7 proxy [sitter] and an approval engine [app].

The sitter intercepts and monitors your AI agent's http / https traffic and detects risky / suspicious activity. When the sitter detects a risky action, it redirects your agent to a waiting page and submits the approval to a human via the app.

To install and configure agent sitter use the sittr cli.

Any AI agent with access to the web can be babysat by agentsitter. This repo focuses on browser-use agents but more examples will be added soon.

System Requirements

Linux / OSX - for windows support see / vote for this issue

Getting started

Examples

Local browser-use

run the interactive initialization:

uvx sittr init

or

pipx sittr init

select local, install certs, start the tunnel, and set up your token.

Note: docker setup is not currently supporeted for osx

uvx sittr init
Initialize for which environment? [local/docker] [local]: local
Fetch & install CA certificate? [y/N]: y
Fetched CA certificate to /home/tato/Desktop/agent-sitter/ca-cert.pem
Imported CA into NSS DB for Firefox/Chromium
Start the local stunnel? [y/N]: y
Error response from daemon: network agent-sitter-net not found
No Docker bridge bind (network not found).
Stunnel started.
Open the dashboard in your browser? [y/N]: n
Skipped: Open the dashboard in your browser
Open the token URL? [y/N]: y
Obtain your API token at: https://www.agentsitter.ai/token/new
Paste your AgentSitter API token: ghu_...
AGENTSITTER_TOKEN set in current session
Added AGENTSITTER_TOKEN to ~/.bashrc
to set env var run:
export AGENTSITTER_TOKEN="ghu_..."

Remember to set up your env var or start a new shell before moving on to the next step.

sittr status should show the certs installed, tunnel started, and token setup, run:

uvx sittr status

or

pipx sittr status
$ uvx sittr status
Tunel started: ✅
CA certificate trusted: ✅
Docker network 'agent-sitter-net' exists: ❌
API token configured in bashrc: ✅

Then you're ready to run browser-use:

clone the repo or download the example script:

git clone git@github.com:phact/agent-sitter

and run:

uvx --with browser_use python browser-use.py

Your agent will begin to browse the web, when a request hits the filter your approval will appear in the app at agentsitter.ai

The app will prompt you to allow notifications. We will only notify you when an agent's actions trigger the sitter filter.

Sitter Filter

Currently the filter simply flags any POST requests. Stay tuned for filtering customizations.

Next steps:

[x] - browser-use local example [ ] - enhanced filtering support [ ] - browser-use docker example [ ] - openai cua example [ ] - anthropic computer-use example [ ] - sitter local mode [ ] - docker / container / cua? improvements for osx

Metadata

Release files for sittr 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sittr 0.1.2
File Size Uploaded Provenance Actions
sittr-0.1.2.tar.gz 9.4 kB Without provenance Details for sittr-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sittr 0.1.2
File Interpreter ABI Platform Actions
sittr-0.1.2-py3-none-any.whl Python 3 none any Details for sittr-0.1.2-py3-none-any.whl

Total release size: 16.4 kB

Release files / sittr-0.1.2.tar.gz

Download URL sittr-0.1.2.tar.gz
Size 9.4 kB
Tags Source
SHA-256 checksum
How to use checksums
8ed2efc650908600563eb3c0fa5073ec97e949785b6f7d548ecbf3742882c604
BLAKE2b-256 checksum
How to use checksums
de4bdd86c809c26317b8891d7b73d33fa78c06f3bfa69f26f28846f911b085df
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.7.3

Release files / sittr-0.1.2-py3-none-any.whl

Download URL sittr-0.1.2-py3-none-any.whl
Size 7.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cc364025e09dedcfd08600b1ad74a808f7c12a28438a2050bdd3d04c9326c30a
BLAKE2b-256 checksum
How to use checksums
9537cb82da40463f68edfcad8d7467bdcde564da4f8e49328dd5bf18c7ef62f3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.7.3

Security for sittr 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page