ClawWatch — Watchlist Skill

Quick Reference

How to Use

1. Run commands via Bash tool: bash clawwatch
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

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