Skip to content

smchase/tripwire

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tripwire

AI-powered reminder service that checks arbitrary conditions daily using a browser agent. When a condition is confirmed, it sends you an email and stops checking.

Setup

cd ~/tripwire
uv sync
uv run playwright install chromium

Create .env and fill it in:

BROWSER_USE_API_KEY=bu_...       # https://cloud.browser-use.com
GMAIL_ADDRESS=you@gmail.com
GMAIL_APP_PASSWORD=xxxx xxxx xxxx xxxx  # https://myaccount.google.com/apppasswords
EMAIL_TO=you@gmail.com

Usage

Create reminders.json with your conditions:

[
  {
    "condition": "Radiohead has announced a 2026 concert tour",
    "active": true
  }
]

Run manually:

xvfb-run uv run tripwire.py

xvfb-run provides a virtual display since the browser runs in non-headless mode (needed to avoid bot detection by search engines).

Cron

To run daily at 9am:

crontab -e

Add:

0 9 * * * cd ~/tripwire && xvfb-run uv run tripwire.py

Logs

All output goes to tripwire.log.

tail -f tripwire.log

How it works

For each active reminder, a browser-use agent (BU 2.0 model) searches the web to verify the condition. If confirmed, it sends an email and sets active to false in reminders.json. If not confirmed, it tries again next run.

The browser runs with a real user-agent and anti-detection settings so search engines (Google, Bing) don't block it with CAPTCHAs.

About

AI agent that checks arbitrary conditions daily and emails you when they come true

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages