{"id":29843283,"url":"https://github.com/phact/agentsitter","last_synced_at":"2026-04-19T15:01:42.374Z","repository":{"id":298645234,"uuid":"1000632950","full_name":"phact/agentsitter","owner":"phact","description":"A babysitter for your AI agents","archived":false,"fork":false,"pushed_at":"2025-07-04T03:59:19.000Z","size":27,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-29T16:38:15.633Z","etag":null,"topics":["agents","ai","browser-use","computer-use"],"latest_commit_sha":null,"homepage":"https://www.agentsitter.ai","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phact.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-12T05:02:12.000Z","updated_at":"2025-07-04T03:59:22.000Z","dependencies_parsed_at":"2025-06-12T06:21:35.669Z","dependency_job_id":"639866c9-f959-41ac-9ae2-5ba04bd16f22","html_url":"https://github.com/phact/agentsitter","commit_stats":null,"previous_names":["phact/agentsitter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/phact/agentsitter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phact%2Fagentsitter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phact%2Fagentsitter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phact%2Fagentsitter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phact%2Fagentsitter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phact","download_url":"https://codeload.github.com/phact/agentsitter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phact%2Fagentsitter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32010957,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","ai","browser-use","computer-use"],"created_at":"2025-07-29T15:42:30.816Z","updated_at":"2026-04-19T15:01:42.353Z","avatar_url":"https://github.com/phact.png","language":"Python","readme":"## agentsitter.ai\n[![Discord chat](https://img.shields.io/static/v1?label=Chat%20on\u0026message=Discord\u0026color=blue\u0026logo=Discord\u0026style=flat-square)](https://discord.gg/2Jg6P2tY5X)\n[![PyPI](https://img.shields.io/pypi/dm/sittr)](https://badge.fury.io/py/sittr)\n\n`A baby sitter for your ai agents.`\n\nAgent Sitter is a layer 7 proxy [sitter] and an approval engine [app]. \n\nThe `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`.\n\nTo install and configure agent sitter use the `sittr` cli.\n\nAny 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.\n\n## System Requirements\n\nLinux / OSX\n\nFor windows support see / vote for [this issue](https://github.com/phact/agentsitter/issues/1)\n\n\n## Getting started\n\n### Examples\n\n#### Local `browser-use`\n\nrun the interactive initialization:\n\n    uvx sittr init\n\nor\n\n    pipx sittr init\n\n\nselect local, install certs, start the tunnel, and set up your token.\n\nNote: docker setup is not currently supporeted for osx\n\n```\nuvx sittr init\nInitialize for which environment? [local/docker] [local]: local\nFetch \u0026 install CA certificate? [y/N]: y\nFetched CA certificate to /home/tato/Desktop/agent-sitter/ca-cert.pem\nImported CA into NSS DB for Firefox/Chromium\nStart the local stunnel? [y/N]: y\nError response from daemon: network agent-sitter-net not found\nNo Docker bridge bind (network not found).\nStunnel started.\nOpen the dashboard in your browser? [y/N]: n\nSkipped: Open the dashboard in your browser\nOpen the token URL? [y/N]: y\nObtain your API token at: https://www.agentsitter.ai/token/new\nPaste your AgentSitter API token: ghu_...\nAGENTSITTER_TOKEN set in current session\nAdded AGENTSITTER_TOKEN to ~/.bashrc\nto set env var run:\nexport AGENTSITTER_TOKEN=\"ghu_...\"\n```\n\nRemember to set up your env var or start a new shell before moving on to the next step.\n\n`sittr status` should show the certs installed, tunnel started, and token setup, run:\n\n    uvx sittr status\n\nor\n\n    pipx sittr status\n\n\n```\n$ uvx sittr status\nTunel started: ✅\nCA certificate trusted: ✅\nDocker network 'agent-sitter-net' exists: ❌\nAPI token configured in bashrc: ✅\n```\n\nThen you're ready to run browser-use: \n\nclone the repo or download the example script:\n\n    git clone git@github.com:phact/agent-sitter\n\nand run:\n\n    uvx --with browser_use python browser-use.py\n\nYour 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)\n\nThe `app` will prompt you to allow notifications. We will only notify you when an agent's actions trigger the `sitter` filter.\n\n### Sitter Filter\n\nCurrently the filter simply flags any POST requests. Stay tuned for filtering customizations.\n\n### Next steps:\n\n[x] - `browser-use` local example\n\n[ ] - enhanced filtering support\n\n[ ] - `browser-use` docker example\n\n[ ] - openai `cua` example\n\n[ ] - anthropic `computer-use` example\n\n[ ] - `sitter` local mode\n\n[ ] - docker / container / cua? improvements for osx\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphact%2Fagentsitter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphact%2Fagentsitter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphact%2Fagentsitter/lists"}