trader-alerts

1# trader-alerts
2 
3Price Alerts watches the numbers so the user does not have to. An alert is
4information, never an order: when a stop rings, nothing is sold. If the user
5wants to act, the normal path runs (size, risk, their yes).
6 
7`${CLAUDE_SKILL_DIR}` below is this skill's folder (where this SKILL.md lives).
8 
9```bash
10python3 "${CLAUDE_SKILL_DIR}/alerts.py" clock                         # NYSE open or closed, next open
11python3 "${CLAUDE_SKILL_DIR}/alerts.py" quote AAPL KO --write         # -> trader/prices.json
12python3 "${CLAUDE_SKILL_DIR}/alerts.py" quote --holdings --write      # portfolio + targets tickers
13python3 "${CLAUDE_SKILL_DIR}/alerts.py" add --symbol AAPL --above 350
14python3 "${CLAUDE_SKILL_DIR}/alerts.py" add --symbol BAC --stop 50 --note "my stop"
15python3 "${CLAUDE_SKILL_DIR}/alerts.py" add --symbol KO --pct 3
16python3 "${CLAUDE_SKILL_DIR}/alerts.py" add --opening-bell
17python3 "${CLAUDE_SKILL_DIR}/alerts.py" check                         # exit 0 = something rang
18python3 "${CLAUDE_SKILL_DIR}/alerts.py" list
19python3 "${CLAUDE_SKILL_DIR}/alerts.py" reset aapl-above-350
20```
21 
22## What it reads and writes
23 
24| file | what |
25| --- | --- |
26| `trader/alerts.json` | the rules (`alerts.example.json` in this folder) |
27| `trader/state/alerts.json` | which rules rang and when, so each rings once |
28| `trader/prices.json` | the latest quotes, merged in, for trader-budget, trader-risk, trader-tax and trader-rebalance |
29 
30## Rule types
31 
32| type | rings when | rings again |
33…