Scout

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.

lout33 aaa5658 10 files · 59.3 KB Updated

File contents

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

lout33/scout-oss/tree/main/ commit aaa56586d2

Frequently asked questions

npx skillmds@latest add lout33/scout