ai-cmds 0.4.1 → 0.5.0

package/README.md

@@ -7,7 +7,7 @@ AI-powered CLI tool that uses OpenAI and Google Gemini models to review code cha
 - Multiple AI models: GPT-5, GPT-5-mini, GPT-4o-mini, Gemini 2.5 Pro, Gemini 2.0 Flash
 - Configurable review setups from light to heavy
 - Custom setups with full control over reviewer and validator models
-- Five commands: `commit` for AI commit messages, `review-code-changes` for local development, `advanced-review-changes` for guided/customized local review focus, `review-pr` for CI, `create-pr` for PR creation
+- Six commands: `commit` for AI commit messages, `review-code-changes` for local development, `advanced-review-changes` for guided/customized local review focus, `review-pr` for CI, `create-pr` for PR creation, `set-global-envs` for global API key setup
 - Parallel reviews with a single structured validation pass for higher accuracy
 - Optional provider-aware concurrency limits for reviewer fan-out
 - AI-generated commit messages with interactive editing
@@ -182,6 +182,19 @@ ai-cmds create-pr --title "Fix login validation"
 - Supports `<!-- AI_DESCRIPTION -->` marker in templates for AI content placement
 - Opens GitHub compare URL with pre-filled title and body
 
+### `set-global-envs` - Global API Key Setup
+
+Create a global `.env` file at `~/.config/ai-cmds/.env` for API keys shared across all projects.
+
+```bash
+ai-cmds set-global-envs
+```
+
+**Behavior:**
+- Creates `~/.config/ai-cmds/.env` with commented-out placeholders for `OPENAI_API_KEY`, `GOOGLE_GENERATIVE_AI_API_KEY`, and `AI_CLI_LOGS_DIR`
+- If the file already exists, reports its location without overwriting
+- The global `.env` is loaded as a fallback when no local `.env` file exists in the project root
+
 ## Review Setups
 
 | Setup | Reviewers | Description |
@@ -271,7 +284,7 @@ export default defineConfig({
 });
 ```
 
-By default, `.env` is loaded automatically before the config file is imported, allowing you to reference environment variables in your config.
+By default, `.env` is loaded automatically before the config file is imported, allowing you to reference environment variables in your config. When no local `.env` file exists, the CLI falls back to the global env file at `~/.config/ai-cmds/.env` (see [`set-global-envs`](#set-global-envs---global-api-key-setup)).
 
 ### Configuration Options
 

package/dist/{index-VeIKmeup.d.ts → index.d.mts}

@@ -1,16 +1,13 @@
+import * as _ls_stack_cli0 from "@ls-stack/cli";
 import { JSONValue, LanguageModel } from "ai";
 
 //#region src/lib/config.d.ts
-
 /**
  * Configuration for a custom AI model used in code review.
  */
 type CustomModelConfig = {
-  /** Optional display name for this model in logs and output */
-  label?: string;
-  /** Vercel AI SDK LanguageModel instance (e.g., openai('gpt-5'), google('gemini-2.5-pro')) */
-  model: LanguageModel;
-  /** Provider-specific options passed to the model (e.g., { reasoningEffort: 'high' } for OpenAI) */
+  /** Optional display name for this model in logs and output */label?: string; /** Vercel AI SDK LanguageModel instance (e.g., openai('gpt-5'), google('gemini-2.5-pro')) */
+  model: LanguageModel; /** Provider-specific options passed to the model (e.g., { reasoningEffort: 'high' } for OpenAI) */
   providerOptions?: Record<string, JSONValue>;
 };
 /**
@@ -18,13 +15,9 @@ type CustomModelConfig = {
  * Allows full control over which models are used for each review phase.
  */
 type SetupConfig = {
-  /** Identifier for this setup, used for selection via CLI --setup flag */
-  id: string;
-  /** Display label shown in UI */
-  label: string;
-  /** Models that perform parallel code reviews. At least one reviewer is required. */
-  reviewers: CustomModelConfig[];
-  /** Model that validates and consolidates findings from all reviewers. Defaults to first reviewer if not specified. */
+  /** Identifier for this setup, used for selection via CLI --setup flag */id: string; /** Display label shown in UI */
+  label: string; /** Models that perform parallel code reviews. At least one reviewer is required. */
+  reviewers: CustomModelConfig[]; /** Model that validates and consolidates findings from all reviewers. Defaults to first reviewer if not specified. */
   validator?: CustomModelConfig;
 };
 /**
@@ -37,9 +30,7 @@ type ReviewConcurrencyConfig = number | Record<string, number>;
  * Context provided to scope's getFiles function with all available file lists.
  */
 type ScopeContext = {
-  /** Files currently staged for commit */
-  stagedFiles: string[];
-  /** All files changed compared to base branch (or PR files if reviewing a PR) */
+  /** Files currently staged for commit */stagedFiles: string[]; /** All files changed compared to base branch (or PR files if reviewing a PR) */
   allFiles: string[];
 };
 /**
@@ -47,9 +38,7 @@ type ScopeContext = {
  * Allows defining which files should be included in the review.
  */
 type ScopeConfig = {
-  /** Identifier for this scope, used for selection via CLI --scope flag */
-  id: string;
-  /** Display label shown in UI */
+  /** Identifier for this scope, used for selection via CLI --scope flag */id: string; /** Display label shown in UI */
   label: string;
   /**
    * Which git diff source this scope should use.
@@ -57,8 +46,7 @@ type ScopeConfig = {
    * - `staged` reviews staged changes
    * @default 'branch'
    */
-  diffSource?: 'branch' | 'staged';
-  /** Function that receives available file lists and returns the files to review */
+  diffSource?: 'branch' | 'staged'; /** Function that receives available file lists and returns the files to review */
   getFiles: (ctx: ScopeContext) => string[] | Promise<string[]>;
   showFileCount?: boolean;
 };
@@ -291,18 +279,9 @@ declare const DEFAULT_SCOPES: {
  * ```
  */
 declare const BUILT_IN_SCOPE_OPTIONS: ScopeConfig[];
