@mrgoonie/multix 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.0](https://github.com/mrgoonie/multix-cli/compare/v0.8.0...v0.9.0) (2026-10-11)
+
+
+### Added
+
+* **core:** opt-in loading of legacy .claude env files ([#70](https://github.com/mrgoonie/multix-cli/issues/70)) ([48d9420](https://github.com/mrgoonie/multix-cli/commit/48d9420012a36ada0b5a35e2e51d90c1daa5042c))
+
 ## [0.8.0](https://github.com/mrgoonie/multix-cli/compare/v0.7.3...v0.8.0) (2026-10-11)
 
 

package/README.md

@@ -100,7 +100,7 @@ Set at least one provider key. Add to `.env` in your project root or `~/.multix/
 
 Set extra keys as `GEMINI_API_KEY_2`, `GEMINI_API_KEY_3`, … (any numeric suffix; numbered keys alone are enough). `multix` tries `GEMINI_API_KEY` first, then the numbered keys in ascending order, skipping duplicates. When a key returns HTTP 429 (or 400/403 with `RESOURCE_EXHAUSTED`), it cools down for the server's `Retry-After`/`retryDelay` (default 60s) and the same request is retried with the next ready key; other errors are not rotated. A Files API upload is repeated on the new key if the following generate call is rate-limited. Veo rotates on submit only, so a rate limit while polling or downloading never starts a second billed job. `doc convert` stops its own retries on a rate limit. Cooldowns last for the current process only, and logs name the env var, never the key. `multix check` lists the keys in rotation and pings each one. Quotas are per Google Cloud project: keys from the same project share one quota, so rotation only helps across projects.
 
-Priority: `process.env` > `cwd/.env` > `~/.multix/.env`.
+Priority: `process.env` > `cwd/.env` > `~/.multix/.env`. Set `MULTIX_LEGACY_CLAUDE_ENV=1` to also read legacy AgentKit files (`.claude/skills/{ai-multimodal,ak-ai-multimodal}/.env`, `.claude/skills/.env`, `.claude/.env`, project first, then home) with the lowest priority (credential names only, never endpoint/proxy settings); `multix check -v` lists the env files that were loaded.
 
 ## Commands
 

package/dist/cli.js

@@ -280,22 +280,78 @@ init_redact();
 import fs3 from "fs";
 import os from "os";
 import path3 from "path";
-import { config as dotenvConfig } from "dotenv";
+import { config as dotenvConfig, parse as dotenvParse } from "dotenv";
 var loaded = false;
+var loadedFiles = [];
+var LEGACY_SKILL_DIRS = ["ai-multimodal", "ak-ai-multimodal"];
+function legacyFilesUnder(root) {
+  const claude = path3.join(root, ".claude");
+  return [
+    ...LEGACY_SKILL_DIRS.map((dir) => path3.join(claude, "skills", dir, ".env")),
+    path3.join(claude, "skills", ".env"),
+    path3.join(claude, ".env")
+  ];
+}
+function samePath(a, b) {
+  const norm = (p) => {
+    const r = path3.resolve(p);
+    return process.platform === "win32" ? r.toLowerCase() : r;
+  };
+  return norm(a) === norm(b);
+}
+function legacyClaudeEnvFiles(cwd, home) {
+  const files = legacyFilesUnder(cwd);
+  if (home && !samePath(home, cwd)) files.push(...legacyFilesUnder(home));
+  return files;
+}
+function legacyClaudeEnvEnabled(env = process.env) {
+  const value = env.MULTIX_LEGACY_CLAUDE_ENV;
+  return value !== void 0 && ["1", "true", "yes", "on"].includes(value.trim().toLowerCase());
+}
+var LEGACY_ALLOWED_NAME = /^[A-Z][A-Z0-9_]*_(API_KEY(_\d+)?|API_TOKEN|ACCOUNT_ID|GATEWAY_ID)$|^(FAL_KEY|ARK_API_KEY)$/;
+function isLegacyAllowedName(name) {
+  return LEGACY_ALLOWED_NAME.test(name);
+}
+function isReadableFile(file) {
+  try {
+    return fs3.statSync(file).isFile();
+  } catch {
+    return false;
+  }
+}
+function loadFile(file) {
+  if (!isReadableFile(file)) return;
+  const result = dotenvConfig({ path: file, override: false });
+  if (!result.error) loadedFiles.push(file);
+}
+function loadLegacyFile(file) {
+  if (!isReadableFile(file)) return;
+  let parsed;
+  try {
+    parsed = dotenvParse(fs3.readFileSync(file));
+  } catch {
+    return;
+  }
+  for (const [name, value] of Object.entries(parsed)) {
+    if (isLegacyAllowedName(name) && process.env[name] === void 0) process.env[name] = value;
+  }
+  loadedFiles.push(file);
+}
 function loadEnv() {
   if (loaded) return;
   loaded = true;
-  const cwdEnv = path3.resolve(process.cwd(), ".env");
-  if (fs3.existsSync(cwdEnv)) {
-    dotenvConfig({ path: cwdEnv, override: false });
-  }
-  if (!process.env.MULTIX_DISABLE_HOME_ENV) {
-    const homeEnv = path3.join(os.homedir(), ".multix", ".env");
-    if (fs3.existsSync(homeEnv)) {
-      dotenvConfig({ path: homeEnv, override: false });
-    }
+  loadedFiles = [];
+  const cwd = process.cwd();
+  const home = process.env.MULTIX_DISABLE_HOME_ENV ? void 0 : os.homedir();
+  loadFile(path3.resolve(cwd, ".env"));
+  if (home) loadFile(path3.join(home, ".multix", ".env"));
+  if (legacyClaudeEnvEnabled()) {
+    for (const file of legacyClaudeEnvFiles(cwd, home)) loadLegacyFile(file);
   }
 }
+function getLoadedEnvFiles() {
+  return [...loadedFiles];
+}
 function resolveKey(name) {
   return process.env[name] || void 0;
 }
@@ -6908,6 +6964,10 @@ function registerOpenRouterCommands(program2) {
   registerOpenRouterVideoModelsCommand(openrouter);
 }
 
+// src/commands/check.ts
+import fs43 from "fs";
+import os3 from "os";
+
 // src/commands/check-helpers/binary-check.ts
 import { execa as execa2 } from "execa";
 async function checkBinary(binary, versionFlag = "--version") {
@@ -7079,6 +7139,19 @@ function registerCheckCommand(program2) {
       if (opts.verbose) console.log(`  ${MAGICK_HINT}`);
     }
     logger.header("API Keys");
+    if (opts.verbose) {
+      const files = getLoadedEnvFiles();
+      logger.info(`Env files loaded: ${files.length > 0 ? files.join(", ") : "none"}`);
+    }
+    if (!legacyClaudeEnvEnabled()) {
+      const home = process.env.MULTIX_DISABLE_HOME_ENV ? void 0 : os3.homedir();
+      const legacy = legacyClaudeEnvFiles(process.cwd(), home).filter((f) => fs43.existsSync(f));
+      if (legacy.length > 0) {
+        logger.info(
+          `Found ${legacy.length} legacy .claude env file(s); set MULTIX_LEGACY_CLAUDE_ENV=1 to load them`
+        );
+      }
+    }
     let anyKey = false;
     const resolved = /* @__PURE__ */ new Map();
     for (const p of PROVIDERS) {
@@ -7177,7 +7250,7 @@ function registerCheckCommand(program2) {
 
 // src/commands/doc/convert.ts
 init_errors();
-import fs43 from "fs";
+import fs44 from "fs";
 import path45 from "path";
 
 // src/commands/doc/default-prompt.ts
@@ -7199,7 +7272,7 @@ async function convertDocuments(opts) {
   const model = opts.model ?? DOC_MODEL_DEFAULT;
   const prompt = opts.prompt ?? DEFAULT_CONVERT_PROMPT;
   for (const f of inputs) {
-    if (!fs43.existsSync(f)) throw new ValidationError(`Input file not found: ${f}`);
+    if (!fs44.existsSync(f)) throw new ValidationError(`Input file not found: ${f}`);
   }
   let outputPath;
   if (output) {
@@ -7210,7 +7283,7 @@ async function convertDocuments(opts) {
   } else {
     outputPath = path45.join(getOutputDir(), "document-extraction.md");
   }
-  fs43.mkdirSync(path45.dirname(outputPath), { recursive: true });
+  fs44.mkdirSync(path45.dirname(outputPath), { recursive: true });
   const results = [];
   for (let i = 0; i < inputs.length; i++) {
     const filePath = inputs[i];
@@ -7283,7 +7356,7 @@ async function convertDocuments(opts) {
     }
     lines.push("\n---\n");
   }
-  fs43.writeFileSync(outputPath, lines.join("\n"), "utf8");
+  fs44.writeFileSync(outputPath, lines.join("\n"), "utf8");
   const succeeded = results.filter((r) => r.status === "success").length;
   console.log(`
 ${"=".repeat(50)}`);
@@ -7331,11 +7404,11 @@ function registerDocCommands(program2) {
 
 // src/commands/media/index.ts
 init_errors();
-import fs46 from "fs";
+import fs47 from "fs";
 import path48 from "path";
 
 // src/commands/media/batch.ts
-import fs44 from "fs";
+import fs45 from "fs";
 import path46 from "path";
 
 // src/commands/media/detect-type.ts
@@ -7532,8 +7605,8 @@ async function batchOptimize(opts) {
     verbose,
     logger
   } = opts;
-  fs44.mkdirSync(outputDir, { recursive: true });
-  const entries = fs44.readdirSync(inputDir);
+  fs45.mkdirSync(outputDir, { recursive: true });
+  const entries = fs45.readdirSync(inputDir);
   const mediaFiles = entries.filter((f) => {
     const ext = path46.extname(f).toLowerCase();
     return ALL_EXTS.has(ext);
@@ -7585,7 +7658,7 @@ async function batchOptimize(opts) {
 
 // src/commands/media/split-video.ts
 init_errors();
-import fs45 from "fs";
+import fs46 from "fs";
 import path47 from "path";
 async function splitVideo(opts) {
   await assertFfmpeg();
@@ -7597,7 +7670,7 @@ async function splitVideo(opts) {
     logger?.info("Video is short enough \u2014 no splitting needed");
     return [input];
   }
-  fs45.mkdirSync(outputDir, { recursive: true });
+  fs46.mkdirSync(outputDir, { recursive: true });
   const ext = path47.extname(input) || ".mp4";
   const baseName = path47.basename(input, ext);
   const outputPattern = path47.join(outputDir, `${baseName}_chunk_%03d${ext}`);
@@ -7620,7 +7693,7 @@ async function splitVideo(opts) {
   const files = [];
   for (let i = 0; i < numChunks + 1; i++) {
     const fname = path47.join(outputDir, `${baseName}_chunk_${String(i).padStart(3, "0")}${ext}`);
-    if (fs45.existsSync(fname)) files.push(fname);
+    if (fs46.existsSync(fname)) files.push(fname);
   }
   logger?.success(`Created ${files.length} chunks in ${outputDir}`);
   return files;
@@ -7634,8 +7707,8 @@ function registerMediaCommands(program2) {
   media.command("optimize").description("Optimize a single media file (video, audio, or image)").requiredOption("--input <file>", "Input media file").requiredOption("--output <file>", "Output file path").option("--target-size <MB>", "Target file size in MB").option("--quality <n>", "Quality: video CRF (0-51) or image (1-100)", "85").option("--max-width <px>", "Max image/video width in pixels", "1920").option("--bitrate <rate>", "Audio bitrate (e.g. 64k)", "64k").option("--resolution <WxH>", "Force video resolution (e.g. 1920x1080)").option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
-      if (!fs46.existsSync(opts.input)) throw new ValidationError(`Input not found: ${opts.input}`);
-      fs46.mkdirSync(path48.dirname(path48.resolve(opts.output)), { recursive: true });
+      if (!fs47.existsSync(opts.input)) throw new ValidationError(`Input not found: ${opts.input}`);
+      fs47.mkdirSync(path48.dirname(path48.resolve(opts.output)), { recursive: true });
       const ext = path48.extname(opts.input).toLowerCase();
       const kind = extToKind(ext);
       if (!kind) throw new ValidationError(`Unsupported file type: ${ext}`);
@@ -7676,7 +7749,7 @@ function registerMediaCommands(program2) {
   media.command("split").description("Split a long video into fixed-duration chunks").requiredOption("--input <file>", "Input video file").option("--output-dir <dir>", "Output directory for chunks", "./chunks").option("--chunk-duration <sec>", "Chunk duration in seconds", "3600").option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
-      if (!fs46.existsSync(opts.input)) throw new ValidationError(`Input not found: ${opts.input}`);
+      if (!fs47.existsSync(opts.input)) throw new ValidationError(`Input not found: ${opts.input}`);
       const chunks = await splitVideo({
         input: opts.input,
         outputDir: opts.outputDir,
@@ -7692,7 +7765,7 @@ Created ${chunks.length} chunk(s) in ${opts.outputDir}`);
   media.command("batch").description("Batch optimize all media files in a directory").requiredOption("--input-dir <dir>", "Input directory").requiredOption("--output-dir <dir>", "Output directory").option("--quality <n>", "Quality setting", "85").option("--max-width <px>", "Max image/video width", "1920").option("--bitrate <rate>", "Audio bitrate", "64k").option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
-      if (!fs46.existsSync(opts.inputDir))
+      if (!fs47.existsSync(opts.inputDir))
         throw new ValidationError(`Input dir not found: ${opts.inputDir}`);
       const result = await batchOptimize({
         inputDir: opts.inputDir,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrgoonie/multix",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "AI multimodal CLI — OpenAI, Gemini, MiniMax, OpenRouter, Leonardo, BytePlus, ElevenLabs, fal.ai, ffmpeg, ImageMagick, doc-to-md",
   "type": "module",
   "bin": {

package/skill/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: multix
 description: AI multimodal CLI — generate and edit images (OpenAI, Codex driver, Gemini Nano Banana, Imagen, MiniMax, OpenRouter, Leonardo, BytePlus Seedream, Cloudflare Workers AI FLUX.1 Schnell, fal.ai FLUX), generate video (Gemini Veo, MiniMax Hailuo, OpenRouter via Veo/Seedance/Kling, Leonardo via Motion/Veo/Kling/Hailuo/Seedance/LTX, BytePlus Seedance, Cloudflare AI Gateway via Replicate, fal.ai queue models), TTS/STT/music (OpenAI, Gemini Flash TTS incl. Gemini 3.8 with delivery-style control, MiniMax, Cloudflare Workers AI MeloTTS, ElevenLabs), 3D models (BytePlus Hyper3D/Hitem3d), analyze/transcribe media, convert documents to Markdown, optimize media via ffmpeg/ImageMagick, and self-update the CLI. Use whenever the user wants to create, edit, or transform images/video/audio/3D/documents from a CLI, mentions any of: OpenAI, Codex image driver, image-to-image, i2i, image edit, watercolor/cyberpunk style transfer, reference image, OpenRouter, Nano Banana, Flux, Seedream, Veo, Hailuo, Seedance, Kling, Cloudflare Workers AI, AI Gateway, fal.ai, video generation, text-to-video, image-to-video, i2v, ElevenLabs voice cloning, updating/upgrading multix, or asks for batch media optimization.
-version: 0.8.0 # x-release-please-version
+version: 0.9.0 # x-release-please-version
 ---
 
 # multix — AI Multimodal CLI
@@ -48,7 +48,7 @@ CLOUDFLARE_API_TOKEN  # Cloudflare Workers AI / AI Gateway token
 # Video additionally requires CLOUDFLARE_AI_GATEWAY_ID and REPLICATE_API_TOKEN.
 ```
 
-Priority: `process.env` > `cwd/.env` > `~/.multix/.env`.
+Priority: `process.env` > `cwd/.env` > `~/.multix/.env`. Set `MULTIX_LEGACY_CLAUDE_ENV=1` to also read legacy AgentKit `.claude` env files (credential names only, lowest priority); `multix check -v` lists loaded env files.
 
 ## Gemini text-output tasks
 
@@ -323,7 +323,8 @@ Requires `cwebp` (libwebp: `brew install webp`, `apt install webp`) on `PATH`.
 | `CLOUDFLARE_AI_GATEWAY_COLLECT_LOG_PAYLOAD` | Set `true` to explicitly opt in to AI Gateway request-payload collection; defaults to `false` |
 | `REPLICATE_API_TOKEN` | Required for Cloudflare AI Gateway video |
 | `CLOUDFLARE_AI_IMAGE_MODEL` / `CLOUDFLARE_AI_TTS_MODEL` | Fixed-model settings: only `@cf/black-forest-labs/flux-1-schnell` and `@cf/myshell-ai/melotts` respectively are accepted |
-| `MULTIX_DISABLE_HOME_ENV` | `1` to skip `~/.multix/.env` |
+| `MULTIX_DISABLE_HOME_ENV` | `1` to skip every home-directory env file (`~/.multix/.env`, `~/.claude/...`) |
+| `MULTIX_LEGACY_CLAUDE_ENV` | `1` to also read legacy `.claude` env files (credential names only) |
 
 ## Quick examples for agents