SourceHarbor

BrewMe

wake up, news already brewed

What You Get • Install • How It Work • Ecosystem

---

BrewMe is your morning news desk in a box. RSS, web, podcasts, papers, GitHub — all in, ranked by what you care about, served the moment your alarm rings.

┌──────────────────────────────────────┐
│  LOCAL-FIRST          ████████ 100%  │
│  SOURCE-TRACEABLE     ████████ 100%  │
│  TYPING REQUIRED      ░░░░░░░░   0%  │
│  VIBES                ████████ ZERO  │
│                                FILLER│
└──────────────────────────────────────┘

Personal news brewer. Ingest, weigh, summarize. Caffeine-grade signal-to-noise.

What You Get

Surface	What
brewme apps	Web, terminal, and bin entry points. Same brew, different cup.
packages & starter-packs	Everything you need to brew your own beat.
contracts	Source schemas, weighing schemas, brief schemas. All versioned.
infra	One Docker compose. Cron, fetcher, ranker, brewer, server.
evals	Prove the brew is better than yesterday.

[!IMPORTANT] Local-first by default. No silent telemetry. No cloud round-trip. Your data stays on your machine until you explicitly ship it somewhere.

Install

git clone https://github.com/xiaojiou176-open/BrewMe.git
cd BrewMe
# follow the per-stack quickstart in INSTALL.md or docs/

Three commands. No curl | sh. No login. Read what you run.

Install break? Open your favorite agent and say "Read AGENTS.md and bootstrap BrewMe for me." Agent fix own brain. Long version: docs/.

How It Work

The repo is seven layers — exactly the seven commits in git log. New work goes in as small named PRs. No 50-file mystery commits.

Layer	What
chore: scaffold	License, governance, hygiene gates, CI scaffolding.
feat(core)	The primary engine. The reason BrewMe exists.
feat(modules)	Packages, adapters, services, plugins. The second floor.
feat(contracts)	Schemas, configs, public boundaries. Other code talks here.
test:	Receipts. Everything in this layer must run.
feat(ops)	Scripts, infra, CI helpers, build glue.
docs:	Public docs surface. The pretty face.

git log reads like a building floor plan. Look once, know the whole shape.

Ecosystem

BrewMe lives in the *Me family: three personal tools. command-style names, stupid-simple jobs.

Repo	What
BeamMe	beam your agent config to any planet
BrewMe (you here)	wake up, news already brewed
AgentGangGang	five AIs in one sidebar

Cross-family taste: BeamMe · BrewMe · OpenVibeCoding · proofyard.

Star This Repo

If BrewMe saves you a click, an hour, or a headache — star costs zero. Fair trade. ⭐

Also by Yifeng[Terry] Yu

• BeamMe — beam your agent config to any planet
• AgentGangGang — five AIs in one sidebar
• OpenVibeCoding — AI codes overnight, you ship in the morning
• proofyard — every claim ships with its receipt
• dealyard — let prices fight, you sit and watch

License

MIT — small print, big freedom.