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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.