@claudinho/cli 0.6.0 → 0.6.2

package/README.md

@@ -27,10 +27,12 @@ claudinho markets [target]  # prediction-market signals: today | <date> | <id> |
                             #   (next prefers the team's IN-PLAY match while one is live)
 claudinho share [target]    # copy-pasteable snippet: today | live | <date> | <id> | next <TEAM> | table <GROUP>
 claudinho prompt            # one compact status line (for statusline/tmux/Starship)
-claudinho init-statusline   # wire it into the Claude Code statusline
-claudinho init-cursor-statusline  # wire it into the Cursor CLI statusline
+claudinho init cursor       # one-step Cursor setup: statusline + MCP paste (--print for snippets)
+claudinho init claude       # one-step Claude Code setup: statusline + hook + MCP one-liner
+claudinho init-statusline   # (granular) wire just the Claude Code statusline
+claudinho init-cursor-statusline  # (granular) wire just the Cursor CLI statusline
 claudinho hook              # live-score context for a Claude Code hook (silent off-match)
-claudinho init-hook         # make Claude itself score-aware (UserPromptSubmit)
+claudinho init-hook         # (granular) make Claude itself score-aware (UserPromptSubmit)
 claudinho vibe              # a matchday-coder one-liner (#VibingLaVidaLoca)
 ```
 
@@ -164,6 +166,7 @@ network** (<150ms). When several matches are live it shows them all inline:
 - `CLAUDINHO_TEAM=MEX` — show only your team's match; also the default team for `next`, `markets next`, and `share next` when the argument is omitted
 - `CLAUDINHO_MAX=2` — cap how many live matches show inline (rest collapse to `+N`; default: all)
 - `CLAUDINHO_COMPACT=0` — show 3-letter codes alongside flags
+- `CLAUDINHO_FLAGS=off` — drop emoji flags for 3-letter codes (statusline) / plain names (hook); already automatic on terminals that can't render flag emoji, e.g. Warp
 
 Use the same `claudinho prompt` in **tmux** (`set -g status-right '#(claudinho prompt)'`)
 or a **Starship** custom command — it works in any shell.
@@ -185,8 +188,10 @@ claudinho init-cursor-statusline          # patches ~/.cursor/cli-config.json (b
 claudinho init-cursor-statusline --print  # just print the snippet
 ```
 
-Uses the same `claudinho prompt` hot path as Claude Code. Cursor-specific tuning
-is applied automatically (`updateIntervalMs: 1000`, `timeoutMs: 1500`).
+Uses the same `claudinho prompt` hot path as Claude Code — so the same
+`CLAUDINHO_TEAM` / `CLAUDINHO_MAX` / `CLAUDINHO_COMPACT` customizations above apply
+here too. Cursor-specific tuning is applied automatically (`updateIntervalMs: 1000`,
+`timeoutMs: 1500`).
 
 Optional second line with session meta (model, context %, worktree, vim mode) **below** the score:
 

package/dist/index.js

