ccsidekick 1.0.0 → 1.1.0

package/README.md

@@ -9,20 +9,58 @@ path and disableable.
 npx ccsidekick
 ```
 
-Running `ccsidekick` in a terminal opens the setup TUI: it picks a Claude config dir, lets you choose
-a character, and wires the status line and the tool-call hooks into your `settings.json`. Remove it
-with `npx ccsidekick uninstall`.
+Running `ccsidekick` in a terminal opens the setup UI: a first run walks you through a short guided
+wizard (character, theme, comments), a later run opens the full dashboard. Either way it picks a
+Claude config dir and wires the status line and the tool-call hooks into your `settings.json`.
+Remove it with `npx ccsidekick uninstall`.
+
+## Non-interactive setup (for scripts and AI agents)
+
+No TTY required. `ccsidekick setup` configures and wires everything from flags, so an agent can
+install it in one command:
+
+```bash
+ccsidekick setup --character batman --theme houston --mode fixed
+```
+
+Only the flags you pass are applied (a partial patch onto the existing config, or the defaults on a
+fresh install), then it writes `config.toml` and wires `settings.json` exactly like the TUI.
+
+| Flag                     | Sets                                                            |
+| ------------------------ | --------------------------------------------------------------- |
+| `--character <name>`     | the fixed character                                             |
+| `--mode <fixed\|random>` | fixed one character, or rotate the roster                       |
+| `--roster <a,b,c>`       | the random-mode roster                                          |
+| `--theme <name>`         | a theme, or `character` (the default) to match the character    |
+| `--currency <code>`      | statusline currency, e.g. `USD`                                 |
+| `--budget <usd>`         | monthly budget                                                  |
+| `--comments <on\|off>`   | the character's comment line                                    |
+| `--helpful <on\|off>`    | the helpful-tip line                                            |
+| `--min-severity <sev>`   | `low\|medium\|high\|critical`                                   |
+| `--widgets <a,b,c>`      | statusline widgets to enable (others turn off)                  |
+| `--global` / `--local`   | save target (default global)                                    |
+| `--config-dir <path>`    | Claude config dir (default `$CLAUDE_CONFIG_DIR` or `~/.claude`) |
+
+Discover valid values for scripting, and see every flag:
+
+```bash
+ccsidekick list characters   # also: themes, widgets
+ccsidekick setup --help
+```
+
+An unknown value (e.g. a misspelled theme) exits non-zero and prints the valid set — it never
+silently falls back.
 
 ## The two binaries
 
 - **`ccsidekick-render`** is the hot path. Claude Code calls `ccsidekick-render render` on every
-  status-line tick and `ccsidekick-render classify` on every tool call. It loads no UI and runs under
-  plain Node.
-- **`ccsidekick`** is the setup TUI and `uninstall`. It is the only entry point that loads the Ink
-  interface.
+  status-line tick and `ccsidekick-render classify` on every tool call. It loads no UI and runs
+  under plain Node.
+- **`ccsidekick`** is the user-facing entry: the setup UI, plus `setup`, `list`, and `uninstall`.
+  Only the TUI loads the Ink interface; `setup`/`list`/`uninstall` run under plain Node.
 
-Characters ship as separate `@ccsidekick/pack-<name>` packages; `batman` is bundled as a runtime
-dependency so a fresh install always has a character.
+Every character ships bundled as a runtime dependency, so a fresh install has them all — there is no
+download or install step, and no network to pick a character.
 
 For the full feature tour, configuration reference, and contributor docs, see the
 [repository README](https://github.com/krayong/ccsidekick#readme).

package/dist/ccsidekick-render.js

@@ -2428,11 +2428,10 @@ var DEFAULT_WIDGETS = {
 var DEFAULT_CONFIG = {
   schema_version: 1,
   character: { enabled: true, mode: "random", name: "batman", roster: [] },
-  comments: { enabled: true },
-  helpful: { enabled: true, min_severity: "low" },
-  line: { currency: defaultCurrency(), widgets: DEFAULT_WIDGETS },
-  theme: { name: "houston", banding: "solid", mood_shift: false, icons: {} },
-  network: { fx_refresh: true, usage_fetch: true, balance_path: "" }
+  theme: { name: "character", banding: "solid", mood_shift: false, icons: {} },
+  comments: { character: true, helpful: true, min_severity: "low" },
+  network: { fx_refresh: true, usage_fetch: true, balance_path: "" },
+  statusline: { currency: defaultCurrency(), widgets: DEFAULT_WIDGETS }
 };
 var obj = (v) => v !== null && typeof v === "object" ? v : {};
 var bool = (v, d) => typeof v === "boolean" ? v : d;
@@ -2475,10 +2474,9 @@ function loadConfig(globalToml = "", projectToml = "") {
   const p = safeParse(projectToml);
   const character = section(g, p, "character");
   const comments = section(g, p, "comments");
-  const helpful = section(g, p, "helpful");
-  const line = section(g, p, "line");
   const theme = section(g, p, "theme");
   const network = section(g, p, "network");
+  const statusline = section(g, p, "statusline");
   const d = DEFAULT_CONFIG;
   return {
     schema_version: numv(p["schema_version"] ?? g["schema_version"], d.schema_version),
@@ -2488,21 +2486,6 @@ function loadConfig(globalToml = "", projectToml = "") {
       name: str(character["name"], d.character.name),
       roster: stringArray(character["roster"], d.character.roster)
     },
-    comments: {
-      enabled: bool(comments["enabled"], d.comments.enabled)
-    },
-    helpful: {
-      enabled: bool(helpful["enabled"], d.helpful.enabled),
-      min_severity: oneOf(helpful["min_severity"], ["low", "medium", "high", "critical"], d.helpful.min_severity)
-    },
-    line: {
-      currency: str(line["currency"], d.line.currency),
-      ...typeof line["budget"] === "number" ? { budget: line["budget"] } : {},
-      widgets: mergeWidgets({
-        ...obj(obj(g["line"])["widgets"]),
-        ...obj(obj(p["line"])["widgets"])
-      })
-    },
     theme: {
       name: str(theme["name"], d.theme.name),
       ...typeof theme["statusline"] === "string" ? { statusline: theme["statusline"] } : {},
@@ -2515,10 +2498,23 @@ function loadConfig(globalToml = "", projectToml = "") {
         ...obj(obj(p["theme"])["icons"])
       })
     },
+    comments: {
+      character: bool(comments["character"], d.comments.character),
+      helpful: bool(comments["helpful"], d.comments.helpful),
+      min_severity: oneOf(comments["min_severity"], ["low", "medium", "high", "critical"], d.comments.min_severity)
+    },
     network: {
       fx_refresh: bool(network["fx_refresh"], d.network.fx_refresh),
       usage_fetch: bool(network["usage_fetch"], d.network.usage_fetch),
       balance_path: str(network["balance_path"], d.network.balance_path)
+    },
+    statusline: {
+      currency: str(statusline["currency"], d.statusline.currency),
+      ...typeof statusline["budget"] === "number" ? { budget: statusline["budget"] } : {},
+      widgets: mergeWidgets({
+        ...obj(obj(g["statusline"])["widgets"]),
+        ...obj(obj(p["statusline"])["widgets"])
+      })
     }
   };
 }
@@ -6490,22 +6486,22 @@ var HELPFUL_CATALOG = [
     render: (i) => `Large diff: +${i.git?.insertions ?? 0}/-${i.git?.deletions ?? 0}. Review in chunks.`
   },
   {
-    id: "behind_upstream",
+    id: "diverged",
     severity: "medium",
     category: "git",
     momentary: false,
-    template: "{behind} behind upstream. Pull before your next commit knots the merge.",
-    test: (i) => behind(i.git) > 0,
-    render: (i) => `${behind(i.git)} behind upstream. Pull before your next commit knots the merge.`
+    template: "Diverged {ahead}↑ {behind}↓. `git pull --rebase` keeps history linear.",
+    test: (i) => ahead(i.git) > 0 && behind(i.git) > 0,
+    render: (i) => `Diverged ${ahead(i.git)}↑ ${behind(i.git)}↓. \`git pull --rebase\` keeps history linear.`
   },
   {
-    id: "diverged",
+    id: "behind_upstream",
     severity: "medium",
     category: "git",
     momentary: false,
-    template: "Diverged {ahead}↑ {behind}↓. `git pull --rebase` keeps history linear.",
-    test: (i) => ahead(i.git) > 0 && behind(i.git) > 0,
-    render: (i) => `Diverged ${ahead(i.git)}↑ ${behind(i.git)}↓. \`git pull --rebase\` keeps history linear.`
+    template: "{behind} behind upstream. Pull before your next commit knots the merge.",
+    test: (i) => behind(i.git) > 0,
+    render: (i) => `${behind(i.git)} behind upstream. Pull before your next commit knots the merge.`
   },
   {
     id: "dirty_default_branch",
@@ -7185,8 +7181,11 @@ function build(stdin, env, term, clock, overrides) {
     git,
     payload,
     scan,
-    widgets: config.line.widgets,
-    currency: { code: config.line.currency, rate: fxTable[config.line.currency] ?? 0 },
+    widgets: config.statusline.widgets,
+    currency: {
+      code: config.statusline.currency,
+      rate: fxTable[config.statusline.currency] ?? 0
+    },
     homeDir: env["HOME"] ?? ""
   };
   const composed = composeStatusline(composeInputs);
@@ -7204,7 +7203,7 @@ function build(stdin, env, term, clock, overrides) {
     creds,
     balance
   };
-  const helpfulResult = config.helpful.enabled ? resolveHelpful(helpfulInputs, sessionState, clock, config.helpful.min_severity) : { comment: null, nextHelpful: sessionState.helpful };
+  const helpfulResult = config.comments.helpful ? resolveHelpful(helpfulInputs, sessionState, clock, config.comments.min_severity) : { comment: null, nextHelpful: sessionState.helpful };
   const helpful = helpfulResult.comment;
   const pending = pendingMilestones(familiarity, clock);
   const charBase = {
@@ -7225,7 +7224,7 @@ function build(stdin, env, term, clock, overrides) {
         state: sessionState,
         clock,
         session,
-        config: { enabled: config.comments.enabled }
+        config: { enabled: config.comments.character }
       });
     } catch {
       charResult = { comment: null, nextState: charBase };