@kud/ai-conventional-commit-cli 0.6.0 → 0.7.1

package/README.md

@@ -13,7 +13,7 @@
   <a href="https://www.conventionalcommits.org"><img alt="Conventional Commits" src="https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg" /></a>
 </p>
 
-> TL;DR: Stage your changes, run `ai-conventional-commit` (or `split` for multiple commits), accept, done. Add `--gitmoji` if you like emoji. Refine later with `refine`.
+> TL;DR: Stage your changes, run `ai-conventional-commit` (or `split` for multiple commits), accept, done. Add `--style gitmoji` if you like emoji. Refine later with `refine`.
 
 ---
 
@@ -101,11 +101,11 @@ ai-conventional-commit
 # Propose multiple commits (interactive confirm + real selective staging)
 ai-conventional-commit split
 
-# Add emoji decorations
-ai-conventional-commit --gitmoji
+# Add emoji decorations (gitmoji)
+ai-conventional-commit --style gitmoji
 
 # Pure emoji style (emoji: subject)
-ai-conventional-commit --gitmoji-pure
+ai-conventional-commit --style gitmoji-pure
 
 # Refine previous session's first commit (shorter wording)
 ai-conventional-commit refine --shorter
@@ -113,20 +113,23 @@ ai-conventional-commit refine --shorter
 
 ## Command Reference
 
-| Command                           | Purpose                                     |
-| --------------------------------- | ------------------------------------------- |
-| `ai-conventional-commit`          | Generate single commit suggestion (default) |
-| `ai-conventional-commit generate` | Explicit alias of root                      |
-| `ai-conventional-commit split`    | Propose & execute multiple commits          |
-| `ai-conventional-commit refine`   | Refine last session (or indexed) commit     |
+| Command                              | Purpose                                     |
+| ------------------------------------ | ------------------------------------------- |
+| `ai-conventional-commit`             | Generate single commit suggestion (default) |
+| `ai-conventional-commit generate`    | Explicit alias of root                      |
+| `ai-conventional-commit split`       | Propose & execute multiple commits          |
+| `ai-conventional-commit refine`      | Refine last session (or indexed) commit     |
+| `ai-conventional-commit models`      | List / pick models, save default            |
+| `ai-conventional-commit config show` | Show merged config + sources                |
+| `ai-conventional-commit config get`  | Get a single config value                   |
+| `ai-conventional-commit config set`  | Persist a global config value               |
 
 Helpful flags:
 
-- `--gitmoji` / `--gitmoji-pure`
+- `--style <standard|gitmoji|gitmoji-pure>`
 - `--model <provider/name>` (override)
 - `--scope <scope>` (refine)
 - `--shorter` / `--longer`
-- `--emoji` (add appropriate emoji in refine)
 
 ## Examples
 
@@ -163,7 +166,7 @@ $ ai-conventional-commit refine --scope cli --shorter
 | gitmoji      | `✨ feat: add search box` | Emoji + type retained                |
 | gitmoji-pure | `✨: add search box`      | Type removed; emoji acts as category |
 
-Enable via CLI flags or config (`gitmoji: true`, `gitmojiMode`).
+Enable via CLI flag `--style gitmoji|gitmoji-pure` or config `"style": "gitmoji"` / `"style": "gitmoji-pure"`.
 
 ## Privacy Modes
 
