DealWatch

CommunityIncomplete39/100Claim

pypi dealwatchstdioMITupdated 19d ago

|---| | dealwatcherer core | Price-monitoring engine. Crawl, normalize, score, alert. | | dealwatcherer frontend | Compare-first dashboard. See the deal, not the noise. | | browser extension | Right-click any product. dealwatcherer does the rest. | | dealwatcherer worker | Scheduled checks, alembic-backed history. | | public skills | Drop into Claude/Codex/OpenClaw and let the agent shop. |

Source Website Docs1

What can you do with DealWatch?

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

Surface	What
`dealwatcherer core`	Price-monitoring engine. Crawl, normalize, score, alert.
`dealwatcherer frontend`	Compare-first dashboard. See the deal, not the noise.
`browser extension`	Right-click any product. dealwatcherer does the rest.
`dealwatcherer worker`	Scheduled checks, alembic-backed history.
`public skills`	Drop 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.

Layer	What
`chore: scaffold`	License, 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.

Repo	What
switchyard	model & agent runtime switch board
browserclickyard	your AI clicks, your browser obeys
noteyard	your Apple Notes never really die
dealwatcherer (you here)	let prices fight, you sit and watch
docyard	docs site in, markdown out, no scraping by hand
fileyard	messy folders in, organized library out
proofyard	every 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. ⭐

Also by Yifeng[Terry] Yu

switchyard — model & agent runtime switch board
browserclickyard — your AI clicks, your browser obeys
BeamMe — beam your agent config to any planet
BrewMe — wake up, news already brewed
OpenVibeCoding — AI codes overnight, you ship in the morning

License

MIT — small print, big freedom.

Install

Add DealWatch to your client. Pick the one you use.

claude mcp add dealwatch -- uvx dealwatch

codex mcp add dealwatch -- uvx dealwatch

amp mcp add dealwatch -- uvx dealwatch

{
  "mcpServers": {
    "dealwatch": {
      "command": "uvx",
      "args": [
        "dealwatch"
      ]
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "dealwatch": {
      "command": "uvx",
      "args": [
        "dealwatch"
      ]
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

code --add-mcp '{"name":"dealwatch","command":"uvx","args":["dealwatch"]}'

Or add the block manually to `.vscode/mcp.json` under `servers`.

{
  "mcpServers": {
    "dealwatch": {
      "command": "uvx",
      "args": [
        "dealwatch"
      ]
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

{
  "mcpServers": {
    "dealwatch": {
      "command": "uvx",
      "args": [
        "dealwatch"
      ]
    }
  }
}

Add to `cline_mcp_settings.json` via the MCP Servers panel.

{
  "mcpServers": {
    "dealwatch": {
      "command": "uvx",
      "args": [
        "dealwatch"
      ]
    }
  }
}

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "dealwatch": {
      "type": "local",
      "command": "uvx",
      "args": [
        "dealwatch"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "dealwatch": {
      "command": {
        "path": "uvx",
        "args": [
          "dealwatch"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

uvx dealwatch

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

DealWatch

What can you do with DealWatch?

What You Get

Install

How It Work

Ecosystem

Star This Repo

Also by Yifeng[Terry] Yu

License

Install

Score

Version history