https://github.com/phact/agentsitter
A babysitter for your AI agents
https://github.com/phact/agentsitter
agents ai browser-use computer-use
Last synced: 7 months ago
JSON representation
A babysitter for your AI agents
- Host: GitHub
- URL: https://github.com/phact/agentsitter
- Owner: phact
- Created: 2025-06-12T05:02:12.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-07-04T03:59:19.000Z (7 months ago)
- Last Synced: 2025-07-04T04:35:21.052Z (7 months ago)
- Topics: agents, ai, browser-use, computer-use
- Language: Python
- Homepage: https://www.agentsitter.ai
- Size: 14.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## agentsitter.ai
[](https://discord.gg/2Jg6P2tY5X)
[](https://badge.fury.io/py/sittr)
`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](https://github.com/browser-use/browser-use/) agents but more examples will be added soon.
## System Requirements
Linux / OSX
For windows support see / vote for [this issue](https://github.com/phact/agentsitter/issues/1)
## 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](https://www.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