@johnowennixon/diffdash 1.4.0 → 1.5.0

package/README.md

@@ -12,6 +12,7 @@ A command-line tool to generate Git commit messages using AI.
 * Able to add a prefix or suffix to the summary line
 * Optionally select from a choice of LLM models
 * Compare messages generated from all configured models
+* Can just output the commit message for use in scripts
 * Configuration using standard API provider environment variables
 * Uses the Vercel AI SDK
 * Uses structured JSON with compatible models
@@ -59,12 +60,6 @@ export GEMINI_API_KEY=your-api-key
 # Basic usage (uses defaults)
 diffdash
 
-# Add a prefix to the commit message summary line
-diffdash --add-prefix "[FIX]"
-
-# Add a suffix to the commit message summary line
-diffdash --add-suffix "(closes #123)"
-
 # Automatically stage all changes, but still prompt for commit and push
 diffdash --auto-add
 
@@ -92,6 +87,12 @@ diffdash --disable-push
 # Skip git hooks when pushing
 diffdash --no-verify
 
+# Add a prefix to the commit message summary line
+diffdash --add-prefix "[FIX]"
+
+# Add a suffix to the commit message summary line
+diffdash --add-suffix "(closes #123)"
+
 # Display commit messages generated by all models
 diffdash --llm-compare
 
@@ -101,6 +102,9 @@ diffdash --llm-fallback
 # Specify the LLM model by name
 diffdash --llm-model claude-3.5-haiku
 