@@ -183,8 +186,7 @@ Resolves via cosmiconfig (JSON/YAML/etc). Example:
 {
   "model": "github-copilot/gpt-4.1",
   "privacy": "low",
-  "gitmoji": true,
-  "gitmojiMode": "gitmoji",
+  "style": "gitmoji",
   "styleSamples": 120,
   "plugins": ["./src/sample-plugin/example-plugin.ts"],
   "maxTokens": 512
@@ -192,12 +194,39 @@ Resolves via cosmiconfig (JSON/YAML/etc). Example:
 ```
 
 Environment overrides (prefix `AICC_`):
-`MODEL`, `PRIVACY`, `STYLE_SAMPLES`, `GITMOJI`, `MAX_TOKENS`, `VERBOSE`, `MODEL_TIMEOUT_MS`, `DEBUG`, `PRINT_LOGS`, `DEBUG_PROVIDER=mock`.
+
+### Configuration Precedence
+
+Lowest to highest (later wins):
+
+1. Built-in defaults
+2. Global config file: `~/.config/ai-conventional-commit-cli/aicc.json` (or `$XDG_CONFIG_HOME`)
+3. Project config (.aiccrc via cosmiconfig)
+4. Environment variables (`AICC_*`)
+5. CLI flags (e.g. `--model`, `--style`)
+
+View the resolved configuration:
+
+```bash
+ai-conventional-commit config show
+ai-conventional-commit config show --json | jq
+```
+
+Manage models:
+
+```bash
+ai-conventional-commit models               # list (opencode pass-through)
+ai-conventional-commit models --interactive      # interactive picker
+ai-conventional-commit models --interactive --save # pick + persist globally
+ai-conventional-commit models --current     # show active model + source
+```
+
+`MODEL`, `PRIVACY`, `STYLE`, `STYLE_SAMPLES`, `MAX_TOKENS`, `VERBOSE`, `MODEL_TIMEOUT_MS`, `DEBUG`, `PRINT_LOGS`, `DEBUG_PROVIDER=mock`.
 
 ## Refinement Workflow
 
 1. Generate (`ai-conventional-commit` or `split`) – session cached under `.git/.aicc-cache/last-session.json`.
-2. Run `refine` with flags (`--shorter`, `--longer`, `--scope=ui`, `--emoji`).
+2. Run `refine` with flags (`--shorter`, `--longer`, `--scope=ui`).
 3. Accept or reject; refined output does _not_ auto‑amend history until you use it.
 
 ## Plugin API

package/dist/chunk-DCGUX6KW.js

@@ -0,0 +1,95 @@
+// src/config.ts
+import { cosmiconfig } from "cosmiconfig";
+import { resolve, dirname, join } from "path";
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { homedir } from "os";
+var DEFAULTS = {
+  model: process.env.AICC_MODEL || "github-copilot/gpt-4.1",
+  privacy: process.env.AICC_PRIVACY || "low",
+  style: process.env.AICC_STYLE || "standard",
+  styleSamples: parseInt(process.env.AICC_STYLE_SAMPLES || "120", 10),
+  maxTokens: parseInt(process.env.AICC_MAX_TOKENS || "512", 10),
+  cacheDir: ".git/.aicc-cache",
+  plugins: [],
+  verbose: process.env.AICC_VERBOSE === "true"
+};
+function getGlobalConfigPath() {
+  const base = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
+  return resolve(base, "ai-conventional-commit-cli", "aicc.json");
+}
+function saveGlobalConfig(partial) {
+  const filePath = getGlobalConfigPath();
+  const dir = dirname(filePath);
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  let existing = {};
+  if (existsSync(filePath)) {
+    try {
+      existing = JSON.parse(readFileSync(filePath, "utf8")) || {};
+    } catch (e) {
+      if (process.env.AICC_VERBOSE === "true") {
+        console.error("[ai-cc] Failed to parse existing global config, overwriting.");
+      }
+    }
+  }
+  const merged = { ...existing, ...partial };
+  writeFileSync(filePath, JSON.stringify(merged, null, 2) + "\n", "utf8");
+  return filePath;
+}
+async function loadConfig(cwd = process.cwd()) {
+  return (await loadConfigDetailed(cwd)).config;
+}
+async function loadConfigDetailed(cwd = process.cwd()) {
+  let globalCfg = {};
+  const globalPath = getGlobalConfigPath();
+  if (existsSync(globalPath)) {
+    try {
+      globalCfg = JSON.parse(readFileSync(globalPath, "utf8")) || {};
+    } catch (e) {
+      if (process.env.AICC_VERBOSE === "true") {
+        console.error("[ai-cc] Failed to parse global config, ignoring.");
+      }
+    }
+  }
+  const explorer = cosmiconfig("aicc");
+  const result = await explorer.search(cwd);
+  const projectCfg = result?.config || {};
+  const envCfg = {};
+  if (process.env.AICC_MODEL) envCfg.model = process.env.AICC_MODEL;
+  if (process.env.AICC_PRIVACY) envCfg.privacy = process.env.AICC_PRIVACY;
+  if (process.env.AICC_STYLE) envCfg.style = process.env.AICC_STYLE;
+  if (process.env.AICC_STYLE_SAMPLES)
+    envCfg.styleSamples = parseInt(process.env.AICC_STYLE_SAMPLES, 10);
+  if (process.env.AICC_MAX_TOKENS) envCfg.maxTokens = parseInt(process.env.AICC_MAX_TOKENS, 10);
+  if (process.env.AICC_VERBOSE) envCfg.verbose = process.env.AICC_VERBOSE === "true";
+  const merged = {
+    ...DEFAULTS,
+    ...globalCfg,
+    ...projectCfg,
+    ...envCfg
+  };
+  merged.plugins = (merged.plugins || []).filter((p) => {
+    const abs = resolve(cwd, p);
+    return existsSync(abs);
+  });
+  const sources = Object.keys(merged).reduce((acc, key) => {
+    const k = key;
+    let src = "default";
+    if (k in globalCfg) src = "global";
+    if (k in projectCfg) src = "project";
+    if (k in envCfg) src = "env";
+    acc[k] = src;
+    return acc;
+  }, {});
+  const withMeta = Object.assign(merged, { _sources: sources });
+  return {
+    config: withMeta,
+    raw: { defaults: DEFAULTS, global: globalCfg, project: projectCfg, env: envCfg }
+  };
+}
+
+export {
+  getGlobalConfigPath,
+  saveGlobalConfig,
+  loadConfig,
+  loadConfigDetailed
+};

package/dist/config-Q7AKJSO4.js

@@ -0,0 +1,12 @@
+import {
+  getGlobalConfigPath,
+  loadConfig,
+  loadConfigDetailed,
+  saveGlobalConfig
+} from "./chunk-DCGUX6KW.js";
+export {
+  getGlobalConfigPath,
+  loadConfig,
+  loadConfigDetailed,
+  saveGlobalConfig
+};

package/dist/index.js

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  loadConfig
+} from "./chunk-DCGUX6KW.js";
 
 // src/index.ts
 import { Cli, Command, Option } from "clipanion";
@@ -195,7 +198,7 @@ var buildGenerationMessages = (opts) => {
   );
   specLines.push("Length Rule: Entire title line (including type/scope) must be <= 72 chars.");
   specLines.push(
-    "Emoji Rule: " + (config.gitmoji ? "OPTIONAL single leading gitmoji BEFORE the type only if confidently adds clarity; do not invent or stack; omit if unsure." : "Disallow all emojis and gitmoji codes; output must start directly with the type.")
+    "Emoji Rule: " + (config.style === "gitmoji" || config.style === "gitmoji-pure" ? "OPTIONAL single leading gitmoji BEFORE the type only if confidently adds clarity; do not invent or stack; omit if unsure." : "Disallow all emojis and gitmoji codes; output must start directly with the type.")
   );
   specLines.push(
     "Forbidden: breaking changes notation, exclamation mark after type unless truly semver-major (avoid unless diff clearly indicates)."
@@ -244,7 +247,7 @@ var buildRefineMessages = (opts) => {
   spec.push("Title Format: <type>(<optional-scope>): <subject> (<=72 chars)");
   spec.push("Subject: imperative, present tense, no trailing period.");
   spec.push(
-    "Emoji Rule: " + (config.gitmoji ? "OPTIONAL single leading gitmoji BEFORE type if it adds clarity; omit if unsure." : "Disallow all emojis; start directly with the type.")
+    "Emoji Rule: " + (config.style === "gitmoji" || config.style === "gitmoji-pure" ? "OPTIONAL single leading gitmoji BEFORE type if it adds clarity; omit if unsure." : "Disallow all emojis; start directly with the type.")
   );
   spec.push("Preserve semantic meaning; only improve clarity, scope, brevity, conformity.");
   spec.push("If instructions request scope or emoji, incorporate only if justified by content.");
@@ -298,7 +301,7 @@ ${userAggregate}`;
       });
     }
     const start = Date.now();
