@gengjiawen/os-init 1.12.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,12 @@
 # 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)
 
 

package/bin/bin.js

@@ -90,18 +90,28 @@ program
 
 program
   .command('set-agents')
-  .description('setup all AI agents (Claude Code, Codex, Gemini CLI) at once')
-  .argument('<apiKey>', 'API key to set for all agents')
-  .action(async (apiKey) => {
+  .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('Setting up all AI agents...\n')
+      console.log(
+        full
+          ? 'Setting up Claude Code + Codex + Gemini CLI...\n'
+          : 'Setting up Claude Code + Codex...\n'
+      )
 
-      const result = writeAllAgentsConfig(apiKey)
+      const result = writeAllAgentsConfig(apiKey, { full })
 
       console.log('Claude Code:')
       console.log(`  Settings written to: ${result.claude.settingsPath}`)
@@ -110,20 +120,23 @@ program
       console.log(`  Config written to: ${result.codex.configPath}`)
       console.log(`  Auth written to: ${result.codex.authPath}`)
 
-      console.log('\nGemini CLI:')
-      console.log(`  Env written to: ${result.gemini.envPath}`)
-      console.log(`  Settings written to: ${result.gemini.settingsPath}`)
+      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()
+      await installAllAgentsDeps({ full })
     } catch (err) {
       console.error('Failed to setup agents:', err.message)
       process.exit(1)
     }
-    console.log('\nAll agents are ready!')
+
+    console.log('\nSetup complete!')
     console.log('  - Use `claude` for Claude Code')
     console.log('  - Use `codex` for Codex')
-    console.log('  - Use `gemini` for Gemini CLI')
+    if (full) console.log('  - Use `gemini` for Gemini CLI')
   })
 
 program

package/build/all-agents.d.ts

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

package/build/all-agents.js

@@ -5,16 +5,21 @@ 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) {
+function writeAllAgentsConfig(apiKey, options = {}) {
     const claudeResult = (0, claude_code_1.writeClaudeConfig)(apiKey);
     const codexResult = (0, codex_1.writeCodexConfig)(apiKey);
-    const geminiResult = (0, gemini_cli_1.writeGeminiConfig)(apiKey);
-    return {
+    const result = {
         claude: claudeResult,
         codex: codexResult,
-        gemini: geminiResult,
     };
+    if (options.full) {
+        result.gemini = (0, gemini_cli_1.writeGeminiConfig)(apiKey);
+    }
+    return result;
 }
-async function installAllAgentsDeps() {
-    await Promise.all([(0, claude_code_1.installDeps)(), (0, codex_1.installCodexDeps)(), (0, gemini_cli_1.installGeminiDeps)()]);
+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/libs/all-agents.ts

@@ -2,26 +2,42 @@ 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 }
+  gemini?: { envPath: string; settingsPath: string }
 }
 
-/** Write configuration for all three agents (Claude Code, Codex, Gemini CLI) */
-export function writeAllAgentsConfig(apiKey: string): AllAgentsResult {
+/** 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 geminiResult = writeGeminiConfig(apiKey)
 
-  return {
+  const result: AllAgentsResult = {
     claude: claudeResult,
     codex: codexResult,
-    gemini: geminiResult,
   }
+
+  if (options.full) {
+    result.gemini = writeGeminiConfig(apiKey)
+  }
+
+  return result
 }
 
-/** Install dependencies for all three agents */
-export async function installAllAgentsDeps(): Promise<void> {
-  await Promise.all([installDeps(), installCodexDeps(), installGeminiDeps()])
+/** 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/package.json

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