+# Just output the commit message for use in scripts
+diffdash --just-output
+
 # Debug options
 diffdash --debug-llm-inputs --debug-llm-outputs
 ```
@@ -113,8 +117,6 @@ All command-line arguments are optional.
 |--------|-------------|
 | `--help` | show a help message and exit |
 | `--version` | show program version information and exit |
-| `--add-prefix PREFIX` | add a prefix to the commit message summary line |
-| `--add-suffix SUFFIX` | add a suffix to the commit message summary line |
 | `--auto-add` | automatically stage all changes without confirmation |
 | `--auto-commit` | automatically commit changes without confirmation |
 | `--auto-push` | automatically push changes after commit without confirmation |
@@ -125,12 +127,15 @@ All command-line arguments are optional.
 | `--disable-push` | disable pushing changes - exit after making the commit |
 | `--push-no-verify` | bypass git hooks when pushing to Git |
 | `--push-force` | apply force when pushing to Git |
+| `--add-prefix PREFIX` | add a prefix to the commit message summary line |
+| `--add-suffix SUFFIX` | add a suffix to the commit message summary line |
 | `--llm-list` | display a list of available Large Language Models and exit |
 | `--llm-compare` | compare the generated messages from all models - but do not commit |
 | `--llm-router` | prefer to access the LLM via a router rather than direct |
 | `--llm-fallback` | use the fallback LLM model instead of the default |
 | `--llm-model MODEL` | choose the LLM model by name (the default is normally best) |
 | `--llm-excludes MODELS` | models to exclude from comparison (comma separated) |
+| `--just-output` | just output the commit message for use in scripts |
 | `--silent` | suppress all normal output - errors and aborts still display |
 | `--debug-llm-inputs` | show inputs (including all prompts) sent to the LLM |
 | `--debug-llm-outputs` | show outputs received from the LLM |

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@johnowennixon/diffdash",
-    "version": "1.3.0",
+    "version": "1.5.0",
     "description": "A command-line tool to generate Git commit messages using AI",
     "license": "0BSD",
     "author": "John Owen Nixon",
@@ -41,7 +41,7 @@
     "dependencies": {
         "@ai-sdk/anthropic": "1.2.12",
         "@ai-sdk/deepseek": "0.2.14",
-        "@ai-sdk/google": "1.2.21",
+        "@ai-sdk/google": "1.2.22",
         "@ai-sdk/openai": "1.3.22",
         "@openrouter/ai-sdk-provider": "0.7.2",
         "@requesty/ai-sdk": "0.0.9",
@@ -55,15 +55,15 @@
     "devDependencies": {
         "@biomejs/biome": "2.0.6",
         "@eslint/eslintrc": "3.3.1",
-        "@eslint/js": "9.30.0",
+        "@eslint/js": "9.30.1",
         "@johnowennixon/add-shebangs": "1.1.0",
         "@johnowennixon/chmodx": "2.0.0",
         "@stylistic/eslint-plugin": "5.1.0",
         "@types/argparse": "2.0.17",
-        "@types/node": "24.0.8",
+        "@types/node": "24.0.10",
         "@typescript-eslint/eslint-plugin": "8.35.1",
         "@typescript-eslint/parser": "8.35.1",
-        "eslint": "9.30.0",
+        "eslint": "9.30.1",
         "eslint-import-resolver-typescript": "4.4.4",
         "eslint-plugin-import-x": "4.16.1",
         "eslint-plugin-sonarjs": "3.0.4",
@@ -72,7 +72,7 @@
         "knip": "5.61.3",
         "markdownlint-cli2": "0.18.1",
         "npm-run-all2": "8.0.4",
-        "oxlint": "1.4.0",
+        "oxlint": "1.5.0",
         "rimraf": "6.0.1",
         "typescript": "5.8.3",
         "typescript-eslint": "8.35.1"

package/dist/src/diffdash.js

@@ -1,24 +1,26 @@
 #!/usr/bin/env node
 import { ansi_blue, ansi_italic, ansi_red } from "./lib_ansi.js";
 import { diffdash_config_get } from "./lib_diffdash_config.js";
-import { diffdash_sequence_compare, diffdash_sequence_normal } from "./lib_diffdash_sequence.js";
+import { diffdash_sequence_compare, diffdash_sequence_normal, diffdash_sequence_output } from "./lib_diffdash_sequence.js";
 import { error_abort } from "./lib_error.js";
 import { tell_okay, tell_plain } from "./lib_tell.js";
 async function main() {
     const config = diffdash_config_get();
-    const { llm_compare, silent } = config;
-    if (!silent) {
+    const { silent, just_output, llm_compare } = config;
+    if (!silent && !just_output) {
         const diffdash = ansi_italic(ansi_blue("Diff") + ansi_red("Dash"));
         tell_plain(`This is ${diffdash} - the fast AI Git commit tool`);
     }
-    // eslint-disable-next-line unicorn/prefer-ternary
-    if (llm_compare) {
+    if (just_output) {
+        await diffdash_sequence_output(config);
+    }
+    else if (llm_compare) {
         await diffdash_sequence_compare(config);
     }
     else {
         await diffdash_sequence_normal(config);
     }
-    if (!silent) {
+    if (!silent && !just_output) {
         tell_okay();
     }
 }

package/dist/src/lib_diffdash_cli.js

@@ -2,8 +2,6 @@ import { cli_boolean, cli_choice_default, cli_make_parser, cli_string } from "./
 import { diffdash_llm_model_choices, diffdash_llm_model_default, diffdash_llm_model_fallback, } from "./lib_diffdash_llm.js";
 const diffdash_cli_schema = {
     version: cli_boolean({ help: "show program version information and exit" }),
-    add_prefix: cli_string({ help: "add a prefix to the commit message summary line", metavar: "PREFIX" }),
-    add_suffix: cli_string({ help: "add a suffix to the commit message summary line", metavar: "SUFFIX" }),
     auto_add: cli_boolean({ help: "automatically stage all changes without confirmation" }),
     auto_commit: cli_boolean({ help: "automatically commit changes without confirmation" }),
     auto_push: cli_boolean({ help: "automatically push changes after commit without confirmation" }),
@@ -14,6 +12,8 @@ const diffdash_cli_schema = {
     disable_push: cli_boolean({ help: "disable pushing changes - exit after making the commit" }),
     push_no_verify: cli_boolean({ help: "bypass git hooks when pushing to Git" }),
     push_force: cli_boolean({ help: "apply force when pushing to Git" }),
+    add_prefix: cli_string({ help: "add a prefix to the commit message summary line", metavar: "PREFIX" }),
+    add_suffix: cli_string({ help: "add a suffix to the commit message summary line", metavar: "SUFFIX" }),
     llm_list: cli_boolean({ help: "display a list of available Large Language Models and exit" }),
     llm_compare: cli_boolean({ help: "compare the generated messages from all models - but do not commit" }),
     llm_router: cli_boolean({ help: "prefer to access the LLM via a router rather than direct" }),
@@ -24,6 +24,7 @@ const diffdash_cli_schema = {
         default: diffdash_llm_model_default,
     }),
     llm_excludes: cli_string({ help: "models to exclude from comparison (comma separated)", metavar: "MODELS" }),
+    just_output: cli_boolean({ help: "just output the commit message for use in scripts" }),
     silent: cli_boolean({ help: "suppress all normal output - errors and aborts still display" }),
     debug_llm_inputs: cli_boolean({ help: "debug inputs (including all prompts) sent to the LLM" }),
     debug_llm_outputs: cli_boolean({ help: "debug outputs received from the LLM" }),

package/dist/src/lib_diffdash_config.js

@@ -7,7 +7,7 @@ import { PACKAGE_NAME, PACKAGE_VERSION } from "./lib_package.js";
 import { tell_plain } from "./lib_tell.js";
 export function diffdash_config_get() {
     const pa = diffdash_cli_parser.parsed_args;
-    const { version, add_prefix, add_suffix, auto_add, auto_commit, auto_push, disable_add, disable_commit, disable_preview, disable_status, disable_push, push_no_verify, push_force, llm_list, llm_compare, llm_router, llm_fallback, llm_model, llm_excludes, silent, debug_llm_inputs, debug_llm_outputs, } = pa;
+    const { version, auto_add, auto_commit, auto_push, disable_add, disable_commit, disable_preview, disable_status, disable_push, push_no_verify, push_force, add_prefix, add_suffix, llm_list, llm_compare, llm_router, llm_fallback, llm_model, llm_excludes, just_output, silent, debug_llm_inputs, debug_llm_outputs, } = pa;
     if (version) {
         tell_plain(`${PACKAGE_NAME} v${PACKAGE_VERSION}`);
         process.exit(0);
@@ -30,8 +30,6 @@ export function diffdash_config_get() {
     debug_channels.llm_inputs = debug_llm_inputs;
     debug_channels.llm_outputs = debug_llm_outputs;
     const config = {
-        add_prefix,
-        add_suffix,
         auto_add,
         auto_commit,
         auto_push,
@@ -42,9 +40,12 @@ export function diffdash_config_get() {
         disable_push,
         push_no_verify,
         push_force,
+        add_prefix,
+        add_suffix,
         llm_compare,
         llm_config,
         all_llm_configs,
+        just_output,
         silent,
     };
     debug_inspect_when(debug_channels.config, config, "config");

package/dist/src/lib_diffdash_sequence.js

@@ -8,7 +8,7 @@ import { git_message_validate_check, git_message_validate_get_result } from "./l
 import { git_simple_open_check_not_bare, git_simple_open_git_repo } from "./lib_git_simple_open.js";
 import { git_simple_staging_create_commit, git_simple_staging_get_staged_diff, git_simple_staging_get_staged_diffstat, git_simple_staging_has_staged_changes, git_simple_staging_has_unstaged_changes, git_simple_staging_push_to_remote, git_simple_staging_stage_all_changes, } from "./lib_git_simple_staging.js";
 import { llm_config_get_model_via } from "./lib_llm_config.js";
-import { stdio_write_stdout_linefeed } from "./lib_stdio_write.js";
+import { stdio_write_stdout, stdio_write_stdout_linefeed } from "./lib_stdio_write.js";
 import { tell_action, tell_info, tell_plain, tell_success, tell_warning } from "./lib_tell.js";
 import { tui_justify_left } from "./lib_tui_justify.js";
 import { tui_readline_confirm } from "./lib_tui_readline.js";
@@ -115,10 +115,10 @@ async function phase_compare({ config, git }) {
         git_message_display({ git_message, teller });
     }
 }
-async function phase_commit({ config, git }) {
-    const { add_prefix, add_suffix, auto_commit, disable_commit, disable_preview, silent, llm_config } = config;
+async function phase_generate({ config, git }) {
+    const { disable_preview, add_prefix, add_suffix, llm_config, just_output, silent } = config;
     const model_via = llm_config_get_model_via(llm_config);
-    if (!silent) {
+    if (!silent && !just_output) {
         tell_action(`Generating the Git commit message using ${model_via}`);
     }
     const diffstat = await git_simple_staging_get_staged_diffstat(git);
@@ -127,18 +127,22 @@ async function phase_commit({ config, git }) {
     const result = await git_message_generate_result({ llm_config, inputs });
     const { error_text } = result;
     let { git_message } = result;
-    if (error_text) {
+    if (error_text || git_message === null) {
         abort_with_error(`Failed to generate a commit message using ${model_via}: ${error_text}`);
     }
-    if (!git_message) {
-        return;
-    }
     git_message_validate_check(git_message);
     git_message = diffdash_add_prefix_or_suffix({ git_message, add_prefix, add_suffix });
     git_message = diffdash_add_footer({ git_message, llm_config });
-    if (!disable_preview && !silent) {
+    if (just_output) {
+        stdio_write_stdout(git_message);
+    }
+    else if (!disable_preview && !silent) {
         git_message_display({ git_message, teller: tell_plain });
     }
+    return git_message;
+}
+async function phase_commit({ config, git, git_message, }) {
+    const { auto_commit, disable_commit, silent } = config;
     if (disable_commit) {
         return;
     }
@@ -188,9 +192,14 @@ export async function diffdash_sequence_normal(config) {
     const git = await phase_open();
     await phase_add({ config, git });
     await phase_status({ config, git });
-    await phase_commit({ config, git });
+    const git_message = await phase_generate({ config, git });
+    await phase_commit({ config, git, git_message });
     await phase_push({ config, git });
 }
+export async function diffdash_sequence_output(config) {
+    const git = await phase_open();
+    await phase_generate({ config, git });
+}
 export async function diffdash_sequence_compare(config) {
     const git = await phase_open();
     await phase_add({ config, git });

package/dist/src/lib_error.js

@@ -8,6 +8,13 @@ export function error_console(error) {
 export function error_get_text(error) {
     return error instanceof Error ? `${error.name}: ${error.message}` : String(error);
 }
+export function error_get_message(error) {
+    return error instanceof Error
+        ? error.name === "Error"
+            ? error.message
+            : `${error.name}: ${error.message}`
+        : String(error);
+}
 export function error_abort(error) {
     const message = `Unhandled error: ${error_get_text(error)}`;
     abort_with_error(message);

package/dist/src/lib_llm_model.js

@@ -192,7 +192,7 @@ const LLM_MODEL_DETAILS = [
         llm_provider: null,
         llm_model_code_direct: "grok-3",
         llm_model_code_requesty: "xai/grok-3-beta",
-        llm_model_code_openrouter: "x-ai/grok-3-beta",
+        llm_model_code_openrouter: "x-ai/grok-3",
         context_window: 131_072,
         cents_input: 300,
         cents_output: 1500,
@@ -203,12 +203,23 @@ const LLM_MODEL_DETAILS = [
         llm_provider: null,
         llm_model_code_direct: "grok-3-mini",
         llm_model_code_requesty: "xai/grok-3-mini-beta",
-        llm_model_code_openrouter: "x-ai/grok-3-mini-beta",
+        llm_model_code_openrouter: "x-ai/grok-3-mini",
         context_window: 131_072,
         cents_input: 30,
         cents_output: 50,
         has_structured_json: true,
     },
+    {
+        llm_model_name: "grok-4",
+        llm_provider: null,
+        llm_model_code_direct: "grok-4",
+        llm_model_code_requesty: "xai/grok-4",
+        llm_model_code_openrouter: "x-ai/grok-4",
+        context_window: 256_000,
+        cents_input: 300,
+        cents_output: 1500,
+        has_structured_json: true,
+    },
     {
         llm_model_name: "llama-4-maverick",
         llm_provider: null,
@@ -232,7 +243,18 @@ const LLM_MODEL_DETAILS = [
         has_structured_json: true,
     },
     {
-        llm_model_name: "mercury-coder-small",
+        llm_model_name: "mercury",
+        llm_provider: null,
+        llm_model_code_direct: null,
+        llm_model_code_requesty: null,
+        llm_model_code_openrouter: "inception/mercury",
+        context_window: 32_000,
+        cents_input: 25,
+        cents_output: 100,
+        has_structured_json: false,
+    },
+    {
+        llm_model_name: "mercury-coder",
         llm_provider: null,
         llm_model_code_direct: null,
         llm_model_code_requesty: null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johnowennixon/diffdash",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "A command-line tool to generate Git commit messages using AI",
   "license": "0BSD",
   "author": "John Owen Nixon",
@@ -21,7 +21,7 @@
   "dependencies": {
     "@ai-sdk/anthropic": "1.2.12",
     "@ai-sdk/deepseek": "0.2.14",
-    "@ai-sdk/google": "1.2.21",
+    "@ai-sdk/google": "1.2.22",
     "@ai-sdk/openai": "1.3.22",
     "@openrouter/ai-sdk-provider": "0.7.2",
     "@requesty/ai-sdk": "0.0.9",
@@ -35,15 +35,15 @@
   "devDependencies": {
     "@biomejs/biome": "2.0.6",
     "@eslint/eslintrc": "3.3.1",
-    "@eslint/js": "9.30.0",
+    "@eslint/js": "9.30.1",
     "@johnowennixon/add-shebangs": "1.1.0",
     "@johnowennixon/chmodx": "2.0.0",
     "@stylistic/eslint-plugin": "5.1.0",
     "@types/argparse": "2.0.17",
-    "@types/node": "24.0.8",
+    "@types/node": "24.0.10",
     "@typescript-eslint/eslint-plugin": "8.35.1",
     "@typescript-eslint/parser": "8.35.1",
-    "eslint": "9.30.0",
+    "eslint": "9.30.1",
     "eslint-import-resolver-typescript": "4.4.4",
     "eslint-plugin-import-x": "4.16.1",
     "eslint-plugin-sonarjs": "3.0.4",
@@ -52,7 +52,7 @@
     "knip": "5.61.3",
     "markdownlint-cli2": "0.18.1",
     "npm-run-all2": "8.0.4",
-    "oxlint": "1.4.0",
+    "oxlint": "1.5.0",
     "rimraf": "6.0.1",
     "typescript": "5.8.3",
     "typescript-eslint": "8.35.1"