DealWatch

DealWatch

Local
@xiaojiou176-open1PythonMITUpdated 1mo ago

Local-first grocery price intelligence with a read-only MCP server.

shopping bags

dealwatcherer

let prices fight, you sit and watch

Stars Last Commit License

What You Get • Install • How It Work • Ecosystem


dealwatcherer watches the products you care about across vendors, replays history, and tells you when to pull the trigger. Browser extension and dashboard included.

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

Track prices across vendors. Get the receipt before you check out.

What You Get

SurfaceWhat
dealwatcherer corePrice-monitoring engine. Crawl, normalize, score, alert.
dealwatcherer frontendCompare-first dashboard. See the deal, not the noise.
browser extensionRight-click any product. dealwatcherer does the rest.
dealwatcherer workerScheduled checks, alembic-backed history.
public skillsDrop into Claude/Codex/OpenClaw and let the agent shop.

[!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/dealwatcherer.git
cd dealwatcherer
# 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 dealwatcherer 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.

LayerWhat
chore: scaffoldLicense, governance, hygiene gates, CI scaffolding.
feat(core)The primary engine. The reason dealwatcherer 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

dealwatcherer lives in the yard family: seven yards. one philosophy: structured input, structured output, structured proof.

RepoWhat
switchyardmodel & agent runtime switch board
browserclickyardyour AI clicks, your browser obeys
noteyardyour Apple Notes never really die
dealwatcherer (you here)let prices fight, you sit and watch
docyarddocs site in, markdown out, no scraping by hand
fileyardmessy folders in, organized library out
proofyardevery claim ships with its receipt

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

Star This Repo

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

Star History Chart

Also by Yifeng[Terry] Yu

License

MIT — small print, big freedom.