@dharminnagar/bruh 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HeyG contributors
+
+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,111 @@
+# bruh - Git Commit Summarizer
+
+A Bun CLI that explains what changed in git history after a base commit by combining:
+
+- Commit messages
+- Full commit diffs (with safe truncation for large patches)
+- AI-generated analysis (OpenAI, Claude, or Cloudflare Workers AI)
+
+## Install
+
+Prerequisite: Bun must be installed on the machine where `bruh` runs.
+
+Global install from npm:
+
+```bash
+npm install -g bruh
+```
+
+Or run without installing globally:
+
+```bash
+npx bruh --help
+```
+
+For local development in this repo:
+
+```bash
+bun install
+```
+
+## First-run setup
+
+Run interactive setup once:
+
+```bash
+bruh --init
+```
+
+Interactive prompts use `@clack/prompts` and setup now provides provider-specific model choices from a list (with a custom model option). For Cloudflare, model choices are fetched dynamically from your account when available, with built-in fallback options.
+
+This stores provider and API key in a local config file:
+
+- macOS: `~/Library/Application Support/bruh/config.json`
+- Linux: `$XDG_CONFIG_HOME/bruh/config.json` or `~/.config/bruh/config.json`
+
+If config is deleted or key is missing, setup is prompted again automatically.
+
+## Usage
+
+Analyze commits after a base commit hash:
+
+```bash
+bruh --commit <commit-hash>
+```
+
+or positional style:
+
+```bash
+bruh <commit-hash>
+```
+
+### Options
+
+- `-c, --commit <hash>`: base commit hash
+- `-p, --provider <name>`: `openai | claude | cloudflare`
+- `-k, --api-key <key>`: override API key for current run
+- `-m, --model <model>`: override model for current run
+- `--config <path>`: custom config path
+- `-f, --format <format>`: `text | json | markdown` (default: `text`)
+- `-o, --output <path>`: write report to a file
+- `--init`: run interactive setup
+- `-h, --help`: help text
+
+## Output formats
+
+- `text`: human-readable terminal report
+- `json`: machine-readable report for automation
+- `markdown`: markdown report for docs/changelogs
+
+In interactive terminals, the CLI now includes progress indicators for key analysis stages and a visually clearer text report hierarchy for faster scanning.
+When output is non-interactive (for example piped in CI), it falls back to plain deterministic logs.
+
+Example markdown export:
+
+```bash
+bruh <commit-hash> --format markdown --output commit-report.md
+```
+
+## Provider notes
+
+- OpenAI uses `https://api.openai.com/v1/chat/completions`
+- Claude uses `https://api.anthropic.com/v1/messages`
+- Cloudflare Workers AI requires both API token and account ID
+
+For Cloudflare, setup prompts for account ID and stores it in config.
+
+## Development
+
+```bash
+bun run check
+bun run lint
+bun run start -- --help
+```
+
+### Help and recipes
+
+```bash
+bun run src/index.ts --help
+```
+
+The help output includes a quick-start path and common recipes for setup, analysis, and exports.

package/dist/args.d.ts

@@ -0,0 +1,4 @@
+import type { CliArgs } from './types';
+export declare function parseArgs(argv: string[]): CliArgs;
+export declare function usageText(): string;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA0B,MAAM,SAAS,CAAC;AAqB/D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CA6FjD;AAED,wBAAgB,SAAS,IAAI,MAAM,CAiClC"}

package/dist/args.js

