clawwatch

# ClawWatch — Watchlist Skill ## Quick Reference | User says... | You run... | |---|---| | "Füg Bitcoin zur Watchlist hinzu" | `clawwatch add BTC` | | "Add NVIDIA and Tesla" | `clawwatch add NVDA TSLA --tag portfolio` | | "Wie steht meine Watchlist?" | `clawwatch check --json` → parse & summarize | | "Zeig mir nur die Kryptos" | `clawwatch list --type crypto --json` | | "Alert wenn BTC über 100k geht" | `clawwatch alert add BTC above 100000` | | "Alert if ETH drops 5% in a day" | `clawwatch alert add ETH change 5` | | "Wie ist die Marktstimmung?" | `clawwatch feargreed` | | "Entferne TSLA" | `clawwatch remove TSLA` | | "Check my alerts" | `clawwatch alert check --json` | | "Export als CSV" | `clawwatch export --format csv` | ## How to Use 1. Run commands via Bash tool: `bash clawwatch <command>` 2. Use `--json` flag to get machine-readable output you can parse 3. Summarize results in natural language for the user 4. For deep analysis, pass the JSON data to market-analyst agent ## Important Rules - **Always use `--json` flag** when you need to parse the output programmatically - **Don't run `clawwatch check` too frequently** — respect API rate limits (max every 60 seconds) - **Auto-detection:** Just pass symbols like `BTC`, `ETH`, `NVDA`, `SAP.DE` — the tool auto-detects crypto vs stock - **Alert exit codes:** `clawwatch alert check` returns exit code 0 (no alerts) or 1 (triggered) ## Combining with market-analyst When the user asks for analysis (not just prices), chain: 1. `clawwatch check --json` → get current prices 2. Pass relevant data to market-analyst for interpretation 3. Deliver combined response ## Reading Cached Data Instead of running CLI commands, you can read cached data directly: - `~/.clawwatch/latest.json` — Last fetched prices - `~/.clawwatch/watchlist.json` — Full watchlist state ## Installation ```bash pip install clawwatch # No API keys needed for crypto! Works out of the box. # Optional: set CoinCap key for higher rate limits clawwatch config --coincap-key YOUR_KEY # optional ```