scout

name	scout
description	Run a local web research agent and mission-driven intelligence scanner that searches multiple sources and writes markdown briefs. Best for trend monitoring, opportunity scouting, builder discovery, and technical signal scanning.
allowed-tools	["Bash","Read"]

Scout

Mission-driven local web research agent backed by the files in this directory.

What it does

• plans a scan from a mission
• calls source adapters to gather signal
• follows promising leads
• writes a markdown brief to inbox/

Best for:

• technical trend monitoring
• open-source discovery
• opportunity scouting
• builder and ecosystem research

Working adapters

• Hacker News
• GitHub
• Jina Reader

Setup

pip install -r requirements.txt
cp .env.example .env

Then configure one of:

• Codex auth: codex login --device-auth
• ANTHROPIC_API_KEY

Optional:

• JINA_API_KEY
• GITHUB_TOKEN

Direct commands

python agent.py --mission "Find 3 interesting technical signals from today" --tokens 5000
./quick.sh --mission "Find 2 interesting GitHub repos from this week"
./scout.sh --tokens 20000 --mission "Find open-source agent tooling worth tracking"
./daily.sh --tokens 10000

Recommended smoke test

python agent.py --mission "Use hn_front, github_trending, and jina_read to find 2 interesting technical signals from today and write a brief." --tokens 2500

If the setup works, Scout writes a markdown brief to inbox/.