-/**
- * Resolves a scope by id. Checks custom scopes first, then built-in defaults.
- * Returns undefined if no scope is specified (to trigger interactive selection).
- */
-
 //#endregion
 //#region src/commands/shared/setups.d.ts
-
 declare const BUILT_IN_SETUP_OPTIONS: SetupConfig[];
-/**
- * Converts setup configs to CLI select options.
- */
 //#endregion
 //#region src/commands/advanced-review-changes/advanced-review-changes.d.ts
 declare const advancedReviewChangesCommand: {
@@ -495,4 +474,26 @@ declare const reviewPRCommand: {
   }[] | undefined;
 };
 //#endregion
-export { BUILT_IN_SCOPE_OPTIONS, BUILT_IN_SETUP_OPTIONS, type CommitConfig, type Config, type CreatePRConfig, type CustomModelConfig, DEFAULT_SCOPES, type ReviewCodeChangesConfig, type ReviewConcurrencyConfig, type ScopeConfig, type ScopeContext, type SetupConfig, advancedReviewChangesCommand, commitCommand, createPRCommand, defineConfig, reviewCodeChangesCommand, reviewPRCommand };
+//#region src/commands/set-global-envs/set-global-envs.d.ts
+declare const setGlobalEnvsCommand: {
+  short: string | undefined;
+  description: string;
+  run: (cmdArgs: {
+    [x: string]: string | number | boolean | undefined;
+  } | undefined) => Promise<void> | void;
+  args: Record<string, _ls_stack_cli0.Arg> | undefined;
+  examples: {
+    args: string[];
+    description: string;
+  }[] | undefined;
+};
+//#endregion
+//#region src/lib/global-env.d.ts
+declare function getGlobalEnvPath(): string;
+declare function globalEnvExists(): boolean;
+declare function createGlobalEnvFile(): {
+  created: boolean;
+  path: string;
+};
+//#endregion
+export { BUILT_IN_SCOPE_OPTIONS, BUILT_IN_SETUP_OPTIONS, type CommitConfig, type Config, type CreatePRConfig, type CustomModelConfig, DEFAULT_SCOPES, type ReviewCodeChangesConfig, type ReviewConcurrencyConfig, type ScopeConfig, type ScopeContext, type SetupConfig, advancedReviewChangesCommand, commitCommand, createGlobalEnvFile, createPRCommand, defineConfig, getGlobalEnvPath, globalEnvExists, reviewCodeChangesCommand, reviewPRCommand, setGlobalEnvsCommand };

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import { a as advancedReviewChangesCommand, c as BUILT_IN_SCOPE_OPTIONS, d as createGlobalEnvFile, f as getGlobalEnvPath, i as commitCommand, l as DEFAULT_SCOPES, n as reviewPRCommand, o as reviewCodeChangesCommand, p as globalEnvExists, r as createPRCommand, s as BUILT_IN_SETUP_OPTIONS, t as setGlobalEnvsCommand, u as defineConfig } from "./set-global-envs-CyKhXAY_.mjs";
+
+export { BUILT_IN_SCOPE_OPTIONS, BUILT_IN_SETUP_OPTIONS, DEFAULT_SCOPES, advancedReviewChangesCommand, commitCommand, createGlobalEnvFile, createPRCommand, defineConfig, getGlobalEnvPath, globalEnvExists, reviewCodeChangesCommand, reviewPRCommand, setGlobalEnvsCommand };

package/dist/main.d.mts

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

package/dist/main.mjs

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { a as advancedReviewChangesCommand, i as commitCommand, n as reviewPRCommand, o as reviewCodeChangesCommand, r as createPRCommand, t as setGlobalEnvsCommand } from "./set-global-envs-CyKhXAY_.mjs";
+import { createCLI } from "@ls-stack/cli";
+
+//#region src/main.ts
+await createCLI({
+	name: "✨ ai-cmds",
+	baseCmd: "ai-cmds"
+}, {
+	commit: commitCommand,
+	"review-code-changes": reviewCodeChangesCommand,
+	"review-pr": reviewPRCommand,
+	"create-pr": createPRCommand,
+	"advanced-review-changes": advancedReviewChangesCommand,
+	"set-global-envs": setGlobalEnvsCommand
+});
+
+//#endregion
+export {  };