eugeneyan/news-agents

News Agents

A little experiment with Amazon Q, Model Context Protocol (MCP), and tmux to create a news aggregation system that runs entirely in your terminal. It fetches and summarizes articles from various news sources using multiple agents working in parallel.

Also read the write-up here, and click the image below for 3-minute demo on YouTube.

What's This All About?

This project is me playing around with:

• Amazon Q CLI as agent harness
• MCP to parse RSS feeds as tools
• tmux for terminal splitting and monitoring

The system grabs news from several sources like Hacker News, TechCrunch, and WSJ, then summarizes everything into nice readable digests, all in your terminal window.

Getting Started

Setting Up Amazon Q

1. Follow the official guide to install Amazon Q CLI
2. Set up your AWS credentials
3. Make sure it's working:

q --version

Clone repo and run it

git clone https://github.com/eugeneyan/news-agents.git

cd news-agents
uv sync  # Sync dependencies
uv tree  # Check httpx and mcp[cli] are installed

q chat --trust-all-tools  # Start Q

/context add --global context/agents.md  # Add system context for multi-agents

Q, read context/main-agent.md and spin up sub agents to execute it.  # Start main agent

The system will start doing its thing: Splitting into multiple agents and processing news feeds in parallel using tmux panes to keep everything visible.

How It Works

Main Agent

• Grabs feed URLs from feeds.txt
• Splits them into 3 equal chunks
• Spawns 3 sub agents in separate tmux panes
• Keeps an eye on everyone's progress
• Collects all the summaries at the end

Sub Agents

• Each gets assigned several feeds
• For each feed they:
  • Pull down the content
  • Parse out the articles
  • Write up summaries
  • Save them to summaries/[feed-name].md
• When done, they report back to the main agent

The Whole Process Looks Like This

Main Agent (in the main tmux pane)
├── Read feeds.txt
├── Split feeds into 3 chunks
├── Create 3 Sub-Agents (in separate tmux panes)
│   ├── Sub-Agent #1
│   │   ├── Process feeds in chunk 1
│   │   └── Report back when done
│   ├── Sub-Agent #2
│   │   ├── Process feeds in chunk 2
│   │   └── Report back when done
│   └── Sub-Agent #3
│       ├── Process feeds in chunk 3
│       └── Report back when done
└── Combine everything into main-summary.md

What You Get

• Individual summaries in the summaries/ folder
• One big summary in main-summary.md
• A cool demonstration of agents working together in your terminal

Debugging MCP

uv run mcp dev src/main.p

Project Files

.
├── context/           # Instructions for the agents
├── src/               # Code for processing each feed type
│   ├── ainews.py      # AI News stuff
│   ├── hackernews.py  # Hacker News stuff
│   ├── techcrunch.py  # TechCrunch stuff
│   ├── wired.py       # Wired stuff
│   └── wsj.py         # Wall Street Journal stuff
└── summaries/         # Where all the summaries end up