gitmage 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 long260398
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,118 @@
+# gitmage
+
+> Generate conventional commit messages from staged changes using AI — free with Groq, or higher quality with Claude.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![npm version](https://img.shields.io/npm/v/gitmage.svg)](https://www.npmjs.com/package/gitmage)
+[![Node.js](https://img.shields.io/badge/Node.js-18%2B-green)](https://nodejs.org)
+
+## Demo
+
+```bash
+$ git add src/auth.ts
+$ gitmage
+
+  gitmage  ·  AI-powered git commits
+
+  ⠙ Generating commit message...
+
+  ✔ Suggested commit message:
+
+  ❯ feat(auth): add JWT token validation middleware
+
+  Press Enter to confirm, or type to edit (Ctrl+C to cancel):
+  >
+
+  ✔ Committed: feat(auth): add JWT token validation middleware
+```
+
+## Features
+
+- **Zero configuration** — set your API key once, run `gitmage` anywhere
+- **Always conventional** — follows `feat/fix/docs/chore` format automatically
+- **Edit before commit** — review and change the message before it lands
+- **Dry run mode** — preview without committing: `gitmage --dry-run`
+- **Works with any stack** — language and framework agnostic
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 18+
+- An API key — **Groq is free**, Claude is paid but higher quality
+
+### Install
+
+```bash
+npm install -g gitmage
+```
+
+Or try without installing:
+
+```bash
+npx gitmage --dry-run
+```
+
+### Set your API key
+
+**Option 1 — Groq (free):** [console.groq.com](https://console.groq.com)
+
+```bash
+# Mac / Linux
+export GROQ_API_KEY=gsk_your-key-here
+
+# Windows PowerShell
+$env:GROQ_API_KEY="gsk_your-key-here"
+```
+
+**Option 2 — Claude (higher quality):** [console.anthropic.com](https://console.anthropic.com) — ~$0.0001/commit
+
+```bash
+# Mac / Linux
+export ANTHROPIC_API_KEY=sk-ant-your-key-here
+
+# Windows PowerShell
+$env:ANTHROPIC_API_KEY="sk-ant-your-key-here"
+```
+
+The tool auto-detects which key is set. Set one and run.
+
+## Usage
+
+Stage your changes, then run:
+
+```bash
+git add .
+gitmage
+```
+
+Preview without committing:
+
+```bash
+gitmage --dry-run
+```
+
+Check version:
+
+```bash
+gitmage --version
+```
+
+## Stack
+
+- **Runtime**: Node.js 18+
+- **Language**: TypeScript
+- **AI**: Groq (Llama 3.3, free) or Claude Haiku (paid)
+- **Format**: Conventional Commits
+
+## Contributing
+
+Pull requests are welcome. For major changes, open an issue first.
+
+## License
+
+[MIT](LICENSE)
+
+## Support
+
+If this saves you time on every commit, consider [sponsoring on GitHub](https://github.com/sponsors/long260398).

package/bin/ai-commit

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+'use strict';
+require('../dist/index.js');

package/dist/ai.d.ts

@@ -0,0 +1,2 @@
+import { Config } from './config';
+export declare function generateMessage(diff: string, config: Config): Promise<string>;

package/dist/ai.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateMessage = generateMessage;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const groq_sdk_1 = __importDefault(require("groq-sdk"));
+const prompt_1 = require("./prompt");
+const MAX_DIFF_CHARS = 8000;
+async function generateMessage(diff, config) {
+    const truncated = diff.length > MAX_DIFF_CHARS
+        ? diff.slice(0, MAX_DIFF_CHARS) + '\n\n[diff truncated]'
+        : diff;
+    const userMessage = `Generate a commit message for this diff:\n\n${truncated}`;
+    if (config.provider === 'groq') {
+        return generateWithGroq(userMessage, config.apiKey);
+    }
+    return generateWithClaude(userMessage, config.apiKey);
+}
+async function generateWithGroq(userMessage, apiKey) {
+    const client = new groq_sdk_1.default({ apiKey });
+    const response = await client.chat.completions.create({
+        model: 'llama-3.3-70b-versatile',
+        max_tokens: 100,
+        messages: [
+            { role: 'system', content: prompt_1.SYSTEM_PROMPT },
+            { role: 'user', content: userMessage },
+        ],
+    });
+    const text = response.choices[0]?.message?.content;
+    if (!text) {
+        throw new Error('Empty response from Groq API');
+    }
+    return text.trim();
+}
+async function generateWithClaude(userMessage, apiKey) {
+    const client = new sdk_1.default({ apiKey });
+    const response = await client.messages.create({
+        model: 'claude-haiku-4-5-20251001',
+        max_tokens: 100,
+        system: prompt_1.SYSTEM_PROMPT,
+        messages: [{ role: 'user', content: userMessage }],
+    });
+    const block = response.content[0];
+    if (block.type !== 'text') {
+        throw new Error('Unexpected response type from Claude API');
+    }
+    return block.text.trim();
+}
+//# sourceMappingURL=ai.js.map

package/dist/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":";;;;;AAOA,0CAaC;AApBD,4DAA0C;AAC1C,wDAA4B;AAC5B,qCAAyC;AAGzC,MAAM,cAAc,GAAG,IAAI,CAAC;AAErB,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,MAAc;IAChE,MAAM,SAAS,GACb,IAAI,CAAC,MAAM,GAAG,cAAc;QAC1B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,GAAG,sBAAsB;QACxD,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,WAAW,GAAG,+CAA+C,SAAS,EAAE,CAAC;IAE/E,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,WAAmB,EAAE,MAAc;IACjE,MAAM,MAAM,GAAG,IAAI,kBAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAEpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QACpD,KAAK,EAAE,yBAAyB;QAChC,UAAU,EAAE,GAAG;QACf,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,sBAAa,EAAE;YAC1C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE;SACvC;KACF,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC;IACnD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;AACrB,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,WAAmB,EAAE,MAAc;IACnE,MAAM,MAAM,GAAG,IAAI,aAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAEzC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC5C,KAAK,EAAE,2BAA2B;QAClC,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,sBAAa;QACrB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;KACnD,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+export type Provider = 'groq' | 'claude';
+export interface Config {
+    provider: Provider;
+    apiKey: string;
+}
+export declare function getConfig(): Config;

package/dist/config.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfig = getConfig;
+const chalk_1 = __importDefault(require("chalk"));
+function getConfig() {
+    const groqKey = process.env.GROQ_API_KEY;
+    const claudeKey = process.env.ANTHROPIC_API_KEY;
+    if (groqKey) {
+        return { provider: 'groq', apiKey: groqKey };
+    }
+    if (claudeKey) {
+        return { provider: 'claude', apiKey: claudeKey };
+    }
+    console.error(chalk_1.default.red('\n  Error: No API key found.\n'));
+    console.error(chalk_1.default.bold('  Option 1 — Groq (free):'));
+    console.error(chalk_1.default.dim('    Sign up  : https://console.groq.com'));
+    console.error(chalk_1.default.dim('    Mac/Linux: export GROQ_API_KEY=gsk_...'));
+    console.error(chalk_1.default.dim('    Windows  : $env:GROQ_API_KEY="gsk_..."\n'));
+    console.error(chalk_1.default.bold('  Option 2 — Claude (paid, higher quality):'));
+    console.error(chalk_1.default.dim('    Sign up  : https://console.anthropic.com'));
+    console.error(chalk_1.default.dim('    Mac/Linux: export ANTHROPIC_API_KEY=sk-ant-...'));
+    console.error(chalk_1.default.dim('    Windows  : $env:ANTHROPIC_API_KEY="sk-ant-..."\n'));
+    process.exit(1);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;AASA,8BAsBC;AA/BD,kDAA0B;AAS1B,SAAgB,SAAS;IACvB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAEhD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACnD,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC,CAAC;IACzE,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC,CAAC;IACzE,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC,CAAC;IACzE,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC,CAAC;IAC/E,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC,CAAC;IACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/git.d.ts

@@ -0,0 +1,3 @@
+export declare function isGitRepo(): boolean;
+export declare function getStagedDiff(): string;
+export declare function runCommit(message: string): void;

package/dist/git.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGitRepo = isGitRepo;
+exports.getStagedDiff = getStagedDiff;
+exports.runCommit = runCommit;
+const child_process_1 = require("child_process");
+function isGitRepo() {
+    try {
+        (0, child_process_1.execSync)('git rev-parse --git-dir', { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getStagedDiff() {
+    const result = (0, child_process_1.spawnSync)('git', ['diff', '--staged'], { encoding: 'utf-8' });
+    if (result.error) {
+        throw new Error('git not found. Please install git and try again.');
+    }
+    return result.stdout;
+}
+function runCommit(message) {
+    const result = (0, child_process_1.spawnSync)('git', ['commit', '-m', message], { stdio: 'inherit' });
+    if (result.status !== 0) {
+        throw new Error('git commit failed');
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":";;AAEA,8BAOC;AAED,sCAQC;AAED,8BAMC;AA3BD,iDAAoD;AAEpD,SAAgB,SAAS;IACvB,IAAI,CAAC;QACH,IAAA,wBAAQ,EAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAgB,aAAa;IAC3B,MAAM,MAAM,GAAG,IAAA,yBAAS,EAAC,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAE7E,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED,SAAgB,SAAS,CAAC,OAAe;IACvC,MAAM,MAAM,GAAG,IAAA,yBAAS,EAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAEjF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chalk_1 = __importDefault(require("chalk"));
+const package_json_1 = require("../package.json");
+const git_1 = require("./git");
+const ai_1 = require("./ai");
+const config_1 = require("./config");
+const ui_1 = require("./ui");
+const args = process.argv.slice(2);
+const isDryRun = args.includes('--dry-run') || args.includes('-d');
+const isVersion = args.includes('--version') || args.includes('-v');
+async function main() {
+    if (isVersion) {
+        console.log(package_json_1.version);
+        process.exit(0);
+    }
+    (0, ui_1.printHeader)();
+    if (!(0, git_1.isGitRepo)()) {
+        console.error(chalk_1.default.red('  Error: not a git repository.\n'));
+        process.exit(1);
+    }
+    const diff = (0, git_1.getStagedDiff)();
+    if (!diff.trim()) {
+        console.log(chalk_1.default.yellow('  Nothing staged.') +
+            chalk_1.default.dim(' Run ') +
+            chalk_1.default.white('git add <files>') +
+            chalk_1.default.dim(' first.\n'));
+        process.exit(0);
+    }
+    const config = (0, config_1.getConfig)();
+    const stopSpinner = (0, ui_1.startSpinner)(`Generating via ${config.provider}...`);
+    let message;
+    try {
+        message = await (0, ai_1.generateMessage)(diff, config);
+    }
+    catch (err) {
+        stopSpinner();
+        const text = err instanceof Error ? err.message : String(err);
+        console.error(chalk_1.default.red(`\n  Error: ${text}\n`));
+        process.exit(1);
+    }
+    stopSpinner();
+    (0, ui_1.printSuggestion)(message);
+    if (isDryRun) {
+        console.log(chalk_1.default.dim('  Dry run — no commit created.\n'));
+        process.exit(0);
+    }
+    const confirmed = await (0, ui_1.confirmMessage)(message);
+    if (confirmed === null) {
+        console.log(chalk_1.default.dim('\n  Cancelled.\n'));
+        process.exit(0);
+    }
+    try {
+        (0, git_1.runCommit)(confirmed);
+        console.log(chalk_1.default.green('\n  ✔ Committed: ') + chalk_1.default.bold(confirmed) + '\n');
+    }
+    catch (err) {
+        const text = err instanceof Error ? err.message : String(err);
+        console.error(chalk_1.default.red(`\n  Commit failed: ${text}\n`));
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error(chalk_1.default.red(`\n  Fatal: ${err instanceof Error ? err.message : String(err)}\n`));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/prompt.d.ts

@@ -0,0 +1 @@
+export declare const SYSTEM_PROMPT = "You are an expert at writing git commit messages following the Conventional Commits specification.\n\nGiven a git diff, generate exactly one commit message that:\n- Follows the format: <type>(<optional scope>): <short description>\n- Uses one of these types: feat, fix, docs, style, refactor, chore, test, perf, ci, build\n- Description uses imperative mood (\"add\" not \"added\"), lowercase, no trailing period\n- Is under 72 characters total\n- Scope is optional \u2014 derive it from the primary file or module changed\n\nExamples:\n- feat(auth): add JWT refresh token rotation\n- fix(api): handle null response from user service\n- docs: add installation steps to README\n- chore: upgrade eslint to v9\n- refactor(db): extract query builder into separate module\n\nOutput ONLY the commit message. No explanation. No markdown. No quotes. No newlines.";

package/dist/prompt.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SYSTEM_PROMPT = void 0;
+exports.SYSTEM_PROMPT = `You are an expert at writing git commit messages following the Conventional Commits specification.
+
+Given a git diff, generate exactly one commit message that:
+- Follows the format: <type>(<optional scope>): <short description>
+- Uses one of these types: feat, fix, docs, style, refactor, chore, test, perf, ci, build
+- Description uses imperative mood ("add" not "added"), lowercase, no trailing period
+- Is under 72 characters total
+- Scope is optional — derive it from the primary file or module changed
+
+Examples:
+- feat(auth): add JWT refresh token rotation
+- fix(api): handle null response from user service
+- docs: add installation steps to README
+- chore: upgrade eslint to v9
+- refactor(db): extract query builder into separate module
+
+Output ONLY the commit message. No explanation. No markdown. No quotes. No newlines.`;
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":";;;AAAa,QAAA,aAAa,GAAG;;;;;;;;;;;;;;;;qFAgBwD,CAAC"}

package/dist/ui.d.ts

@@ -0,0 +1,5 @@
+export declare function printHeader(): void;
+export declare function startSpinner(text: string): () => void;
+export declare function printSuggestion(message: string): void;
+export declare function printSuccess(message: string): void;
+export declare function confirmMessage(suggested: string): Promise<string | null>;

package/dist/ui.js

@@ -0,0 +1,88 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printHeader = printHeader;
+exports.startSpinner = startSpinner;
+exports.printSuggestion = printSuggestion;
+exports.printSuccess = printSuccess;
+exports.confirmMessage = confirmMessage;
+const chalk_1 = __importDefault(require("chalk"));
+const readline = __importStar(require("readline"));
+function printHeader() {
+    console.log(chalk_1.default.bold.cyan('\n  ai-commit') + chalk_1.default.dim('  ·  AI-powered git commits\n'));
+}
+function startSpinner(text) {
+    const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    let i = 0;
+    const interval = setInterval(() => {
+        process.stdout.write(`\r  ${chalk_1.default.cyan(frames[i])} ${chalk_1.default.dim(text)}`);
+        i = (i + 1) % frames.length;
+    }, 80);
+    // Returns a stop function — caller decides when to stop the spinner
+    return () => {
+        clearInterval(interval);
+        process.stdout.write('\r\x1b[K'); // erase the spinner line
+    };
+}
+function printSuggestion(message) {
+    console.log(`  ${chalk_1.default.green('✔')} ${chalk_1.default.bold('Suggested commit message:')}\n`);
+    console.log(`  ${chalk_1.default.cyan('❯')} ${chalk_1.default.white.bold(message)}\n`);
+}
+function printSuccess(message) {
+    console.log(chalk_1.default.green('\n  ✔ Committed: ') + chalk_1.default.bold(message) + '\n');
+}
+async function confirmMessage(suggested) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(chalk_1.default.dim('  Press Enter to confirm, or type to edit (Ctrl+C to cancel):\n  > '), (input) => {
+            rl.close();
+            const trimmed = input.trim();
+            // Empty input = user accepted the suggestion as-is
+            resolve(trimmed === '' ? suggested : trimmed);
+        });
+        rl.on('SIGINT', () => {
+            rl.close();
+            process.stdout.write('\n');
+            resolve(null);
+        });
+    });
+}
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,kCAEC;AAED,oCAcC;AAED,0CAGC;AAED,oCAEC;AAED,wCAuBC;AAvDD,kDAA0B;AAC1B,mDAAqC;AAErC,SAAgB,WAAW;IACzB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,eAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC,CAAC;AAC7F,CAAC;AAED,SAAgB,YAAY,CAAC,IAAY;IACvC,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAClE,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,eAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,eAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,oEAAoE;IACpE,OAAO,GAAG,EAAE;QACV,aAAa,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,yBAAyB;IAC7D,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,eAAe,CAAC,OAAe;IAC7C,OAAO,CAAC,GAAG,CAAC,KAAK,eAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,eAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,CAAC,KAAK,eAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,eAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACrE,CAAC;AAED,SAAgB,YAAY,CAAC,OAAe;IAC1C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,GAAG,eAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AAC7E,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,SAAiB;IACpD,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CACT,eAAK,CAAC,GAAG,CAAC,qEAAqE,CAAC,EAChF,CAAC,KAAK,EAAE,EAAE;YACR,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,mDAAmD;YACnD,OAAO,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAChD,CAAC,CACF,CAAC;QAEF,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACnB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "gitmage",
+  "version": "0.1.0",
+  "description": "Generate conventional commit messages from staged changes using AI",
+  "main": "dist/index.js",
+  "bin": {
+    "gitmage": "bin/ai-commit"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "git",
+    "commit",
+    "ai",
+    "claude",
+    "conventional-commits",
+    "cli",
+    "developer-tools",
+    "anthropic"
+  ],
+  "author": "long260398",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.28.0",
+    "chalk": "^4.1.2",
+    "groq-sdk": "^1.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.4.0"
+  }
+}