@claudinho/cli 0.5.2 → 0.6.1

package/README.md

@@ -27,9 +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       # 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)
 ```
 
@@ -177,6 +180,34 @@ Wires `claudinho hook` into Claude Code's `UserPromptSubmit`. During a match,
 the live score is injected into Claude's context so it can mention it naturally;
 off-match it's silent (zero added tokens). Restart Claude Code to activate.
 
+## Statusline (Cursor CLI)
+
+```bash
+claudinho init-cursor-statusline          # patches ~/.cursor/cli-config.json (backs up first)
+claudinho init-cursor-statusline --print  # just print the snippet
+```
+
+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:
+
+```bash
+export CLAUDINHO_CURSOR_META=auto   # recommended for Cursor CLI
+```
+
+Custom command (local dev or monorepo checkout):
+
+```bash
+claudinho init-cursor-statusline --command "node ./packages/cli/dist/index.js prompt"
+```
+
+> Cursor's `beforeSubmitPrompt` hook does not yet reliably inject live-score
+> context into the model. Use `init-hook` for Claude Code; Cursor CLI is
+> statusline-only until hook injection lands.
+
 ## How it works
 
 The full fixture list (104 matches, groups, venues, host cities, kickoffs) ships **bundled**

package/dist/index.js

@@ -4114,12 +4114,65 @@ function spawnRefresh(source) {
   }
 }
 
+// src/cursorPayload.ts
+import { readFileSync as readFileSync3 } from "fs";
+function parseCursorPayload(raw) {
+  try {
+    const trimmed = raw.trim();
+    if (!trimmed) return void 0;
+    return JSON.parse(trimmed);
+  } catch {
+    return void 0;
+  }
+}
+function readCursorPayload() {
+  try {
+    if (process.stdin.isTTY) return void 0;
+    return parseCursorPayload(readFileSync3(0, "utf8"));
+  } catch {
+    return void 0;
+  }
+}
+function looksLikeCursorPayload(payload) {
+  return !!(payload.model?.display_name || payload.context_window != null || payload.render_width_chars != null || payload.worktree?.name || payload.vim?.mode);
+}
+function cursorMetaEnabled(payload) {
+  const v = (process.env.CLAUDINHO_CURSOR_META ?? "").toLowerCase();
+  if (v === "0" || v === "false" || v === "no") return false;
+  if (v === "1" || v === "true" || v === "yes") return !!payload;
+  if (v === "auto") return !!payload && looksLikeCursorPayload(payload);
+  return false;
+}
+function renderCursorMetaLine(payload) {
+  const parts = [];
+  const model = payload.model?.display_name;
+  if (model) {
+    let label = model;
+    if (payload.model?.param_summary) label += ` ${payload.model.param_summary}`;
+    parts.push(label);
+  }
+  const pct2 = payload.context_window?.used_percentage;
+  if (typeof pct2 === "number" && Number.isFinite(pct2)) {
+    parts.push(`ctx ${Math.floor(pct2)}%`);
+  }
+  if (payload.worktree?.name) parts.push(`wt ${payload.worktree.name}`);
+  if (payload.vim?.mode) parts.push(payload.vim.mode);
+  if (parts.length === 0) return void 0;
+  return `\x1B[90m${parts.join("  ")}\x1B[0m`;
+}
+function renderPromptOutput(scoreLine, payload) {
+  const meta = payload && cursorMetaEnabled(payload) ? renderCursorMetaLine(payload) : void 0;
+  if (meta) return `${scoreLine}
+${meta}`;
+  return scoreLine;
+}
+
 // src/install.ts
 import {
   copyFileSync,
   existsSync,
   mkdirSync as mkdirSync3,
-  readFileSync as readFileSync3,
+  readFileSync as readFileSync4,
   writeFileSync as writeFileSync2
 } from "fs";
 import { homedir as homedir3 } from "os";
@@ -4127,80 +4180,116 @@ import { dirname, join as join3 } from "path";
 function claudeSettingsPath() {
   return join3(homedir3(), ".claude", "settings.json");
 }
+function cursorCliConfigPath() {
+  return join3(homedir3(), ".cursor", "cli-config.json");
+}
+function isSameCommand(configured, requested) {
+  return configured === requested;
+}
 function backupOnce(path) {
   const bak = `${path}.claudinho.bak`;
   if (existsSync(path) && !existsSync(bak)) copyFileSync(path, bak);
 }
-function initStatusline(opts = {}) {
-  const path = opts.path ?? claudeSettingsPath();
-  const sl = { type: "command", command: opts.command ?? "claudinho prompt" };
+var DEFAULT_PROMPT_COMMAND = "claudinho prompt";
+var HOOK_COMMAND = "claudinho hook";
+var CURSOR_STATUSLINE_DEFAULTS = {
+  padding: 0,
+  updateIntervalMs: 1e3,
+  timeoutMs: 1500
+};
+function configPathFor(target, override) {
+  if (override) return override;
+  return target === "cursor" ? cursorCliConfigPath() : claudeSettingsPath();
+}
+function defaultStatusLineConfig(target, command) {
+  const base = { type: "command", command };
+  if (target === "cursor") return { ...base, ...CURSOR_STATUSLINE_DEFAULTS };
+  return base;
+}
+function restartMessage(target) {
+  return target === "cursor" ? "Restart Cursor CLI (or start a new session) to see it." : "Restart Claude Code to see it.";
+}
+function readSettings(path, snippet) {
+  if (!existsSync(path)) return {};
+  try {
+    return JSON.parse(readFileSync4(path, "utf8"));
+  } catch {
+    return {
+      action: "manual",
+      path,
+      message: `Could not parse ${path}. Add this manually:
+${snippet}`
+    };
+  }
+}
+function isInitResult(v) {
+  return "action" in v && typeof v.action === "string";
+}
+function initStatuslineFor(target, opts = {}) {
+  const path = configPathFor(target, opts.path);
+  const command = opts.command ?? DEFAULT_PROMPT_COMMAND;
+  const sl = defaultStatusLineConfig(target, command);
   const snippet = JSON.stringify({ statusLine: sl }, null, 2);
   if (opts.print) {
     return { action: "printed", path, message: snippet };
   }
-  let settings = {};
-  if (existsSync(path)) {
-    try {
-      settings = JSON.parse(readFileSync3(path, "utf8"));
-    } catch {
-      return {
-        action: "manual",
-        path,
-        message: `Could not parse ${path}. Add this manually:
-${snippet}`
-      };
-    }
-  }
+  const parsed = readSettings(path, snippet);
+  if (isInitResult(parsed)) return parsed;
+  const settings = parsed;
   const existing = settings.statusLine;
-  if (existing?.command?.includes("claudinho")) {
-    return { action: "already", path, message: `Statusline already uses claudinho (${path}).` };
+  if (isSameCommand(existing?.command, command)) {
+    const label = target === "cursor" ? "Cursor CLI statusline" : "Statusline";
+    return { action: "already", path, message: `${label} already configured (${path}).` };
   }
   backupOnce(path);
   settings.statusLine = sl;
   mkdirSync3(dirname(path), { recursive: true });
   writeFileSync2(path, JSON.stringify(settings, null, 2) + "\n", "utf8");
+  const surface = target === "cursor" ? "Cursor CLI statusline" : "Statusline";
   return {
     action: "written",
     path,
-    message: `Statusline configured in ${path}. Restart Claude Code to see it.`
+    message: `${surface} configured in ${path}. ${restartMessage(target)}`
   };
 }
-var HOOK_EVENT = "UserPromptSubmit";
-var HOOK_COMMAND = "claudinho hook";
+function initStatusline(opts = {}) {
+  return initStatuslineFor("claude", opts);
+}
+function initCursorStatusline(opts = {}) {
+  return initStatuslineFor("cursor", opts);
+}
+var CLAUDE_HOOK_EVENT = "UserPromptSubmit";
+function claudeHookCommands(settings) {
+  const hooks = settings.hooks;
+  const matchers = hooks?.[CLAUDE_HOOK_EVENT] ?? [];
+  return matchers.flatMap(
+    (m) => (m.hooks ?? []).map((h) => h.command).filter((c) => typeof c === "string")
+  );
+}
 function initHook(opts = {}) {
   const path = opts.path ?? claudeSettingsPath();
   const command = opts.command ?? HOOK_COMMAND;
   const snippet = JSON.stringify(
-    { hooks: { [HOOK_EVENT]: [{ hooks: [{ type: "command", command }] }] } },
+    { hooks: { [CLAUDE_HOOK_EVENT]: [{ hooks: [{ type: "command", command }] }] } },
     null,
     2
   );
   if (opts.print) return { action: "printed", path, message: snippet };
-  let settings = {};
-  if (existsSync(path)) {
-    try {
-      settings = JSON.parse(readFileSync3(path, "utf8"));
-    } catch {
-      return {
-        action: "manual",
-        path,
-        message: `Could not parse ${path}. Add this manually:
-${snippet}`
-      };
-    }
+  const parsed = readSettings(path, snippet);
+  if (isInitResult(parsed)) return parsed;
+  const settings = parsed;
+  if (claudeHookCommands(settings).some((c) => isSameCommand(c, command))) {
+    return {
+      action: "already",
+      path,
+      message: `UserPromptSubmit hook already configured (${path}).`
+    };
   }
+  backupOnce(path);
   settings.hooks ??= {};
   const hooks = settings.hooks;
-  hooks[HOOK_EVENT] ??= [];
-  const matchers = hooks[HOOK_EVENT];
-  const already = matchers.some(
-    (m) => (m.hooks ?? []).some((h) => typeof h.command === "string" && h.command.includes("claudinho"))
-  );
-  if (already) {
-    return { action: "already", path, message: `UserPromptSubmit hook already uses claudinho (${path}).` };
-  }
-  backupOnce(path);
-  matchers.push({ hooks: [{ type: "command", command }] });
+  hooks[CLAUDE_HOOK_EVENT] ??= [];
+  hooks[CLAUDE_HOOK_EVENT].push({ hooks: [{ type: "command", command }] });
   mkdirSync3(dirname(path), { recursive: true });
   writeFileSync2(path, JSON.stringify(settings, null, 2) + "\n", "utf8");
   return {
@@ -4439,6 +4528,7 @@ async function cmdTable(group, ctx) {
 }
 function cmdPrompt({ cfg }) {
   try {
+    const payload = readCursorPayload();
     const team = process.env.CLAUDINHO_TEAM;
     const compact = !["0", "false", "no"].includes(
       (process.env.CLAUDINHO_COMPACT ?? "").toLowerCase()
@@ -4446,7 +4536,8 @@ 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());
-    out(renderPrompt(state, { team, compact, max }));
+    const scoreLine = renderPrompt(state, { team, compact, max });
+    out(renderPromptOutput(scoreLine, payload));
     if (!state || shouldRefresh()) spawnRefresh(cfg.source);
   } catch {
     out("");
@@ -4465,8 +4556,7 @@ function cmdHook({ cfg }) {
 async function cmdRefresh({ cfg }) {
   await runRefresh({ source: cfg.source });
 }
-function cmdInitStatusline(opts, { cfg }) {
-  const res = initStatusline({ print: opts.print });
+function printInitResult(res, cfg) {
   const c = painterFor(cfg);
   if (res.action === "printed") {
     out(res.message);
@@ -4475,15 +4565,58 @@ function cmdInitStatusline(opts, { cfg }) {
   const mark = res.action === "written" ? c.green("\u2713") : res.action === "already" ? c.cyan("\u2022") : c.yellow("!");
   out(`${mark} ${res.message}`);
 }
+function cmdInitStatusline(opts, { cfg }) {
+  printInitResult(initStatusline({ print: opts.print, command: opts.command }), cfg);
+}
 function cmdInitHook(opts, { cfg }) {
-  const res = initHook({ print: opts.print });
-  const c = painterFor(cfg);
-  if (res.action === "printed") {
-    out(res.message);
+  printInitResult(initHook({ print: opts.print, command: opts.command }), 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;
   }
-  const mark = res.action === "written" ? c.green("\u2713") : res.action === "already" ? c.cyan("\u2022") : c.yellow("!");
-  out(`${mark} ${res.message}`);
+  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;
@@ -4914,10 +5047,11 @@ function handlePipeError(stream) {
 }
 handlePipeError(process.stdout);
 handlePipeError(process.stderr);
-var VERSION = "0.5.2";
+var VERSION = "0.6.1";
 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) };
@@ -4930,7 +5064,7 @@ function fail(err) {
 }
 var program = new Command();
 program.name("claudinho").description(
-  "The 2026 men\u2019s football tournament in your terminal, your Claude Code statusline, and any MCP client.\n" + DISCLAIMER
+  "The 2026 men\u2019s football tournament in your terminal, your Claude Code / Cursor CLI statusline, and any MCP client.\n" + DISCLAIMER
 ).version(VERSION, "-v, --version").option("--lang <code>", "language: en, es, pt, fr").option("--tz <zone>", "IANA timezone, e.g. America/Mexico_City").option("--json", "output JSON (for scripting)").option("--no-color", "disable ANSI colors").option("--source <name>", "live data provider (advanced)").option("--flavor <level>", "commentary flair: off, subtle, full (default: full)").option("--no-markets", "hide prediction-market signals (informational only)");
 program.addHelpText("after", "\n#VibingLaVidaLoca \u26BD");
 program.command("today").description("show a day's fixtures (default: today)").argument("[date]", "date as YYYY-MM-DD").action(async (date, _opts, cmd) => {
@@ -4985,20 +5119,42 @@ program.command("share").description("print a shareable, copy-pasteable match sn
     fail(e);
   }
 });
-program.command("prompt").description("print a one-line status (Claude Code statusline, tmux, Starship, \u2026)").action((_opts, cmd) => {
+program.command("prompt").description("print a status line (Claude Code / Cursor CLI statusline, tmux, Starship, \u2026)").action((_opts, cmd) => {
   cmdPrompt(ctxFrom(cmd));
 });
-program.command("init-statusline").description("configure the Claude Code statusline to use claudinho").option("--print", "print the settings snippet instead of writing it").action((opts, 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));
   } catch (e) {
     fail(e);
   }
 });
+program.command("init-cursor-statusline").description("configure the Cursor CLI 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 {
+    cmdInitCursorStatusline(opts, ctxFrom(cmd));
+  } catch (e) {
+    fail(e);
+  }
+});
 program.command("hook").description("print live-score context for a Claude Code UserPromptSubmit hook (silent off-match)").action((_opts, cmd) => {
   cmdHook(ctxFrom(cmd));
 });
-program.command("init-hook").description("wire the live-score hook into Claude Code (UserPromptSubmit)").option("--print", "print the settings snippet instead of writing it").action((opts, cmd) => {
+program.command("init-hook").description("wire the live-score hook into Claude Code (UserPromptSubmit)").option("--print", "print the settings snippet instead of writing it").option("--command <cmd>", "command to run (default: claudinho hook)").action((opts, cmd) => {
   try {
     cmdInitHook(opts, ctxFrom(cmd));
   } catch (e) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@claudinho/cli",
-  "version": "0.5.2",
-  "description": "Live scores, fixtures, group tables, and read-only prediction-market signals for the 2026 men's football tournament — in your terminal and Claude Code statusline. No API keys. Not affiliated with FIFA or Anthropic.",
+  "version": "0.6.1",
+  "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",
   "author": "Arturo Garrido",
@@ -43,8 +43,13 @@
     "terminal",
     "statusline",
     "claude-code",
+    "cursor-cli",
     "2026",
-    "vibinglavidaloca"
+    "vibinglavidaloca",
+    "cursor",
+    "cursor-agent",
+    "mcp",
+    "agent"
   ],
   "dependencies": {
     "cli-table3": "^0.6.5",
@@ -56,7 +61,7 @@
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.0",
-    "@claudinho/core": "0.5.2"
+    "@claudinho/core": "0.6.1"
   },
   "scripts": {
     "build": "tsup",