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 Updated
Scout OSS quickstart demo

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 commit aaa56586d2

Frequently asked questions

npx get-skill add lout33/scout