| 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_KEYGITHUB_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/.