-    return await new Promise((resolve3, reject) => {
+    return await new Promise((resolve2, reject) => {
       let resolved = false;
       let acc = "";
       const includeLogs = process.env.AICC_PRINT_LOGS === "true";
@@ -318,7 +321,7 @@ ${userAggregate}`;
             `[ai-cc][provider] model=${this.model} elapsedMs=${elapsed} promptChars=${fullPrompt.length} bytesOut=${value.length}`
           );
         }
-        resolve3(value);
+        resolve2(value);
       };
       const tryEager = () => {
         if (!eager) return;
@@ -699,8 +702,10 @@ function renderCommitBlock(opts) {
     const lines = opts.body.split("\n");
     lines.forEach((line, i) => {
       if (line.trim().length === 0) borderLine();
-      else if (i === 0) borderLine(descColor("Description:") + " " + bodyFirst(line));
-      else borderLine(bodyRest(line));
+      else if (i === 0) {
+        borderLine(descColor("Description:"));
+        borderLine(bodyFirst(line));
+      } else borderLine(bodyRest(line));
     });
   }
 }
@@ -760,8 +765,8 @@ async function runGenerate(config) {
   candidates = candidates.map((c) => ({
     ...c,
     title: formatCommitTitle(c.title, {
-      allowGitmoji: !!config.gitmoji,
-      mode: config.gitmojiMode || "standard"
+      allowGitmoji: config.style === "gitmoji" || config.style === "gitmoji-pure",
+      mode: config.style
     })
   }));
   const chosen = candidates[0];
@@ -911,8 +916,8 @@ async function runSplit(config, desired) {
   candidates = candidates.map((c) => ({
     ...c,
     title: formatCommitTitle(c.title, {
-      allowGitmoji: !!config.gitmoji,
-      mode: config.gitmojiMode || "standard"
+      allowGitmoji: config.style === "gitmoji" || config.style === "gitmoji-pure",
+      mode: config.style
     })
   }));
   const fancy = candidates.length > 1;
@@ -1051,7 +1056,6 @@ async function runRefine(config, options) {
   if (options.shorter) instructions.push("Make the title shorter but keep meaning.");
   if (options.longer) instructions.push("Add more specificity to the title.");
   if (options.scope) instructions.push(`Add or adjust scope to: ${options.scope}`);
-  if (options.emoji) instructions.push("Add a relevant emoji prefix.");
   if (!instructions.length) {
     const add = await prompt("No refinement flags given. Enter custom instruction: ");
     if (add.trim()) instructions.push(add.trim());
@@ -1073,8 +1077,8 @@ async function runRefine(config, options) {
   );
   const refinedPlan = await runStep("Parsing response", async () => extractJSON(raw));
   refinedPlan.commits[0].title = formatCommitTitle(refinedPlan.commits[0].title, {
-    allowGitmoji: !!config.gitmoji || !!options.emoji,
-    mode: config.gitmojiMode || "standard"
+    allowGitmoji: config.style === "gitmoji" || config.style === "gitmoji-pure",
+    mode: config.style
   });
   phased.phase("Suggested commit");
   phased.stop();
@@ -1108,39 +1112,10 @@ async function runRefine(config, options) {
   finalSuccess({ count: 1, startedAt });
 }
 
-// src/config.ts
-import { cosmiconfig } from "cosmiconfig";
-import { resolve as resolve2 } from "path";
-import { existsSync as existsSync4 } from "fs";
-var DEFAULTS = {
-  model: process.env.AICC_MODEL || "github-copilot/gpt-4.1",
-  privacy: process.env.AICC_PRIVACY || "low",
-  gitmoji: process.env.AICC_GITMOJI === "true",
-  gitmojiMode: "standard",
-  styleSamples: parseInt(process.env.AICC_STYLE_SAMPLES || "120", 10),
-  maxTokens: parseInt(process.env.AICC_MAX_TOKENS || "512", 10),
-  cacheDir: ".git/.aicc-cache",
-  plugins: [],
-  verbose: process.env.AICC_VERBOSE === "true"
-};
-async function loadConfig(cwd = process.cwd()) {
-  const explorer = cosmiconfig("aicc");
-  const result = await explorer.search(cwd);
-  const cfg = {
-    ...DEFAULTS,
-    ...result?.config || {}
-  };
-  cfg.plugins = (cfg.plugins || []).filter((p) => {
-    const abs = resolve2(cwd, p);
-    return existsSync4(abs);
-  });
-  return cfg;
-}
-
 // package.json
 var package_default = {
   name: "@kud/ai-conventional-commit-cli",
-  version: "0.6.0",
+  version: "0.7.1",
   type: "module",
   description: "Opinionated, style-aware AI assistant for crafting and splitting git commits (opencode-based, provider-agnostic).",
   bin: {
@@ -1210,22 +1185,78 @@ var package_default = {
 };
 
 // src/index.ts
+import { execa as execa2 } from "execa";
+import inquirer4 from "inquirer";
 var pkgVersion = package_default.version || "0.0.0";
+var RootCommand = class extends Command {
+  static paths = [[]];
+  static usage = Command.Usage({
+    description: "Generate a conventional commit message (default command).",
+    details: `Commands:
+
+\u22C5 generate: Generate a single commit (default)
+
+\u22C5 split: Plan & apply multiple smaller commits
+
+\u22C5 refine: Refine last (or indexed) commit
+
+\u22C5 models: List or pick AI models (opencode)
+
+\u22C5 config show: Show merged config + sources
+
+\u22C5 config get <key>: Get a single config value
+
+\u22C5 config set <k> <v>: Persist a global config value
+
+Refine Options:
+
+\u22C5 --shorter: Make message more concise
+
+\u22C5 --longer: Expand message with detail
+
+\u22C5 --scope <scope>: Add or replace scope
+
+\u22C5 --index <n>: Target commit from previous split`,
+    examples: [
+      ["Generate with gitmoji style", "ai-conventional-commit --style gitmoji"],
+      ["Split staged changes", "ai-conventional-commit split --max 3"],
+      ["Pick & save default model", "ai-conventional-commit models -i --save"],
+      ["Set style globally", "ai-conventional-commit config set style gitmoji"],
+      ["Show config JSON", "ai-conventional-commit config show --json"]
+    ]
+  });
+  style = Option.String("--style", {
+    required: false,
+    description: "Title style: standard | gitmoji | gitmoji-pure"
+  });
+  model = Option.String("-m,--model", {
+    required: false,
+    description: "Model provider/name (e.g. github-copilot/gpt-4.1)"
+  });
+  async execute() {
+    const config = await loadConfig();
+    if (this.style) config.style = this.style;
+    if (this.model) config.model = this.model;
+    await runGenerate(config);
+  }
+};
 var GenerateCommand = class extends Command {
-  static paths = [[`generate`], []];
+  static paths = [[`generate`]];
   static usage = Command.Usage({
     description: "Generate a conventional commit message for staged changes.",
-    details: `Generates a single commit message using AI with style + guardrails.
-Add --gitmoji[-pure] to enable emoji styles.`,
+    details: `Generate a single conventional commit using AI with style rules, guardrails, and optional model override. Uses staged changes. Add --style gitmoji or --style gitmoji-pure for emoji modes.`,
     examples: [
-      ["Generate a commit with gitmoji style", "ai-conventional-commit generate --gitmoji"]
+      ["Basic usage (standard style)", "ai-conventional-commit generate"],
+      ["Force gitmoji style", "ai-conventional-commit generate --style gitmoji"],
+      [
+        "Override model for this run",
+        "ai-conventional-commit generate --model github-copilot/gpt-4.1"
+      ]
     ]
   });
-  gitmoji = Option.Boolean("--gitmoji", false, {
-    description: "Gitmoji mode (vs --gitmoji-pure): emoji + type (emoji: subject)"
-  });
-  gitmojiPure = Option.Boolean("--gitmoji-pure", false, {
-    description: "Pure gitmoji mode (vs --gitmoji): emoji only (emoji: subject)"
+  style = Option.String("--style", {
+    required: false,
+    description: "Title style: standard | gitmoji | gitmoji-pure"
   });
   model = Option.String("-m,--model", {
     required: false,
@@ -1233,9 +1264,8 @@ Add --gitmoji[-pure] to enable emoji styles.`,
   });
   async execute() {
     const config = await loadConfig();
-    if (this.gitmoji || this.gitmojiPure) {
-      config.gitmoji = true;
-      config.gitmojiMode = this.gitmojiPure ? "gitmoji-pure" : "gitmoji";
+    if (this.style) {
+      config.style = this.style;
     }
     if (this.model) config.model = this.model;
     await runGenerate(config);
@@ -1245,21 +1275,19 @@ var SplitCommand = class extends Command {
   static paths = [[`split`]];
   static usage = Command.Usage({
     description: "Propose multiple smaller conventional commits for current staged diff.",
-    details: `Analyzes staged changes, groups them logically and suggests multiple commit messages.
-Use --max to limit the number of proposals.`,
+    details: `Analyze staged changes, group them logically, and propose multiple conventional commit titles + bodies. Use --max to limit proposals. Each proposal obeys style + guardrails.`,
     examples: [
+      ["Default split (standard style)", "ai-conventional-commit split"],
       [
-        "Split into at most 3 commits with gitmoji",
-        "ai-conventional-commit split --max 3 --gitmoji"
+        "Limit to 3 proposals with gitmoji style",
+        "ai-conventional-commit split --max 3 --style gitmoji"
       ]
     ]
   });
   max = Option.String("--max", { description: "Max proposed commits", required: false });
-  gitmoji = Option.Boolean("--gitmoji", false, {
-    description: "Gitmoji mode (vs --gitmoji-pure): emoji + type"
-  });
-  gitmojiPure = Option.Boolean("--gitmoji-pure", false, {
-    description: "Pure gitmoji mode (vs --gitmoji): emoji only"
+  style = Option.String("--style", {
+    required: false,
+    description: "Title style: standard | gitmoji | gitmoji-pure"
   });
   model = Option.String("-m,--model", {
     required: false,
@@ -1267,10 +1295,7 @@ Use --max to limit the number of proposals.`,
   });
   async execute() {
     const config = await loadConfig();
-    if (this.gitmoji || this.gitmojiPure) {
-      config.gitmoji = true;
-      config.gitmojiMode = this.gitmojiPure ? "gitmoji-pure" : "gitmoji";
-    }
+    if (this.style) config.style = this.style;
     if (this.model) config.model = this.model;
     await runSplit(config, this.max ? parseInt(this.max, 10) : void 0);
   }
@@ -1279,7 +1304,7 @@ var RefineCommand = class extends Command {
   static paths = [[`refine`]];
   static usage = Command.Usage({
     description: "Refine the last (or chosen) commit message with style rules.",
-    details: `Allows targeted improvements: shorter/longer length, inject scope, add emoji, or select a specific index when multiple commits were generated earlier.`,
+    details: `Targeted improvements to an existing commit: shorter/longer length, inject or replace scope, or refine a specific index from a previous split.`,
     examples: [
       ["Shorten the last commit message", "ai-conventional-commit refine --shorter"],
       ["Add a scope to the last commit", "ai-conventional-commit refine --scope ui"]
@@ -1288,7 +1313,10 @@ var RefineCommand = class extends Command {
   shorter = Option.Boolean("--shorter", false, { description: "Make message more concise" });
   longer = Option.Boolean("--longer", false, { description: "Expand message with detail" });
   scope = Option.String("--scope", { description: "Override/add scope (e.g. ui, api)" });
-  emoji = Option.Boolean("--emoji", false, { description: "Add appropriate gitmoji (non-pure)" });
+  style = Option.String("--style", {
+    required: false,
+    description: "Title style: standard | gitmoji | gitmoji-pure"
+  });
   index = Option.String("--index", {
     description: "Select commit index if multiple were generated"
   });
@@ -1298,50 +1326,196 @@ var RefineCommand = class extends Command {
   });
   async execute() {
     const config = await loadConfig();
+    if (this.style) config.style = this.style;
     if (this.model) config.model = this.model;
     await runRefine(config, {
       shorter: this.shorter,
       longer: this.longer,
       scope: this.scope,
-      emoji: this.emoji,
       index: this.index ? parseInt(this.index, 10) : void 0
     });
   }
 };
-var HelpCommand = class extends Command {
-  static paths = [[`--help`], [`-h`]];
-  // capture explicit help
+var ModelsCommand = class extends Command {
+  static paths = [[`models`]];
+  static usage = Command.Usage({
+    description: "List available models via opencode CLI.",
+    details: `Wrapper around "opencode models". Use --interactive (or -i) for a picker; prints the selected model id for piping or quick copy. Add --save with --interactive to persist globally in aicc.json (XDG config).`,
+    examples: [
+      ["List models", "ai-conventional-commit models"],
+      ["Interactively pick a model", "ai-conventional-commit models --interactive"],
+      ["Pick & save globally", "ai-conventional-commit models --interactive --save"]
+    ]
+  });
+  interactive = Option.Boolean("-i,--interactive", false, {
+    description: "Interactive model selection"
+  });
+  save = Option.Boolean("--save", false, {
+    description: "Persist selected model globally (requires --interactive)"
+  });
+  current = Option.Boolean("--current", false, {
+    description: "Print current default model and its source"
+  });
   async execute() {
-    this.context.stdout.write(globalHelp() + "\n");
+    if (this.current) {
+      const { loadConfigDetailed } = await import("./config-Q7AKJSO4.js");
+      const { config } = await loadConfigDetailed();
+      this.context.stdout.write(`${config.model} (source: ${config._sources.model})
+`);
+      return;
+    }
+    try {
+      const { stdout } = await execa2("opencode", ["models"]).catch(async (err) => {
+        if (err.shortMessage && /ENOENT/.test(err.shortMessage)) {
+          this.context.stderr.write(
+            "opencode CLI not found in PATH. Install it from https://github.com/opencodejs/opencode or ensure the binary is available.\n"
+          );
+        }
+        throw err;
+      });
+      const useInteractive = this.interactive;
+      if (!useInteractive) {
+        this.context.stdout.write(stdout.trim() + "\n");
+        return;
+      }
+      if (!process.stdout.isTTY) {
+        this.context.stdout.write(stdout.trim() + "\n");
+        return;
+      }
+      const candidates = Array.from(
+        new Set(
+          stdout.split("\n").map((l) => l.trim()).filter((l) => /^[a-z0-9_.-]+\/[A-Za-z0-9_.:-]+$/.test(l))
+        )
+      );
+      if (candidates.length === 0) {
+        this.context.stdout.write(stdout.trim() + "\n");
+        return;
+      }
+      const { model } = await inquirer4.prompt([
+        {
+          name: "model",
+          type: "list",
+          message: "Select a model",
+          choices: candidates
+        }
+      ]);
+      this.context.stdout.write(model + "\n");
+      if (this.save) {
+        try {
+          const { saveGlobalConfig } = await import("./config-Q7AKJSO4.js");
+          const path = saveGlobalConfig({ model });
+          this.context.stdout.write(`Saved as default model in ${path}
+`);
+        } catch (e) {
+          this.context.stderr.write(`Failed to save global config: ${e?.message || e}
+`);
+        }
+      }
+      this.context.stdout.write(
+        `
+Use it now:
+  ai-conventional-commit generate --model ${model}
+`
+      );
+    } catch (e) {
+      this.context.stderr.write(
+        `Failed to list models via "opencode models": ${e?.message || e}
+`
+      );
+    }
+  }
+};
+var ConfigShowCommand = class extends Command {
+  static paths = [[`config`, `show`]];
+  static usage = Command.Usage({
+    description: "Show effective configuration with source metadata.",
+    details: "Outputs merged config fields, their values, and source precedence info. Use --json for raw JSON including _sources.",
+    examples: [
+      ["Human readable", "ai-conventional-commit config show"],
+      ["JSON with sources", "ai-conventional-commit config show --json"]
+    ]
+  });
+  json = Option.Boolean("--json", false, { description: "Output JSON including _sources" });
+  async execute() {
+    const { loadConfigDetailed } = await import("./config-Q7AKJSO4.js");
+    const { config, raw } = await loadConfigDetailed();
+    if (this.json) {
+      this.context.stdout.write(JSON.stringify({ config, raw }, null, 2) + "\n");
+      return;
+    }
+    const sources = config._sources;
+    const lines = Object.entries(config).filter(([k]) => k !== "_sources").map(([k, v]) => `${k} = ${JSON.stringify(v)}  (${sources[k]})`);
+    this.context.stdout.write(lines.join("\n") + "\n");
+  }
+};
+var ConfigGetCommand = class extends Command {
+  static paths = [[`config`, `get`]];
+  static usage = Command.Usage({
+    description: "Get a single configuration value (effective).",
+    details: "Returns the effective value after merging sources. Optionally show its source.",
+    examples: [
+      ["Get model", "ai-conventional-commit config get model"],
+      ["Get style", "ai-conventional-commit config get style"],
+      ["Get model with source", "ai-conventional-commit config get model --with-source"]
+    ]
+  });
+  key = Option.String();
+  withSource = Option.Boolean("--with-source", false, { description: "Append source label" });
+  async execute() {
+    const { loadConfigDetailed } = await import("./config-Q7AKJSO4.js");
+    const { config } = await loadConfigDetailed();
+    const key = this.key;
+    if (!(key in config)) {
+      this.context.stderr.write(`Unknown config key: ${this.key}
+`);
+      process.exitCode = 1;
+      return;
+    }
+    if (this.withSource) {
+      const src = config._sources?.[key];
+      this.context.stdout.write(`${JSON.stringify(config[key])} (${src})
+`);
+    } else {
+      this.context.stdout.write(JSON.stringify(config[key]) + "\n");
+    }
+  }
+};
+var ConfigSetCommand = class extends Command {
+  static paths = [[`config`, `set`]];
+  static usage = Command.Usage({
+    description: "Set and persist a global configuration key.",
+    details: "Writes to the global aicc.json (XDG config). Accepts JSON for complex values. Only allowed keys: model, style, privacy, styleSamples, maxTokens, verbose.",
+    examples: [
+      ["Set default model", "ai-conventional-commit config set model github-copilot/gpt-4.1"],
+      ["Set style to gitmoji", "ai-conventional-commit config set style gitmoji"],
+      ["Enable verbose mode", "ai-conventional-commit config set verbose true"]
+    ]
+  });
+  key = Option.String();
+  value = Option.String();
+  async execute() {
+    const allowed = /* @__PURE__ */ new Set(["model", "style", "privacy", "styleSamples", "maxTokens", "verbose"]);
+    if (!allowed.has(this.key)) {
+      this.context.stderr.write(`Cannot set key: ${this.key}
+`);
+      process.exitCode = 1;
+      return;
+    }
+    let parsed = this.value;
+    if (/^(true|false)$/i.test(this.value)) parsed = this.value.toLowerCase() === "true";
+    else if (/^[0-9]+$/.test(this.value)) parsed = parseInt(this.value, 10);
+    else if (/^[\[{]/.test(this.value)) {
+      try {
+        parsed = JSON.parse(this.value);
+      } catch {
+      }
+    }
+    const { saveGlobalConfig } = await import("./config-Q7AKJSO4.js");
+    const path = saveGlobalConfig({ [this.key]: parsed });
+    this.context.stdout.write(`Saved ${this.key} to ${path}
+`);
   }
 };
-function globalHelp() {
-  return `ai-conventional-commit v${pkgVersion}
-
-Usage:
-  ai-conventional-commit [generate] [options]   Generate a commit (default)
-  ai-conventional-commit split [options]        Propose multiple commits
-  ai-conventional-commit refine [options]       Refine last or indexed commit
-
-Global Options:
-  -m, --model <provider/name>   Override model provider/name
-  --gitmoji[-pure]              Gitmoji modes: emoji + type (default) or pure emoji only
-  -h, --help                    Show this help
-  -V, --version                 Show version
-
-Refine Options:
-  --shorter / --longer          Adjust message length
-  --scope <scope>               Add or replace scope
-  --emoji                       Add suitable gitmoji
-  --index <n>                   Select commit index
-
-Examples:
-  ai-conventional-commit --gitmoji
-  ai-conventional-commit --gitmoji-pure
-  ai-conventional-commit split --max 3 --gitmoji
-  ai-conventional-commit refine --scope api --emoji
-`;
-}
 var VersionCommand = class extends Command {
   static paths = [[`--version`], [`-V`]];
   async execute() {
@@ -1354,10 +1528,14 @@ var cli = new Cli({
   binaryName: "ai-conventional-commit",
   binaryVersion: pkgVersion
 });
+cli.register(RootCommand);
 cli.register(GenerateCommand);
 cli.register(SplitCommand);
 cli.register(RefineCommand);
-cli.register(HelpCommand);
+cli.register(ModelsCommand);
+cli.register(ConfigShowCommand);
+cli.register(ConfigGetCommand);
+cli.register(ConfigSetCommand);
 cli.register(VersionCommand);
 cli.runExit(process.argv.slice(2), {
   stdin: process.stdin,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kud/ai-conventional-commit-cli",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "type": "module",
   "description": "Opinionated, style-aware AI assistant for crafting and splitting git commits (opencode-based, provider-agnostic).",
   "bin": {