@claudinho/cli 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +28 -8
- package/dist/index.js +633 -302
- package/package.json +18 -13
package/README.md
CHANGED
|
@@ -18,7 +18,7 @@ npx @claudinho/cli today
|
|
|
18
18
|
## Commands
|
|
19
19
|
|
|
20
20
|
```bash
|
|
21
|
-
claudinho today [date] # a day's fixtures (default: today), live scores inline
|
|
21
|
+
claudinho today [date] # a day's fixtures in your timezone (default: today), live scores inline
|
|
22
22
|
claudinho live # matches in play right now
|
|
23
23
|
claudinho next <TEAM> # a team's next fixture + countdown (e.g. next MEX)
|
|
24
24
|
claudinho table [GROUP] # group standings (default: all groups)
|
|
@@ -27,6 +27,7 @@ claudinho prompt # one compact status line (for statusline/tmux/Stars
|
|
|
27
27
|
claudinho init-statusline # wire it into the Claude Code statusline
|
|
28
28
|
claudinho hook # live-score context for a Claude Code hook (silent off-match)
|
|
29
29
|
claudinho init-hook # make Claude itself score-aware (UserPromptSubmit)
|
|
30
|
+
claudinho vibe # a matchday-coder one-liner (#VibingLaVidaLoca)
|
|
30
31
|
```
|
|
31
32
|
|
|
32
33
|
### Examples
|
|
@@ -36,6 +37,7 @@ claudinho today --tz America/Mexico_City --lang es
|
|
|
36
37
|
claudinho next BRA --tz America/Sao_Paulo --lang pt
|
|
37
38
|
claudinho table A
|
|
38
39
|
claudinho live --json | jq '.matches[].status'
|
|
40
|
+
claudinho today --flavor off # just the facts, no commentary
|
|
39
41
|
```
|
|
40
42
|
|
|
41
43
|
## Global options
|
|
@@ -43,13 +45,25 @@ claudinho live --json | jq '.matches[].status'
|
|
|
43
45
|
| Flag | Description |
|
|
44
46
|
|---|---|
|
|
45
47
|
| `--lang <code>` | `en`, `es`, `pt`, `fr` (also via `CLAUDINHO_LANG`; falls back to `$LANG`) |
|
|
46
|
-
| `--tz <zone>` | IANA timezone, e.g. `America/Mexico_City` (also `CLAUDINHO_TZ`; default: system) |
|
|
48
|
+
| `--tz <zone>` | IANA timezone, e.g. `America/Mexico_City` (also `CLAUDINHO_TZ`; default: system). Kickoff times **and** which day a fixture falls on are computed in this zone — a late-night-UTC match shows on the day you actually watch it. |
|
|
47
49
|
| `--json` | machine-readable output for scripting |
|
|
48
50
|
| `--no-color` | disable ANSI color (also honors `NO_COLOR`; auto-off when piped) |
|
|
49
|
-
| `--source <name>` | data
|
|
51
|
+
| `--source <name>` | live data provider (advanced; sensible default) |
|
|
52
|
+
| `--flavor <level>` | commentary flair: `off`, `subtle`, `full` (default: `full`; also `CLAUDINHO_FLAVOR`) |
|
|
50
53
|
|
|
51
54
|
Team codes are 3-letter (FIFA/IOC-style): `MEX`, `BRA`, `USA`, `ENG`, …
|
|
52
55
|
|
|
56
|
+
### Commentary flair
|
|
57
|
+
|
|
58
|
+
By default Claudinho narrates with a bit of localized football-broadcast energy —
|
|
59
|
+
`¡GOOOOL!` on a goal, `¡a cancha llena!` before kickoff. These are generic,
|
|
60
|
+
genre-style exclamations (no real commentator is quoted or impersonated),
|
|
61
|
+
localized per `--lang`, and they never affect `--json` output.
|
|
62
|
+
|
|
63
|
+
- `--flavor full` *(default)* — flair on fixtures, live play, goals, and full-time
|
|
64
|
+
- `--flavor subtle` — only goals and full-time
|
|
65
|
+
- `--flavor off` — just the facts
|
|
66
|
+
|
|
53
67
|
## Statusline (Claude Code)
|
|
54
68
|
|
|
55
69
|
```bash
|
|
@@ -80,7 +94,7 @@ off-match it's silent (zero added tokens). Restart Claude Code to activate.
|
|
|
80
94
|
|
|
81
95
|
## Other competitions
|
|
82
96
|
|
|
83
|
-
By default Claudinho follows the 2026 World Cup. To follow a different
|
|
97
|
+
By default Claudinho follows the 2026 World Cup. To follow a different
|
|
84
98
|
competition (e.g. international friendlies before the tournament starts):
|
|
85
99
|
|
|
86
100
|
```bash
|
|
@@ -89,15 +103,21 @@ claudinho live # live friendlies
|
|
|
89
103
|
unset CLAUDINHO_COMPETITION # back to the World Cup
|
|
90
104
|
```
|
|
91
105
|
|
|
92
|
-
Only the live fetch changes; the bundled schedule is always the World Cup.
|
|
106
|
+
Only the live fetch changes; the bundled schedule is always the World Cup. The
|
|
107
|
+
statusline/hook cache is keyed to the active competition, so switching with
|
|
108
|
+
`CLAUDINHO_COMPETITION` never surfaces stale scores from the other competition.
|
|
93
109
|
|
|
94
110
|
## How it works
|
|
95
111
|
|
|
96
|
-
The full fixture list (104 matches, groups, venues, kickoffs) ships **bundled**
|
|
112
|
+
The full fixture list (104 matches, groups, venues, host cities, kickoffs) ships **bundled**
|
|
97
113
|
in the package, so the common path is offline and instant. Only live match
|
|
98
|
-
state hits the network. Scores come from a swappable data
|
|
99
|
-
|
|
114
|
+
state hits the network. Scores come from a swappable data provider; provider
|
|
115
|
+
attribution and rate limits are respected.
|
|
100
116
|
|
|
101
117
|
## License
|
|
102
118
|
|
|
103
119
|
MIT © 2026 Arturo Garrido · [source & issues](https://github.com/arturogarrido/claudinho)
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
_Built while watching the games._ **#VibingLaVidaLoca** ⚽
|