@@ -0,0 +1,136 @@
+const SUPPORTED_PROVIDERS = ['openai', 'claude', 'cloudflare'];
+const SUPPORTED_FORMATS = ['text', 'json', 'markdown'];
+function isProvider(value) {
+    return SUPPORTED_PROVIDERS.includes(value);
+}
+function isFormat(value) {
+    return SUPPORTED_FORMATS.includes(value);
+}
+function readValue(argv, index, flag) {
+    const nextValue = argv[index + 1];
+    if (!nextValue || nextValue.startsWith('-')) {
+        throw new Error(`Missing value for ${flag}`);
+    }
+    return nextValue;
+}
+export function parseArgs(argv) {
+    let commit;
+    let provider;
+    let apiKey;
+    let model;
+    let configPath;
+    let format = 'text';
+    let outputPath;
+    let init = false;
+    let help = false;
+    for (let i = 0; i < argv.length; i += 1) {
+        const token = argv[i];
+        if (!token.startsWith('-')) {
+            if (!commit) {
+                commit = token;
+            }
+            continue;
+        }
+        switch (token) {
+            case '-h':
+            case '--help':
+                help = true;
+                break;
+            case '--init':
+                init = true;
+                break;
+            case '-c':
+            case '--commit':
+                commit = readValue(argv, i, token);
+                i += 1;
+                break;
+            case '-p':
+            case '--provider': {
+                const value = readValue(argv, i, token).toLowerCase();
+                if (!isProvider(value)) {
+                    throw new Error(`Unsupported provider "${value}". Use one of: ${SUPPORTED_PROVIDERS.join(', ')}`);
+                }
+                provider = value;
+                i += 1;
+                break;
+            }
+            case '-k':
+            case '--api-key':
+                apiKey = readValue(argv, i, token);
+                i += 1;
+                break;
+            case '-m':
+            case '--model':
+                model = readValue(argv, i, token);
+                i += 1;
+                break;
+            case '--config':
+                configPath = readValue(argv, i, token);
+                i += 1;
+                break;
+            case '-f':
+            case '--format': {
+                const value = readValue(argv, i, token).toLowerCase();
+                if (!isFormat(value)) {
+                    throw new Error(`Unsupported format "${value}". Use one of: ${SUPPORTED_FORMATS.join(', ')}`);
+                }
+                format = value;
+                i += 1;
+                break;
+            }
+            case '-o':
+            case '--output':
+                outputPath = readValue(argv, i, token);
+                i += 1;
+                break;
+            default:
+                throw new Error(`Unknown flag: ${token}`);
+        }
+    }
+    return {
+        commit,
+        provider,
+        apiKey,
+        model,
+        configPath,
+        format,
+        outputPath,
+        init,
+        help,
+    };
+}
+export function usageText() {
+    return [
+        'bruh - Git Commit Summarizer',
+        '',
+        'Understand what changed after a base commit using AI-powered release analysis.',
+        '',
+        'Usage:',
+        '  bun run src/index.ts --commit <commit-hash> [options]',
+        '  bun run src/index.ts <commit-hash> [options]',
+        '',
+        'Quick Start:',
+        '  1) Configure provider credentials once:',
+        '     bun run src/index.ts --init',
+        '  2) Analyze commits after a base commit:',
+        '     bun run src/index.ts --commit <commit-hash>',
+        '',
+        'Examples:',
+        '  bun run src/index.ts 9f13c4a',
+        '  bun run src/index.ts --commit 9f13c4a --provider claude',
+        '  bun run src/index.ts 9f13c4a --format markdown --output report.md',
+        '  bun run src/index.ts 9f13c4a --format json',
+        '',
+        'Options:',
+        '  -c, --commit <hash>      Base commit hash (analyze commits after this)',
+        '  -p, --provider <name>    openai | claude | cloudflare',
+        '  -k, --api-key <key>      Override API key for this run',
+        '  -m, --model <model>      Override model for this run',
+        '      --config <path>      Custom config file path',
+        '  -f, --format <format>    text | json | markdown (default: text)',
+        '  -o, --output <path>      Write report to file',
+        '      --init               Run interactive setup and save config',
+        '  -h, --help               Show help',
+    ].join('\n');
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAEA,MAAM,mBAAmB,GAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;AAC3E,MAAM,iBAAiB,GAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AAEvE,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,mBAAmB,CAAC,QAAQ,CAAC,KAAiB,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,iBAAiB,CAAC,QAAQ,CAAC,KAAqB,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,SAAS,CAAC,IAAc,EAAE,KAAa,EAAE,IAAY;IAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAClC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,IAAI,MAA0B,CAAC;IAC/B,IAAI,QAA8B,CAAC;IACnC,IAAI,MAA0B,CAAC;IAC/B,IAAI,KAAyB,CAAC;IAC9B,IAAI,UAA8B,CAAC;IACnC,IAAI,MAAM,GAAiB,MAAM,CAAC;IAClC,IAAI,UAA8B,CAAC;IACnC,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,IAAI,GAAG,KAAK,CAAC;IAEjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEtB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,KAAK,CAAC;YACjB,CAAC;YACD,SAAS;QACX,CAAC;QAED,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ;gBACX,IAAI,GAAG,IAAI,CAAC;gBACZ,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,GAAG,IAAI,CAAC;gBACZ,MAAM;YACR,KAAK,IAAI,CAAC;YACV,KAAK,UAAU;gBACb,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;gBACnC,CAAC,IAAI,CAAC,CAAC;gBACP,MAAM;YACR,KAAK,IAAI,CAAC;YACV,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;gBACtD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;oBACvB,MAAM,IAAI,KAAK,CACb,yBAAyB,KAAK,kBAAkB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjF,CAAC;gBACJ,CAAC;gBACD,QAAQ,GAAG,KAAK,CAAC;gBACjB,CAAC,IAAI,CAAC,CAAC;gBACP,MAAM;YACR,CAAC;YACD,KAAK,IAAI,CAAC;YACV,KAAK,WAAW;gBACd,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;gBACnC,CAAC,IAAI,CAAC,CAAC;gBACP,MAAM;YACR,KAAK,IAAI,CAAC;YACV,KAAK,SAAS;gBACZ,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;gBAClC,CAAC,IAAI,CAAC,CAAC;gBACP,MAAM;YACR,KAAK,UAAU;gBACb,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;gBACvC,CAAC,IAAI,CAAC,CAAC;gBACP,MAAM;YACR,KAAK,IAAI,CAAC;YACV,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;gBACtD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACrB,MAAM,IAAI,KAAK,CACb,uBAAuB,KAAK,kBAAkB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7E,CAAC;gBACJ,CAAC;gBACD,MAAM,GAAG,KAAK,CAAC;gBACf,CAAC,IAAI,CAAC,CAAC;gBACP,MAAM;YACR,CAAC;YACD,KAAK,IAAI,CAAC;YACV,KAAK,UAAU;gBACb,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;gBACvC,CAAC,IAAI,CAAC,CAAC;gBACP,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM;QACN,QAAQ;QACR,MAAM;QACN,KAAK;QACL,UAAU;QACV,MAAM;QACN,UAAU;QACV,IAAI;QACJ,IAAI;KACL,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO;QACL,8BAA8B;QAC9B,EAAE;QACF,gFAAgF;QAChF,EAAE;QACF,QAAQ;QACR,yDAAyD;QACzD,gDAAgD;QAChD,EAAE;QACF,cAAc;QACd,2CAA2C;QAC3C,kCAAkC;QAClC,2CAA2C;QAC3C,kDAAkD;QAClD,EAAE;QACF,WAAW;QACX,gCAAgC;QAChC,2DAA2D;QAC3D,qEAAqE;QACrE,8CAA8C;QAC9C,EAAE;QACF,UAAU;QACV,0EAA0E;QAC1E,yDAAyD;QACzD,0DAA0D;QAC1D,wDAAwD;QACxD,oDAAoD;QACpD,mEAAmE;QACnE,iDAAiD;QACjD,kEAAkE;QAClE,sCAAsC;KACvC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+import './index';
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,SAAS,CAAC"}

package/dist/cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+import './index';
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,SAAS,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,10 @@
+import type { Provider, ProviderContext, StoredConfig } from './types';
+export declare function resolveConfigPath(customPath?: string): string;
+export declare function loadConfig(configPath: string): Promise<StoredConfig | null>;
+export declare function saveConfig(configPath: string, config: StoredConfig): Promise<void>;
+export declare function mergeProviderContext(provider: Provider, storedConfig: StoredConfig, overrides: {
+    apiKey?: string;
+    model?: string;
+}): ProviderContext;
+export declare function runInteractiveSetup(current?: Partial<StoredConfig>): Promise<StoredConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA8dvE,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAyB9B;AAED,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAMf;AAeD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,eAAe,CAejB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,OAAO,CAAC,YAAY,CAAC,CAuEvB"}