@@ -3979,6 +3979,13 @@ function releaseLock() {
 
 // src/statusline.ts
 var DISPLAY_STALE_MS = 5 * 6e4;
+var FLAGLESS_TERMINALS = /* @__PURE__ */ new Set(["WarpTerminal"]);
+function flagsEnabled(env = process.env) {
+  const v = (env.CLAUDINHO_FLAGS ?? "").trim().toLowerCase();
+  if (v === "off" || v === "0" || v === "no" || v === "false") return false;
+  if (v === "on" || v === "1" || v === "yes" || v === "true") return true;
+  return !FLAGLESS_TERMINALS.has(env.TERM_PROGRAM ?? "");
+}
 var LIVE_TTL_MS = 15e3;
 function inLiveWindow(now = Date.now(), fixtures = allFixtures()) {
   return fixturesInLiveWindow(now, fixtures).length > 0;
@@ -3986,8 +3993,14 @@ function inLiveWindow(now = Date.now(), fixtures = allFixtures()) {
 function nextOverall(now, fixtures = allFixtures()) {
   return [...fixtures].sort(byKickoff).find((m) => Date.parse(m.kickoff) >= now);
 }
-function matchSegment(m, compact) {
+function teamTok(t, flags) {
+  return flags ? t.flag : t.code;
+}
+function matchSegment(m, compact, flags) {
   const minute = m.status === "HT" ? "HT" : m.minute ? `${m.minute}'` : "LIVE";
+  if (!flags) {
+    return `${m.home.code} ${scoreline(m)} ${m.away.code} ${minute}`;
+  }
   const home = compact ? m.home.flag : `${m.home.flag} ${m.home.code}`;
   const away = compact ? m.away.flag : `${m.away.code} ${m.away.flag}`;
   return `${home} ${scoreline(m)} ${away} ${minute}`;
@@ -4003,15 +4016,16 @@ function renderPrompt(state, opts = {}) {
   const now = opts.now ?? /* @__PURE__ */ new Date();
   const nowMs = now.getTime();
   const compact = opts.compact ?? true;
+  const flags = opts.flags ?? true;
   const team = opts.team?.toUpperCase();
   const live = liveMatchesFromCache(state, nowMs);
   if (team) {
     const mine = live.find((m) => m.home?.code === team || m.away?.code === team);
-    if (mine) return `\u26BD ${matchSegment(mine, compact)}`;
+    if (mine) return `\u26BD ${matchSegment(mine, compact, flags)}`;
   } else if (live.length > 0) {
     const max = opts.max && opts.max > 0 ? opts.max : live.length;
     const shown = live.slice(0, max);
-    let line2 = "\u26BD " + shown.map((m) => matchSegment(m, compact)).join(" \xB7 ");
+    let line2 = "\u26BD " + shown.map((m) => matchSegment(m, compact, flags)).join(" \xB7 ");
     const overflow = live.length - shown.length;
     if (overflow > 0) line2 += ` +${overflow}`;
     return line2;
@@ -4024,24 +4038,27 @@ function renderPrompt(state, opts = {}) {
     const first = win[0];
     if (first) {
       const more = win.length - 1;
-      return `\u26BD ${first.home.flag} vs ${first.away.flag} live \xB7 syncing\u2026` + (more > 0 ? ` +${more}` : "");
+      return `\u26BD ${teamTok(first.home, flags)} vs ${teamTok(first.away, flags)} live \xB7 syncing\u2026` + (more > 0 ? ` +${more}` : "");
     }
   }
   const next = team ? nextFixtureForTeam(team, { from: now }) : nextOverall(nowMs);
   if (next) {
-    return `${next.home.flag} vs ${next.away.flag} in ${countdown(next.kickoff, now)}`;
+    return `${teamTok(next.home, flags)} vs ${teamTok(next.away, flags)} in ${countdown(next.kickoff, now)}`;
   }
   return "\u26BD \u2014";
 }
 
 // src/hook.ts
-function line(m) {
+function line(m, flags) {
   const minute = m.status === "HT" ? "half-time" : m.minute ? `${m.minute}'` : "live";
-  return `${m.home.flag} ${m.home.name} ${scoreline(m)} ${m.away.name} ${m.away.flag} (${minute})`;
+  const home = flags ? `${m.home.flag} ${m.home.name}` : m.home.name;
+  const away = flags ? `${m.away.name} ${m.away.flag}` : m.away.name;
+  return `${home} ${scoreline(m)} ${away} (${minute})`;
 }
 function renderHook(state, opts = {}) {
   const now = opts.now ?? /* @__PURE__ */ new Date();
   const team = opts.team?.toUpperCase();
+  const flags = opts.flags ?? true;
   let live = liveMatchesFromCache(state, now.getTime());
   if (live.length === 0) return "";
   if (team) {
@@ -4051,7 +4068,7 @@ function renderHook(state, opts = {}) {
       return aHas - bHas;
     });
   }
-  const lines = live.map(line).join("\n");
+  const lines = live.map((mm) => line(mm, flags)).join("\n");
   return `[Claudinho \u2014 live football scores right now]
 ${lines}`;
 }
@@ -4536,7 +4553,7 @@ function cmdPrompt({ cfg }) {
     const maxRaw = Number.parseInt(process.env.CLAUDINHO_MAX ?? "", 10);
     const max = Number.isFinite(maxRaw) && maxRaw > 0 ? maxRaw : void 0;
     const state = readCurrentState(cfg.source, resolveCompetition());
-    const scoreLine = renderPrompt(state, { team, compact, max });
+    const scoreLine = renderPrompt(state, { team, compact, max, flags: flagsEnabled() });
     out(renderPromptOutput(scoreLine, payload));
     if (!state || shouldRefresh()) spawnRefresh(cfg.source);
   } catch {
@@ -4547,7 +4564,7 @@ function cmdHook({ cfg }) {
   try {
     const team = process.env.CLAUDINHO_TEAM;
     const state = readCurrentState(cfg.source, resolveCompetition());
-    const ctx = renderHook(state, { team });
+    const ctx = renderHook(state, { team, flags: flagsEnabled() });
     if (ctx) out(ctx);
     if (!state || shouldRefresh()) spawnRefresh(cfg.source);
   } catch {
@@ -4574,6 +4591,50 @@ function cmdInitHook(opts, { cfg }) {
 function cmdInitCursorStatusline(opts, { cfg }) {
   printInitResult(initCursorStatusline({ print: opts.print, command: opts.command }), cfg);
 }
+var CURSOR_MCP_SNIPPET = `{
+  "mcpServers": {
+    "claudinho": { "command": "npx", "args": ["-y", "@claudinho/mcp"] }
+  }
+}`;
+var CLAUDE_MCP_ONELINER = "claude mcp add claudinho -- npx -y @claudinho/mcp";
+function cmdInitCursor(opts, { cfg }) {
+  if (opts.print) {
+    out("# 1) Cursor CLI statusline  \u2192  ~/.cursor/cli-config.json");
+    printInitResult(initCursorStatusline({ print: true }), cfg);
+    out("");
+    out("# 2) MCP tools (optional)  \u2192  ~/.cursor/mcp.json  (or project .cursor/mcp.json)");
+    out(CURSOR_MCP_SNIPPET);
+    return;
+  }
+  printInitResult(initCursorStatusline(), cfg);
+  out("");
+  out("Optional \u2014 live MCP tools in Cursor: add to ~/.cursor/mcp.json (or project .cursor/mcp.json):");
+  out(CURSOR_MCP_SNIPPET);
+  out("");
+  out("Tip: export CLAUDINHO_CURSOR_META=auto for a model + context line below the score.");
+  out("");
+  out("\u2192 Restart your agent session to see it.");
+}
+function cmdInitClaude(opts, { cfg }) {
+  if (opts.print) {
+    out("# 1) Claude Code statusline  \u2192  ~/.claude/settings.json");
+    printInitResult(initStatusline({ print: true }), cfg);
+    out("");
+    out("# 2) Live-score hook  \u2192  ~/.claude/settings.json");
+    printInitResult(initHook({ print: true }), cfg);
+    out("");
+    out("# 3) MCP tools (run this):");
+    out(CLAUDE_MCP_ONELINER);
+    return;
+  }
+  printInitResult(initStatusline(), cfg);
+  printInitResult(initHook(), cfg);
+  out("");
+  out("Next \u2014 add the MCP server:");
+  out(`  ${CLAUDE_MCP_ONELINER}`);
+  out("");
+  out("\u2192 Restart Claude Code to see it.");
+}
 async function cmdMatch(id, ctx) {
   const { cfg, t } = ctx;
   precheck(cfg, t);
@@ -5003,10 +5064,11 @@ function handlePipeError(stream) {
 }
 handlePipeError(process.stdout);
 handlePipeError(process.stderr);
-var VERSION = "0.6.0";
+var VERSION = "0.6.2";
 var DISCLAIMER = "Claudinho is an independent fan project. Not affiliated with or endorsed by FIFA or Anthropic.";
 function ctxFrom(cmd) {
-  const root = cmd.parent ?? cmd;
+  let root = cmd;
+  while (root.parent) root = root.parent;
   const opts = root.opts();
   const cfg = resolveConfig(opts);
   return { cfg, t: makeT(cfg.lang) };
@@ -5077,6 +5139,21 @@ program.command("share").description("print a shareable, copy-pasteable match sn
 program.command("prompt").description("print a status line (Claude Code / Cursor CLI statusline, tmux, Starship, \u2026)").action((_opts, cmd) => {
   cmdPrompt(ctxFrom(cmd));
 });
+var init = program.command("init").description("one-step setup for your agent: `init cursor` or `init claude`");
+init.command("cursor").description("set up claudinho for the Cursor CLI (statusline + MCP config)").option("--print", "print the config snippets for manual install instead of writing them").action((opts, cmd) => {
+  try {
+    cmdInitCursor(opts, ctxFrom(cmd));
+  } catch (e) {
+    fail(e);
+  }
+});
+init.command("claude").description("set up claudinho for Claude Code (statusline + hook + MCP)").option("--print", "print the config snippets for manual install instead of writing them").action((opts, cmd) => {
+  try {
+    cmdInitClaude(opts, ctxFrom(cmd));
+  } catch (e) {
+    fail(e);
+  }
+});
 program.command("init-statusline").description("configure the Claude Code statusline to use claudinho").option("--print", "print the settings snippet instead of writing it").option("--command <cmd>", "command to run (default: claudinho prompt)").action((opts, cmd) => {
   try {
     cmdInitStatusline(opts, ctxFrom(cmd));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/cli",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Live scores, fixtures, group tables, and read-only prediction-market signals for the 2026 men's football tournament — in your terminal, Claude Code, and Cursor CLI statusline. No API keys. Not affiliated with FIFA or Anthropic.",
   "type": "module",
   "license": "MIT",
@@ -45,7 +45,11 @@
     "claude-code",
     "cursor-cli",
     "2026",
-    "vibinglavidaloca"
+    "vibinglavidaloca",
+    "cursor",
+    "cursor-agent",
+    "mcp",
+    "agent"
   ],
   "dependencies": {
     "cli-table3": "^0.6.5",
@@ -57,7 +61,7 @@
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.0",
-    "@claudinho/core": "0.6.0"
+    "@claudinho/core": "0.6.2"
   },
   "scripts": {
     "build": "tsup",