@gengjiawen/os-init 1.11.0 → 1.13.0

package/AGENTS.md

@@ -0,0 +1,42 @@
+# Repository Guidelines
+
+## Project Structure
+
+- `bin/`: Node CLI entrypoint (`bin/bin.js`) and command definitions (e.g., `set-codex`, `set-gemini`).
+- `libs/`: TypeScript source for config writers/installers and setup utilities (main exports in `libs/index.ts`).
+- `build/`: Compiled JS + `.d.ts` output from `tsc` (`outDir`), consumed by the CLI and published to npm.
+- `dev-setup/`: Optional Docker-based dev environment (sshd + compose) for remote/portable workflows.
+- `.github/workflows/`: CI (`nodejs.yml`) and automated releases via Release Please (`release-please.yml`).
+
+## Build, Test, and Development Commands
+
+Use `pnpm` (CI uses it).
+
+- `pnpm install`: install dependencies.
+- `pnpm dev`: run TypeScript compiler in watch mode.
+- `pnpm build`: clean and compile to `build/` (then copies non-TS assets from `libs/`).
+- `pnpm test`: run Jest (TypeScript via `ts-jest`).
+- `pnpm format` / `pnpm format:check`: format or verify formatting with Prettier.
+
+## Coding Style & Naming Conventions
+
+- Formatting: Prettier (no semicolons, single quotes). Run `pnpm format` before pushing.
+- TypeScript: strict options are enabled; prefer explicit, typed helpers over `any`.
+- Naming: files are kebab-case in `libs/` (e.g., `gemini-cli.ts`); exported functions are `camelCase`.
+
+## Testing Guidelines
+
+- Framework: Jest + `ts-jest`.
+- Naming: place tests next to code as `*.test.ts` (example: `libs/index.test.ts`).
+- Keep tests hermetic: avoid writing to real user paths; prefer temp dirs/mocks when testing config output.
+
+## Commit & Pull Request Guidelines
+
+- Commits follow Conventional Commits (observed history): `feat: ...`, `fix: ...`, `refactor: ...`, `chore: ...`.
+- Releases are automated on `master` via Release Please; don’t manually bump versions in PRs.
+- PRs should include: a clear description, validation steps (`pnpm build && pnpm test && pnpm format:check`), and any relevant config/output examples.
+
+## Security & Configuration Tips
+
+- This repo generates local agent config files and may handle API keys. Never commit secrets or generated config files.
+- When adding new setup commands, document where files are written and keep defaults safe/least-privilege.

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [1.13.0](https://github.com/gengjiawen/os-init/compare/v1.12.0...v1.13.0) (2026-01-26)
+
+
+### Features
+
+* add --full to include gemini in set-agents ([defdaca](https://github.com/gengjiawen/os-init/commit/defdaca67c0cea3d2d449a68b69080f68cf6f771))
+
+## [1.12.0](https://github.com/gengjiawen/os-init/compare/v1.11.0...v1.12.0) (2026-01-05)
+
+
+### Features
+
+* add command to setup all AI agents with configuration and dependency installation ([122973e](https://github.com/gengjiawen/os-init/commit/122973e87767713ac6f9a36d0197e53f98f0b323))
+* add Gemini CLI setup command and configuration management ([9d8400a](https://github.com/gengjiawen/os-init/commit/9d8400acb48a4da3e0688b60d69f9ed1b1353b8d))
+
 ## [1.11.0](https://github.com/gengjiawen/os-init/compare/v1.10.0...v1.11.0) (2025-12-31)
 
 

package/bin/bin.js

@@ -6,6 +6,10 @@ const {
   installDeps,
   writeCodexConfig,
   installCodexDeps,
+  writeGeminiConfig,
+  installGeminiDeps,
+  writeAllAgentsConfig,
+  installAllAgentsDeps,
   writeRaycastConfig,
   setupDevEnvironment,
   setupAndroidEnvironment,
@@ -60,6 +64,81 @@ program
     console.log('Codex is ready. use `codex` in terminal to start building')
   })
 
+program
+  .command('set-gemini')
+  .description('setup Gemini CLI config and auth')
+  .argument('<apiKey>', 'API key to set for Gemini CLI')
+  .action(async (apiKey) => {
+    if (!apiKey || String(apiKey).trim().length === 0) {
+      console.error('Missing required argument: <apiKey>')
+      program.help({ error: true })
+      return
+    }
+    try {
+      const { envPath, settingsPath } = writeGeminiConfig(apiKey)
+      console.log(`Gemini CLI env written to: ${envPath}`)
+      console.log(`Gemini CLI settings written to: ${settingsPath}`)
+      await installGeminiDeps()
+    } catch (err) {
+      console.error('Failed to setup Gemini CLI:', err.message)
+      process.exit(1)
+    }
+    console.log(
+      'Gemini CLI is ready. use `gemini` in terminal to start building'
+    )
+  })
+
+program
+  .command('set-agents')
+  .description(
+    'setup Claude Code and Codex at once (use --full to include Gemini CLI)'
+  )
+  .argument('<apiKey>', 'API key to set for agents')
+  .option('--full', 'Also setup Gemini CLI')
+  .action(async (apiKey, options) => {
+    if (!apiKey || String(apiKey).trim().length === 0) {
+      console.error('Missing required argument: <apiKey>')
+      program.help({ error: true })
+      return
+    }
+
+    const full = Boolean(options.full)
+
+    try {
+      console.log(
+        full
+          ? 'Setting up Claude Code + Codex + Gemini CLI...\n'
+          : 'Setting up Claude Code + Codex...\n'
+      )
+
+      const result = writeAllAgentsConfig(apiKey, { full })
+
+      console.log('Claude Code:')
+      console.log(`  Settings written to: ${result.claude.settingsPath}`)
+
+      console.log('\nCodex:')
+      console.log(`  Config written to: ${result.codex.configPath}`)
+      console.log(`  Auth written to: ${result.codex.authPath}`)
+
+      if (result.gemini) {
+        console.log('\nGemini CLI:')
+        console.log(`  Env written to: ${result.gemini.envPath}`)
+        console.log(`  Settings written to: ${result.gemini.settingsPath}`)
+      }
+
+      console.log('\nInstalling dependencies...')
+      await installAllAgentsDeps({ full })
+    } catch (err) {
+      console.error('Failed to setup agents:', err.message)
+      process.exit(1)
+    }
+
+    console.log('\nSetup complete!')
+    console.log('  - Use `claude` for Claude Code')
+    console.log('  - Use `codex` for Codex')
+    if (full) console.log('  - Use `gemini` for Gemini CLI')
+  })
+
 program
   .command('set-raycast-ai')
   .description('setup Raycast AI providers config')

package/build/all-agents.d.ts

@@ -0,0 +1,18 @@
+export interface AllAgentsOptions {
+    full?: boolean;
+}
+export interface AllAgentsResult {
+    claude: {
+        settingsPath: string;
+    };
+    codex: {
+        configPath: string;
+        authPath: string;
+    };
+    gemini?: {
+        envPath: string;
+        settingsPath: string;
+    };
+}
+export declare function writeAllAgentsConfig(apiKey: string, options?: AllAgentsOptions): AllAgentsResult;
+export declare function installAllAgentsDeps(options?: AllAgentsOptions): Promise<void>;

package/build/all-agents.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeAllAgentsConfig = writeAllAgentsConfig;
+exports.installAllAgentsDeps = installAllAgentsDeps;
+const claude_code_1 = require("./claude-code");
+const codex_1 = require("./codex");
+const gemini_cli_1 = require("./gemini-cli");
+function writeAllAgentsConfig(apiKey, options = {}) {
+    const claudeResult = (0, claude_code_1.writeClaudeConfig)(apiKey);
+    const codexResult = (0, codex_1.writeCodexConfig)(apiKey);
+    const result = {
+        claude: claudeResult,
+        codex: codexResult,
+    };
+    if (options.full) {
+        result.gemini = (0, gemini_cli_1.writeGeminiConfig)(apiKey);
+    }
+    return result;
+}
+async function installAllAgentsDeps(options = {}) {
+    const installers = [(0, claude_code_1.installDeps)(), (0, codex_1.installCodexDeps)()];
+    if (options.full)
+        installers.push((0, gemini_cli_1.installGeminiDeps)());
+    await Promise.all(installers);
+}

package/build/claude-code.d.ts

@@ -0,0 +1,4 @@
+export declare function writeClaudeConfig(apiKey: string): {
+    settingsPath: string;
+};
+export declare function installDeps(): Promise<void>;

package/build/claude-code.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeClaudeConfig = writeClaudeConfig;
+exports.installDeps = installDeps;
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const execa_1 = require("execa");
+const utils_1 = require("./utils");
+function getClaudeSettingsDir() {
+    return path.join(os.homedir(), '.claude');
+}
+const CLAUDE_SETTINGS_TEMPLATE = `{
+  "env": {
+    "DISABLE_TELEMETRY": "1",
+    "OTEL_METRICS_EXPORTER": "otlp",
+    "ANTHROPIC_API_KEY": "API_KEY_PLACEHOLDER",
+    "ANTHROPIC_BASE_URL": "https://ai.gengjiawen.com/api/claude/",
+    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
+  },
+  "includeCoAuthoredBy": false,
+  "apiKeyHelper": "echo 'API_KEY_PLACEHOLDER'",
+  "permissions": {
+    "allow": [],
+    "deny": []
+  }
+}`;
+function writeClaudeConfig(apiKey) {
+    const settingsDir = getClaudeSettingsDir();
+    const settingsPath = path.join(settingsDir, 'settings.json');
+    (0, utils_1.ensureDir)(settingsDir);
+    const settingsContent = CLAUDE_SETTINGS_TEMPLATE.replace(/API_KEY_PLACEHOLDER/g, apiKey);
+    fs.writeFileSync(settingsPath, settingsContent);
+    return { settingsPath };
+}
+async function installDeps() {
+    const packages = ['@anthropic-ai/claude-code'];
+    const usePnpm = await (0, utils_1.commandExists)('pnpm');
+    if (usePnpm) {
+        console.log('pnpm detected. Installing dependencies with pnpm...');
+        await (0, execa_1.execa)('pnpm', ['add', '-g', ...packages], { stdio: 'inherit' });
+    }
+    else {
+        console.log('pnpm not found. Falling back to npm...');
+        await (0, execa_1.execa)('npm', ['install', '-g', ...packages], { stdio: 'inherit' });
+    }
+    console.log('Dependencies installed successfully.');
+}

package/build/codex.d.ts

@@ -0,0 +1,5 @@
+export declare function writeCodexConfig(apiKey: string): {
+    configPath: string;
+    authPath: string;
+};
+export declare function installCodexDeps(): Promise<void>;

package/build/codex.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeCodexConfig = writeCodexConfig;
+exports.installCodexDeps = installCodexDeps;
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const execa_1 = require("execa");
+const utils_1 = require("./utils");
+function getCodexConfigDir() {
+    return path.join(os.homedir(), '.codex');
+}
+const CODEX_CONFIG_TOML_TEMPLATE = `model_provider = "jw"
+model = "gpt-5.2"
+model_reasoning_effort = "high"
+disable_response_storage = true
+preferred_auth_method = "apikey"
+
+[model_providers.jw]
+name = "jw"
+base_url = "https://ai.gengjiawen.com/api/openai"
+wire_api = "responses"
+`;
+function writeCodexConfig(apiKey) {
+    const configDir = getCodexConfigDir();
+    (0, utils_1.ensureDir)(configDir);
+    const configPath = path.join(configDir, 'config.toml');
+    fs.writeFileSync(configPath, CODEX_CONFIG_TOML_TEMPLATE);
+    const authPath = path.join(configDir, 'auth.json');
+    const authContent = JSON.stringify({ OPENAI_API_KEY: apiKey }, null, 2);
+    fs.writeFileSync(authPath, authContent);
+    return { configPath, authPath };
+}
+async function installCodexDeps() {
+    const packages = ['@openai/codex'];
+    const usePnpm = await (0, utils_1.commandExists)('pnpm');
+    if (usePnpm) {
+        console.log('pnpm detected. Installing Codex dependency with pnpm...');
+        await (0, execa_1.execa)('pnpm', ['add', '-g', ...packages], { stdio: 'inherit' });
+    }
+    else {
+        console.log('pnpm not found. Falling back to npm...');
+        await (0, execa_1.execa)('npm', ['install', '-g', ...packages], { stdio: 'inherit' });
+    }
+    console.log('Codex dependency installed successfully.');
+}

package/build/gemini-cli.d.ts

@@ -0,0 +1,5 @@
+export declare function writeGeminiConfig(apiKey: string): {
+    envPath: string;
+    settingsPath: string;
+};
+export declare function installGeminiDeps(): Promise<void>;

package/build/gemini-cli.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeGeminiConfig = writeGeminiConfig;
+exports.installGeminiDeps = installGeminiDeps;
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const execa_1 = require("execa");
+const utils_1 = require("./utils");
+function getGeminiConfigDir() {
+    return path.join(os.homedir(), '.gemini');
+}
+const GEMINI_ENV_TEMPLATE = `GOOGLE_GEMINI_BASE_URL=https://ai.gengjiawen.com/api/gemini
+GEMINI_API_KEY=API_KEY_PLACEHOLDER
+GEMINI_MODEL=gemini-3-pro-preview
+`;
+const GEMINI_SETTINGS_TEMPLATE = {
+    ide: {
+        enabled: true,
+    },
+    security: {
+        auth: {
+            selectedType: 'gemini-api-key',
+        },
+    },
+};
+function writeGeminiConfig(apiKey) {
+    const configDir = getGeminiConfigDir();
+    (0, utils_1.ensureDir)(configDir);
+    const envPath = path.join(configDir, '.env');
+    const envContent = GEMINI_ENV_TEMPLATE.replace('API_KEY_PLACEHOLDER', apiKey);
+    fs.writeFileSync(envPath, envContent);
+    const settingsPath = path.join(configDir, 'settings.json');
+    fs.writeFileSync(settingsPath, JSON.stringify(GEMINI_SETTINGS_TEMPLATE, null, 2));
+    return { envPath, settingsPath };
+}
+async function installGeminiDeps() {
+    const usePnpm = await (0, utils_1.commandExists)('pnpm');
+    const geminiPackage = '@google/gemini-cli';
+    if (usePnpm) {
+        console.log('pnpm detected. Installing Gemini CLI with pnpm...');
+        await (0, execa_1.execa)('pnpm', ['add', '-g', geminiPackage], { stdio: 'inherit' });
+    }
+    else {
+        console.log('pnpm not found. Falling back to npm...');
+        await (0, execa_1.execa)('npm', ['install', '-g', geminiPackage], { stdio: 'inherit' });
+    }
+    console.log('Gemini CLI installed successfully.');
+}

package/build/index.d.ts

@@ -1,14 +1,9 @@
-export declare function writeClaudeConfig(apiKey: string): {
-    settingsPath: string;
-};
-export declare function installDeps(): Promise<void>;
-export declare function writeCodexConfig(apiKey: string): {
-    configPath: string;
-    authPath: string;
-};
-export declare function installCodexDeps(): Promise<void>;
 export declare function writeRaycastConfig(apiKey: string): {
     configPath: string;
 };
+export { writeClaudeConfig, installDeps } from './claude-code';
+export { writeCodexConfig, installCodexDeps } from './codex';
+export { writeGeminiConfig, installGeminiDeps } from './gemini-cli';
+export { writeAllAgentsConfig, installAllAgentsDeps } from './all-agents';
 export { setupDevEnvironment } from './dev-setup';
 export { setupAndroidEnvironment } from './android-setup';

package/build/index.js

@@ -1,106 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setupAndroidEnvironment = exports.setupDevEnvironment = void 0;
-exports.writeClaudeConfig = writeClaudeConfig;
-exports.installDeps = installDeps;
-exports.writeCodexConfig = writeCodexConfig;
-exports.installCodexDeps = installCodexDeps;
+exports.setupAndroidEnvironment = exports.setupDevEnvironment = exports.installAllAgentsDeps = exports.writeAllAgentsConfig = exports.installGeminiDeps = exports.writeGeminiConfig = exports.installCodexDeps = exports.writeCodexConfig = exports.installDeps = exports.writeClaudeConfig = void 0;
 exports.writeRaycastConfig = writeRaycastConfig;
 const fs = require("fs");
 const path = require("path");
 const os = require("os");
-const execa_1 = require("execa");
-function ensureDir(dirPath) {
-    fs.mkdirSync(dirPath, { recursive: true });
-}
-function getClaudeSettingsDir() {
-    return path.join(os.homedir(), '.claude');
-}
-const CLAUDE_SETTINGS_TEMPLATE = `{
-  "env": {
-    "DISABLE_TELEMETRY": "1",
-    "OTEL_METRICS_EXPORTER": "otlp",
-    "ANTHROPIC_API_KEY": "API_KEY_PLACEHOLDER",
-    "ANTHROPIC_BASE_URL": "https://ai.gengjiawen.com/api/claude/",
-    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
-  },
-  "includeCoAuthoredBy": false,
-  "apiKeyHelper": "echo 'API_KEY_PLACEHOLDER'",
-  "permissions": {
-    "allow": [],
-    "deny": []
-  }
-}`;
-function writeClaudeConfig(apiKey) {
-    const settingsDir = getClaudeSettingsDir();
-    const settingsPath = path.join(settingsDir, 'settings.json');
-    ensureDir(settingsDir);
-    const settingsContent = CLAUDE_SETTINGS_TEMPLATE.replace(/API_KEY_PLACEHOLDER/g, apiKey);
-    fs.writeFileSync(settingsPath, settingsContent);
-    return { settingsPath };
-}
-async function commandExists(command) {
-    try {
-        const { failed } = await (0, execa_1.execa)(command, ['--version'], {
-            stdio: 'ignore',
-            reject: false,
-        });
-        return !failed;
-    }
-    catch (error) {
-        return false;
-    }
-}
-async function installDeps() {
-    const packages = ['@anthropic-ai/claude-code'];
-    const usePnpm = await commandExists('pnpm');
-    if (usePnpm) {
-        console.log('pnpm detected. Installing dependencies with pnpm...');
-        await (0, execa_1.execa)('pnpm', ['add', '-g', ...packages], { stdio: 'inherit' });
-    }
-    else {
-        console.log('pnpm not found. Falling back to npm...');
-        await (0, execa_1.execa)('npm', ['install', '-g', ...packages], { stdio: 'inherit' });
-    }
-    console.log('Dependencies installed successfully.');
-}
-function getCodexConfigDir() {
-    return path.join(os.homedir(), '.codex');
-}
-const CODEX_CONFIG_TOML_TEMPLATE = `model_provider = "jw"
-model = "gpt-5.2"
-model_reasoning_effort = "high"
-disable_response_storage = true
-preferred_auth_method = "apikey"
-
-[model_providers.jw]
-name = "jw"
-base_url = "https://ai.gengjiawen.com/api/openai"
-wire_api = "responses"
-`;
-function writeCodexConfig(apiKey) {
-    const configDir = getCodexConfigDir();
-    ensureDir(configDir);
-    const configPath = path.join(configDir, 'config.toml');
-    fs.writeFileSync(configPath, CODEX_CONFIG_TOML_TEMPLATE);
-    const authPath = path.join(configDir, 'auth.json');
-    const authContent = JSON.stringify({ OPENAI_API_KEY: apiKey }, null, 2);
-    fs.writeFileSync(authPath, authContent);
-    return { configPath, authPath };
-}
-async function installCodexDeps() {
-    const packages = ['@openai/codex'];
-    const usePnpm = await commandExists('pnpm');
-    if (usePnpm) {
-        console.log('pnpm detected. Installing Codex dependency with pnpm...');
-        await (0, execa_1.execa)('pnpm', ['add', '-g', ...packages], { stdio: 'inherit' });
-    }
-    else {
-        console.log('pnpm not found. Falling back to npm...');
-        await (0, execa_1.execa)('npm', ['install', '-g', ...packages], { stdio: 'inherit' });
-    }
-    console.log('Codex dependency installed successfully.');
-}
+const utils_1 = require("./utils");
 function getRaycastAIConfigDir() {
     return path.join(os.homedir(), '.config', 'raycast', 'ai');
 }
@@ -127,12 +32,24 @@ const RAYCAST_PROVIDERS_YAML_TEMPLATE = `providers:
 `;
 function writeRaycastConfig(apiKey) {
     const configDir = getRaycastAIConfigDir();
-    ensureDir(configDir);
+    (0, utils_1.ensureDir)(configDir);
     const configPath = path.join(configDir, 'providers.yaml');
     const content = RAYCAST_PROVIDERS_YAML_TEMPLATE.replace('API_KEY_PLACEHOLDER', apiKey);
     fs.writeFileSync(configPath, content);
     return { configPath };
 }
+var claude_code_1 = require("./claude-code");
+Object.defineProperty(exports, "writeClaudeConfig", { enumerable: true, get: function () { return claude_code_1.writeClaudeConfig; } });
+Object.defineProperty(exports, "installDeps", { enumerable: true, get: function () { return claude_code_1.installDeps; } });
+var codex_1 = require("./codex");
+Object.defineProperty(exports, "writeCodexConfig", { enumerable: true, get: function () { return codex_1.writeCodexConfig; } });
+Object.defineProperty(exports, "installCodexDeps", { enumerable: true, get: function () { return codex_1.installCodexDeps; } });
+var gemini_cli_1 = require("./gemini-cli");
+Object.defineProperty(exports, "writeGeminiConfig", { enumerable: true, get: function () { return gemini_cli_1.writeGeminiConfig; } });
+Object.defineProperty(exports, "installGeminiDeps", { enumerable: true, get: function () { return gemini_cli_1.installGeminiDeps; } });
+var all_agents_1 = require("./all-agents");
+Object.defineProperty(exports, "writeAllAgentsConfig", { enumerable: true, get: function () { return all_agents_1.writeAllAgentsConfig; } });
+Object.defineProperty(exports, "installAllAgentsDeps", { enumerable: true, get: function () { return all_agents_1.installAllAgentsDeps; } });
 var dev_setup_1 = require("./dev-setup");
 Object.defineProperty(exports, "setupDevEnvironment", { enumerable: true, get: function () { return dev_setup_1.setupDevEnvironment; } });
 var android_setup_1 = require("./android-setup");

package/build/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function ensureDir(dirPath: string): void;
+export declare function commandExists(command: string): Promise<boolean>;

package/build/utils.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDir = ensureDir;
+exports.commandExists = commandExists;
+const fs = require("fs");
+const execa_1 = require("execa");
+function ensureDir(dirPath) {
+    fs.mkdirSync(dirPath, { recursive: true });
+}
+async function commandExists(command) {
+    try {
+        const { failed } = await (0, execa_1.execa)(command, ['--version'], {
+            stdio: 'ignore',
+            reject: false,
+        });
+        return !failed;
+    }
+    catch (error) {
+        return false;
+    }
+}

package/libs/all-agents.ts

@@ -0,0 +1,43 @@
+import { writeClaudeConfig, installDeps } from './claude-code'
+import { writeCodexConfig, installCodexDeps } from './codex'
+import { writeGeminiConfig, installGeminiDeps } from './gemini-cli'
+
+export interface AllAgentsOptions {
+  /** When true, also include Gemini CLI in the combined setup. */
+  full?: boolean
+}
+
+export interface AllAgentsResult {
+  claude: { settingsPath: string }
+  codex: { configPath: string; authPath: string }
+  gemini?: { envPath: string; settingsPath: string }
+}
+
+/** Write configuration for the combined setup (Claude Code + Codex, optional Gemini CLI). */
+export function writeAllAgentsConfig(
+  apiKey: string,
+  options: AllAgentsOptions = {}
+): AllAgentsResult {
+  const claudeResult = writeClaudeConfig(apiKey)
+  const codexResult = writeCodexConfig(apiKey)
+
+  const result: AllAgentsResult = {
+    claude: claudeResult,
+    codex: codexResult,
+  }
+
+  if (options.full) {
+    result.gemini = writeGeminiConfig(apiKey)
+  }
+
+  return result
+}
+
+/** Install dependencies for the combined setup (Claude Code + Codex, optional Gemini CLI). */
+export async function installAllAgentsDeps(
+  options: AllAgentsOptions = {}
+): Promise<void> {
+  const installers = [installDeps(), installCodexDeps()]
+  if (options.full) installers.push(installGeminiDeps())
+  await Promise.all(installers)
+}

package/libs/claude-code.ts

@@ -0,0 +1,59 @@
+import * as fs from 'fs'
+import * as path from 'path'
+import * as os from 'os'
+import { execa } from 'execa'
+import { ensureDir, commandExists } from './utils'
+
+/** Return Claude settings directory path */
+function getClaudeSettingsDir(): string {
+  return path.join(os.homedir(), '.claude')
+}
+
+/** Template for Claude settings.json */
+const CLAUDE_SETTINGS_TEMPLATE = `{
+  "env": {
+    "DISABLE_TELEMETRY": "1",
+    "OTEL_METRICS_EXPORTER": "otlp",
+    "ANTHROPIC_API_KEY": "API_KEY_PLACEHOLDER",
+    "ANTHROPIC_BASE_URL": "https://ai.gengjiawen.com/api/claude/",
+    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
+  },
+  "includeCoAuthoredBy": false,
+  "apiKeyHelper": "echo 'API_KEY_PLACEHOLDER'",
+  "permissions": {
+    "allow": [],
+    "deny": []
+  }
+}`
+
+/** Write Claude config files */
+export function writeClaudeConfig(apiKey: string): {
+  settingsPath: string
+} {
+  // Write Claude settings
+  const settingsDir = getClaudeSettingsDir()
+  const settingsPath = path.join(settingsDir, 'settings.json')
+  ensureDir(settingsDir)
+  const settingsContent = CLAUDE_SETTINGS_TEMPLATE.replace(
+    /API_KEY_PLACEHOLDER/g,
+    apiKey
+  )
+  fs.writeFileSync(settingsPath, settingsContent)
+
+  return { settingsPath }
+}
+
+/** Install global dependencies */
+export async function installDeps(): Promise<void> {
+  const packages = ['@anthropic-ai/claude-code']
+  const usePnpm = await commandExists('pnpm')
+
+  if (usePnpm) {
+    console.log('pnpm detected. Installing dependencies with pnpm...')
+    await execa('pnpm', ['add', '-g', ...packages], { stdio: 'inherit' })
+  } else {
+    console.log('pnpm not found. Falling back to npm...')
+    await execa('npm', ['install', '-g', ...packages], { stdio: 'inherit' })
+  }
+  console.log('Dependencies installed successfully.')
+}

package/libs/codex.ts

@@ -0,0 +1,56 @@
+import * as fs from 'fs'
+import * as path from 'path'
+import * as os from 'os'
+import { execa } from 'execa'
+import { ensureDir, commandExists } from './utils'
+
+/** Return Codex configuration directory path */
+function getCodexConfigDir(): string {
+  return path.join(os.homedir(), '.codex')
+}
+
+/** Template for Codex config.toml */
+const CODEX_CONFIG_TOML_TEMPLATE = `model_provider = "jw"
+model = "gpt-5.2"
+model_reasoning_effort = "high"
+disable_response_storage = true
+preferred_auth_method = "apikey"
+
+[model_providers.jw]
+name = "jw"
+base_url = "https://ai.gengjiawen.com/api/openai"
+wire_api = "responses"
+`
+
+/** Write Codex config.toml and auth.json */
+export function writeCodexConfig(apiKey: string): {
+  configPath: string
+  authPath: string
+} {
+  const configDir = getCodexConfigDir()
+  ensureDir(configDir)
+
+  const configPath = path.join(configDir, 'config.toml')
+  fs.writeFileSync(configPath, CODEX_CONFIG_TOML_TEMPLATE)
+
+  const authPath = path.join(configDir, 'auth.json')
+  const authContent = JSON.stringify({ OPENAI_API_KEY: apiKey }, null, 2)
+  fs.writeFileSync(authPath, authContent)
+
+  return { configPath, authPath }
+}
+
+/** Install Codex dependency */
+export async function installCodexDeps(): Promise<void> {
+  const packages = ['@openai/codex']
+  const usePnpm = await commandExists('pnpm')
+
+  if (usePnpm) {
+    console.log('pnpm detected. Installing Codex dependency with pnpm...')
+    await execa('pnpm', ['add', '-g', ...packages], { stdio: 'inherit' })
+  } else {
+    console.log('pnpm not found. Falling back to npm...')
+    await execa('npm', ['install', '-g', ...packages], { stdio: 'inherit' })
+  }
+  console.log('Codex dependency installed successfully.')
+}

package/libs/gemini-cli.ts

@@ -0,0 +1,66 @@
+import * as fs from 'fs'
+import * as path from 'path'
+import * as os from 'os'
+import { execa } from 'execa'
+import { ensureDir, commandExists } from './utils'
+
+/** Return Gemini CLI configuration directory path */
+function getGeminiConfigDir(): string {
+  return path.join(os.homedir(), '.gemini')
+}
+
+/** Template for Gemini CLI .env file */
+const GEMINI_ENV_TEMPLATE = `GOOGLE_GEMINI_BASE_URL=https://ai.gengjiawen.com/api/gemini
+GEMINI_API_KEY=API_KEY_PLACEHOLDER
+GEMINI_MODEL=gemini-3-pro-preview
+`
+
+/** Template for Gemini CLI settings.json */
+const GEMINI_SETTINGS_TEMPLATE = {
+  ide: {
+    enabled: true,
+  },
+  security: {
+    auth: {
+      selectedType: 'gemini-api-key',
+    },
+  },
+}
+
+/** Write Gemini CLI config files (.env and settings.json) */
+export function writeGeminiConfig(apiKey: string): {
+  envPath: string
+  settingsPath: string
+} {
+  const configDir = getGeminiConfigDir()
+  ensureDir(configDir)
+
+  // Write .env file
+  const envPath = path.join(configDir, '.env')
+  const envContent = GEMINI_ENV_TEMPLATE.replace('API_KEY_PLACEHOLDER', apiKey)
+  fs.writeFileSync(envPath, envContent)
+
+  // Write settings.json file
+  const settingsPath = path.join(configDir, 'settings.json')
+  fs.writeFileSync(
+    settingsPath,
+    JSON.stringify(GEMINI_SETTINGS_TEMPLATE, null, 2)
+  )
+
+  return { envPath, settingsPath }
+}
+
+/** Install Gemini CLI dependency */
+export async function installGeminiDeps(): Promise<void> {
+  const usePnpm = await commandExists('pnpm')
+  const geminiPackage = '@google/gemini-cli'
+
+  if (usePnpm) {
+    console.log('pnpm detected. Installing Gemini CLI with pnpm...')
+    await execa('pnpm', ['add', '-g', geminiPackage], { stdio: 'inherit' })
+  } else {
+    console.log('pnpm not found. Falling back to npm...')
+    await execa('npm', ['install', '-g', geminiPackage], { stdio: 'inherit' })
+  }
+  console.log('Gemini CLI installed successfully.')
+}

package/libs/index.ts

@@ -1,132 +1,7 @@
 import * as fs from 'fs'
 import * as path from 'path'
 import * as os from 'os'
-import { execa } from 'execa'
-
-/** Ensure directory exists */
-function ensureDir(dirPath: string): void {
-  fs.mkdirSync(dirPath, { recursive: true })
-}
-
-/** Return Claude settings directory path */
-function getClaudeSettingsDir(): string {
-  return path.join(os.homedir(), '.claude')
-}
-
-/** Template for Claude settings.json */
-const CLAUDE_SETTINGS_TEMPLATE = `{
-  "env": {
-    "DISABLE_TELEMETRY": "1",
-    "OTEL_METRICS_EXPORTER": "otlp",
-    "ANTHROPIC_API_KEY": "API_KEY_PLACEHOLDER",
-    "ANTHROPIC_BASE_URL": "https://ai.gengjiawen.com/api/claude/",
-    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
-  },
-  "includeCoAuthoredBy": false,
-  "apiKeyHelper": "echo 'API_KEY_PLACEHOLDER'",
-  "permissions": {
-    "allow": [],
-    "deny": []
-  }
-}`
-
-/** Write Claude config files */
-export function writeClaudeConfig(apiKey: string): {
-  settingsPath: string
-} {
-  // Write Claude settings
-  const settingsDir = getClaudeSettingsDir()
-  const settingsPath = path.join(settingsDir, 'settings.json')
-  ensureDir(settingsDir)
-  const settingsContent = CLAUDE_SETTINGS_TEMPLATE.replace(
-    /API_KEY_PLACEHOLDER/g,
-    apiKey
-  )
-  fs.writeFileSync(settingsPath, settingsContent)
-
-  return { settingsPath }
-}
-
-/** Check if a command exists */
-async function commandExists(command: string): Promise<boolean> {
-  try {
-    // execa with reject: false will not throw on non-zero exit codes.
-    const { failed } = await execa(command, ['--version'], {
-      stdio: 'ignore',
-      reject: false,
-    })
-    return !failed
-  } catch (error) {
-    // Catch errors for commands that don't support --version or other issues
-    return false
-  }
-}
-
-/** Install global dependencies */
-export async function installDeps(): Promise<void> {
-  const packages = ['@anthropic-ai/claude-code']
-  const usePnpm = await commandExists('pnpm')
-
-  if (usePnpm) {
-    console.log('pnpm detected. Installing dependencies with pnpm...')
-    await execa('pnpm', ['add', '-g', ...packages], { stdio: 'inherit' })
-  } else {
-    console.log('pnpm not found. Falling back to npm...')
-    await execa('npm', ['install', '-g', ...packages], { stdio: 'inherit' })
-  }
-  console.log('Dependencies installed successfully.')
-}
-
-/** Return Codex configuration directory path */
-function getCodexConfigDir(): string {
-  return path.join(os.homedir(), '.codex')
-}
-
-/** Template for Codex config.toml */
-const CODEX_CONFIG_TOML_TEMPLATE = `model_provider = "jw"
-model = "gpt-5.2"
-model_reasoning_effort = "high"
-disable_response_storage = true
-preferred_auth_method = "apikey"
-
-[model_providers.jw]
-name = "jw"
-base_url = "https://ai.gengjiawen.com/api/openai"
-wire_api = "responses"
-`
-
-/** Write Codex config.toml and auth.json */
-export function writeCodexConfig(apiKey: string): {
-  configPath: string
-  authPath: string
-} {
-  const configDir = getCodexConfigDir()
-  ensureDir(configDir)
-
-  const configPath = path.join(configDir, 'config.toml')
-  fs.writeFileSync(configPath, CODEX_CONFIG_TOML_TEMPLATE)
-
-  const authPath = path.join(configDir, 'auth.json')
-  const authContent = JSON.stringify({ OPENAI_API_KEY: apiKey }, null, 2)
-  fs.writeFileSync(authPath, authContent)
-
-  return { configPath, authPath }
-}
-
-/** Install Codex dependency */
-export async function installCodexDeps(): Promise<void> {
-  const packages = ['@openai/codex']
-  const usePnpm = await commandExists('pnpm')
-
-  if (usePnpm) {
-    console.log('pnpm detected. Installing Codex dependency with pnpm...')
-    await execa('pnpm', ['add', '-g', ...packages], { stdio: 'inherit' })
-  } else {
-    console.log('pnpm not found. Falling back to npm...')
-    await execa('npm', ['install', '-g', ...packages], { stdio: 'inherit' })
-  }
-  console.log('Codex dependency installed successfully.')
-}
+import { ensureDir } from './utils'
 
 /** Return Raycast AI configuration directory path */
 function getRaycastAIConfigDir(): string {
@@ -171,6 +46,18 @@ export function writeRaycastConfig(apiKey: string): { configPath: string } {
   return { configPath }
 }
 
+// Re-export claude-code functionality
+export { writeClaudeConfig, installDeps } from './claude-code'
+
+// Re-export codex functionality
+export { writeCodexConfig, installCodexDeps } from './codex'
+
+// Re-export gemini-cli functionality
+export { writeGeminiConfig, installGeminiDeps } from './gemini-cli'
+
+// Re-export all-agents functionality
+export { writeAllAgentsConfig, installAllAgentsDeps } from './all-agents'
+
 // Re-export dev-setup functionality
 export { setupDevEnvironment } from './dev-setup'
 

package/libs/utils.ts

@@ -0,0 +1,22 @@
+import * as fs from 'fs'
+import { execa } from 'execa'
+
+/** Ensure directory exists */
+export function ensureDir(dirPath: string): void {
+  fs.mkdirSync(dirPath, { recursive: true })
+}
+
+/** Check if a command exists */
+export async function commandExists(command: string): Promise<boolean> {
+  try {
+    // execa with reject: false will not throw on non-zero exit codes.
+    const { failed } = await execa(command, ['--version'], {
+      stdio: 'ignore',
+      reject: false,
+    })
+    return !failed
+  } catch (error) {
+    // Catch errors for commands that don't support --version or other issues
+    return false
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gengjiawen/os-init",
   "private": false,
-  "version": "1.11.0",
+  "version": "1.13.0",
   "description": "",
   "main": "index.js",
   "bin": {