@gengjiawen/os-init 1.6.0 → 1.7.1

package/.husky/pre-commit

@@ -0,0 +1 @@
+pnpm lint-staged

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.7.1](https://github.com/gengjiawen/os-init/compare/v1.7.0...v1.7.1) (2025-11-09)
+
+
+### Bug Fixes
+
+* android CI ([#12](https://github.com/gengjiawen/os-init/issues/12)) ([535b011](https://github.com/gengjiawen/os-init/commit/535b0115b513902ceb6fd9ef98bcb8338ac9972e))
+
+## [1.7.0](https://github.com/gengjiawen/os-init/compare/v1.6.0...v1.7.0) (2025-11-09)
+
+
+### Features
+
+* add setup android sdk ([cb18d40](https://github.com/gengjiawen/os-init/commit/cb18d40e53e312b0aedc66a9cde6738bc2f4f1ba))
+
 ## [1.6.0](https://github.com/gengjiawen/os-init/compare/v1.5.1...v1.6.0) (2025-10-25)
 
 

package/README.md

@@ -54,6 +54,29 @@ Example:
 pnpx @gengjiawen/os-init set-dev "ssh-rsa AAAAB3NzaC1yc2..."
 ```
 
+### Setup Android Development Environment
+
+```bash
+pnpx @gengjiawen/os-init set-android
+```
+
+Sets up a complete Android development environment on macOS and Linux. This command will:
+- Install Android SDK to `~/Android` (or custom path with `--android-home <path>`)
+- Download and install Android SDK Command-line Tools, Platform Tools, Build Tools, CMake, and NDK
+- Automatically accept Android SDK licenses
+- Configure environment variables in your shell config (~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish)
+- Works on both macOS (Intel and Apple Silicon) and Linux
+- No sudo access required
+
+Example:
+```bash
+# Custom installation path
+pnpx @gengjiawen/os-init set-android --android-home ~/my-android-sdk
+
+# Skip environment variable configuration
+pnpx @gengjiawen/os-init set-android --skip-env-vars
+```
+
 ---
 
 Project generated by [gengjiawen/ts-scaffold](https://github.com/gengjiawen/ts-scaffold)

package/android-setup.md

@@ -0,0 +1,128 @@
+# Android Development Environment Setup
+
+This command sets up a complete Android development environment on macOS and Linux systems.
+
+## Usage
+
+```bash
+os-init set-android [options]
+```
+
+## What It Does
+
+The `set-android` command:
+
+1. **Creates Android SDK directory** at `~/Android` (or custom path)
+2. **Downloads and installs Android SDK** command-line tools (automatically detects macOS or Linux)
+3. **Accepts Android SDK licenses** automatically
+4. **Installs essential components**:
+   - Platform tools (adb, fastboot, etc.)
+   - Android 36 platform
+   - Build tools 36.0.0
+   - CMake 3.30.5
+   - NDK 29.0.14206865
+5. **Configures environment variables** in your shell configuration file (~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish)
+
+## Options
+
+- `--android-home <path>` - Custom Android SDK installation path (default: `~/Android`)
+- `--skip-env-vars` - Skip adding environment variables to shell config
+
+## Examples
+
+### Basic Installation
+
+```bash
+os-init set-android
+```
+
+This installs the Android SDK to `~/Android` and adds environment variables to your shell config.
+
+### Custom Installation Path
+
+```bash
+os-init set-android --android-home /home/user/android-sdk
+```
+
+### Skip Environment Variables
+
+If you prefer to manage environment variables manually:
+
+```bash
+os-init set-android --skip-env-vars
+```
+
+## Requirements
+
+- **macOS or Linux operating system**
+- Internet connection to download Android SDK
+- Node.js 22.12.0 or higher
+
+The script uses `@compilets/unzip-url` package to download and extract the Android SDK, so no external `curl` or `unzip` tools are required. No sudo access is needed as the SDK is installed in your home directory.
+
+## Environment Variables
+
+After installation, the following environment variables will be set:
+
+```bash
+export ANDROID_HOME=~/Android
+export ANDROID_SDK_ROOT=${ANDROID_HOME}
+export ANDROID_NDK_HOME=${ANDROID_HOME}/ndk/29.0.14206865
+export PATH=${ANDROID_HOME}/cmdline-tools/latest/bin:${ANDROID_HOME}/emulator:${ANDROID_HOME}/platform-tools:${ANDROID_HOME}/tools:${ANDROID_HOME}/tools/bin:${PATH}
+```
+
+## Activating the Environment
+
+After installation, activate the environment in your current shell:
+
+```bash
+source ~/.bashrc  # or ~/.zshrc, or ~/.config/fish/config.fish
+```
+
+Or simply open a new terminal session.
+
+## Verifying Installation
+
+Check that the Android SDK is properly installed:
+
+```bash
+adb --version
+sdkmanager --list
+```
+
+## Platform-Specific Notes
+
+### macOS
+- The SDK is downloaded from Google's macOS-specific distribution
+- Works on both Intel and Apple Silicon Macs
+- No sudo permissions required
+
+### Linux
+- The SDK is downloaded from Google's Linux-specific distribution
+- Tested on Ubuntu and Debian-based systems
+- No sudo permissions required when installing to home directory
+
+## Troubleshooting
+
+### Command Not Found After Installation
+
+Make sure you've sourced your shell configuration file or opened a new terminal:
+
+```bash
+source ~/.bashrc  # or your shell's config file
+```
+
+### Download Failures
+
+If the Android SDK download fails, check your internet connection and try again. The script will show detailed error messages.
+
+## What Gets Installed
+
+- **Android SDK Command-line Tools** (version 11076708)
+- **Platform Tools** - adb, fastboot, etc.
+- **Android Platform 36** - Latest Android API level
+- **Build Tools 36.0.0** - Tools for building Android apps
+- **CMake 3.30.5** - For native code compilation
+- **NDK 29.0.14206865** - Native Development Kit for C/C++ code
+
+

package/bin/bin.js

@@ -8,6 +8,7 @@ const {
   installCodexDeps,
   writeRaycastConfig,
   setupDevEnvironment,
+  setupAndroidEnvironment,
 } = require('../build')
 
 const program = new Command()
@@ -102,4 +103,29 @@ program
     }
   })
 
+program
+  .command('set-android')
+  .description('setup Android development environment (macOS and Linux)')
+  .option('--android-home <path>', 'Custom Android SDK installation path')
+  .option(
+    '--skip-env-vars',
+    'Skip adding environment variables to shell config'
+  )
+  .action(async (options) => {
+    try {
+      const { androidHome, envVarsAdded, shellRcFile } =
+        await setupAndroidEnvironment({
+          androidHome: options.androidHome,
+          skipEnvVars: options.skipEnvVars,
+        })
+      console.log(`\n✅ Android SDK installed at: ${androidHome}`)
+      if (envVarsAdded && shellRcFile) {
+        console.log(`✅ Environment variables added to: ${shellRcFile}`)
+      }
+    } catch (err) {
+      console.error('Failed to setup Android environment:', err.message)
+      process.exit(1)
+    }
+  })
+
 program.parse(process.argv)

package/build/android-setup.d.ts

@@ -0,0 +1,8 @@
+export declare function setupAndroidEnvironment(options?: {
+    androidHome?: string;
+    skipEnvVars?: boolean;
+}): Promise<{
+    androidHome: string;
+    envVarsAdded: boolean;
+    shellRcFile?: string;
+}>;

package/build/android-setup.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupAndroidEnvironment = setupAndroidEnvironment;
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const execa_1 = require("execa");
+const unzip_url_1 = require("@gengjiawen/unzip-url");
+const fish_shell_utils_1 = require("./fish-shell-utils");
+const ANDROID_CONFIG = {
+    sdkVersion: '11076708',
+    platformVersion: 'android-36',
+    buildToolsVersion: '36.0.0',
+    cmakeVersion: '3.30.5',
+    ndkVersion: '29.0.14206865',
+};
+function getDefaultAndroidHome() {
+    return path.join(os.homedir(), 'Android');
+}
+function getSdkDownloadUrl(sdkVersion) {
+    const platform = os.platform();
+    if (platform === 'darwin') {
+        return `https://dl.google.com/android/repository/commandlinetools-mac-${sdkVersion}_latest.zip`;
+    }
+    else if (platform === 'linux') {
+        return `https://dl.google.com/android/repository/commandlinetools-linux-${sdkVersion}_latest.zip`;
+    }
+    else {
+        throw new Error(`Unsupported platform: ${platform}. Only macOS and Linux are supported.`);
+    }
+}
+function getAndroidEnvVars(androidHome, ndkVersion) {
+    return `
+# ===== Android development environment - START (2025-11-09) =====
+export ANDROID_HOME=${androidHome}
+export ANDROID_SDK_ROOT=\${ANDROID_HOME}
+export ANDROID_NDK_HOME=\${ANDROID_HOME}/ndk/${ndkVersion}
+export PATH=\${ANDROID_HOME}/cmdline-tools/bin:\${ANDROID_HOME}/cmdline-tools/latest/bin:\${ANDROID_HOME}/emulator:\${ANDROID_HOME}/platform-tools:\${ANDROID_HOME}/tools:\${ANDROID_HOME}/tools/bin:\${PATH}
+# ===== Android development environment - END =====
+`;
+}
+function getShellRcFile() {
+    const shell = process.env.SHELL || '';
+    const homeDir = os.homedir();
+    if (shell.includes('zsh')) {
+        return path.join(homeDir, '.zshrc');
+    }
+    else if (shell.includes('fish')) {
+        return path.join(homeDir, '.config', 'fish', 'config.fish');
+    }
+    else {
+        return path.join(homeDir, '.bashrc');
+    }
+}
+function hasAndroidEnvVars(rcFile) {
+    if (!fs.existsSync(rcFile)) {
+        return false;
+    }
+    const content = fs.readFileSync(rcFile, 'utf-8');
+    return content.includes('ANDROID_HOME');
+}
+function appendEnvVarsToShellConfig(rcFile, envVars) {
+    const shell = process.env.SHELL || '';
+    const homeDir = os.homedir();
+    const bashrcFile = path.join(homeDir, '.bashrc');
+    if (!fs.existsSync(bashrcFile) ||
+        !fs.readFileSync(bashrcFile, 'utf-8').includes('ANDROID_HOME')) {
+        fs.appendFileSync(bashrcFile, envVars);
+        console.log(`Environment variables added to: ${bashrcFile}`);
+    }
+    else {
+        console.log(`Environment variables already exist in: ${bashrcFile}`);
+    }
+    if (shell.includes('fish')) {
+        (0, fish_shell_utils_1.appendFishImportScript)(rcFile);
+    }
+}
+async function setupAndroidEnvironment(options) {
+    const androidHome = options?.androidHome || getDefaultAndroidHome();
+    const { sdkVersion, platformVersion, buildToolsVersion, cmakeVersion, ndkVersion, } = ANDROID_CONFIG;
+    console.log('Starting Android development environment setup...\n');
+    const platform = os.platform();
+    if (platform !== 'linux' && platform !== 'darwin') {
+        throw new Error(`Unsupported platform: ${platform}. Only macOS and Linux are supported.`);
+    }
+    console.log(`Platform: ${platform === 'darwin' ? 'macOS' : 'Linux'}`);
+    console.log(`Creating Android SDK directory at: ${androidHome}`);
+    try {
+        if (!fs.existsSync(androidHome)) {
+            fs.mkdirSync(androidHome, { recursive: true });
+        }
+    }
+    catch (error) {
+        throw new Error(`Failed to create Android directory: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    console.log('\nDownloading and setting up Android SDK...');
+    const sdkUrl = getSdkDownloadUrl(sdkVersion);
+    const cmdlineToolsPath = path.join(androidHome, 'cmdline-tools');
+    const latestPath = path.join(cmdlineToolsPath, 'latest');
+    const latestBin = path.join(latestPath, 'bin');
+    try {
+        if (!fs.existsSync(latestBin)) {
+            console.log(`Downloading and extracting from: ${sdkUrl} to ${androidHome}`);
+            await (0, unzip_url_1.unzip)(sdkUrl, cmdlineToolsPath);
+            const tmp_toolchain = path.join(cmdlineToolsPath, 'cmdline-tools');
+            fs.renameSync(tmp_toolchain, latestPath);
+            console.log('Android SDK extracted successfully');
+        }
+    }
+    catch (error) {
+        throw new Error(`Failed to download/extract Android SDK: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const sdkmanagerBinary = path.join(latestBin, 'sdkmanager');
+    const sdkmanagerEnv = {
+        ...process.env,
+        ANDROID_HOME: androidHome,
+        ANDROID_SDK_ROOT: androidHome,
+        PATH: `${latestBin}:${process.env.PATH}`,
+    };
+    console.log('\nAccepting Android SDK licenses...');
+    try {
+        await (0, execa_1.execa)('bash', [
+            '-c',
+            `yes | "${sdkmanagerBinary}" --sdk_root=${androidHome} --licenses`,
+        ], {
+            env: sdkmanagerEnv,
+            stdio: 'inherit',
+        });
+    }
+    catch (error) {
+        console.warn('Warning: License acceptance may have failed, but continuing...');
+    }
+    console.log('\nInstalling Android SDK components...');
+    const components = [
+        'platform-tools',
+        `platforms;${platformVersion}`,
+        `build-tools;${buildToolsVersion}`,
+        `cmake;${cmakeVersion}`,
+        `ndk;${ndkVersion}`,
+    ];
+    try {
+        await (0, execa_1.execa)(sdkmanagerBinary, [`--sdk_root=${androidHome}`, ...components], {
+            env: sdkmanagerEnv,
+            stdio: 'inherit',
+        });
+        console.log('Android SDK components installed successfully');
+    }
+    catch (error) {
+        throw new Error(`Failed to install SDK components: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const androidConfigDir = path.join(androidHome, '.android');
+    if (fs.existsSync(androidConfigDir)) {
+        fs.rmSync(androidConfigDir, { recursive: true, force: true });
+    }
+    if (platform === 'linux' && androidHome.startsWith('/opt')) {
+        try {
+            await (0, execa_1.execa)('chmod', ['-R', '777', androidHome], { stdio: 'inherit' });
+        }
+        catch (error) {
+            console.warn('Warning: Failed to set permissions, but continuing...');
+        }
+    }
+    console.log('\n✅ Android SDK installation completed!');
+    let envVarsAdded = false;
+    let shellRcFile;
+    if (!options?.skipEnvVars) {
+        shellRcFile = getShellRcFile();
+        console.log(`\nConfiguring shell environment in: ${shellRcFile}`);
+        if (hasAndroidEnvVars(shellRcFile)) {
+            console.log('Android environment variables already exist in shell config, skipping...');
+        }
+        else {
+            const envVars = getAndroidEnvVars(androidHome, ndkVersion);
+            appendEnvVarsToShellConfig(shellRcFile, envVars);
+            envVarsAdded = true;
+        }
+        console.log('\n📋 To activate the environment in your current shell, run:');
+        console.log(`  source ${shellRcFile}`);
+    }
+    console.log('\n✅ Android development environment setup completed successfully!');
+    return {
+        androidHome,
+        envVarsAdded,
+        shellRcFile,
+    };
+}

package/build/fish-shell-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function getFishImportBashExports(): string;
+export declare function appendFishImportScript(fishConfigPath: string): void;

package/build/fish-shell-utils.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFishImportBashExports = getFishImportBashExports;
+exports.appendFishImportScript = appendFishImportScript;
+const fs = require("fs");
+const path = require("path");
+function getFishImportBashExports() {
+    return `
+# ===== Import environment variables from .bashrc - START (2025-11-09) =====
+egrep "^export " ~/.bashrc | while read e
+	set var (echo $e | sed -E "s/^export ([A-Za-z_0-9]+)=(.*)\\$/\\1/")
+	set value (echo $e | sed -E "s/^export ([A-Za-z_0-9]+)=(.*)\\$/\\2/")
+
+	# remove surrounding quotes if existing
+	set value (echo $value | sed -E "s/^\\"(.*)\\"\\$/\\1/")
+
+	# convert Bash \${VAR} to fish {\$VAR} before eval
+	set value (printf '%s' "$value" | sed -E 's/\\$\\{([A-Za-z_][A-Za-z0-9_]*)\\}/{$\\1}/g')
+
+	if test $var = "PATH"
+		# replace ":" by spaces. this is how PATH looks for Fish
+		set value (echo $value | sed -E "s/:/ /g")
+
+		# use eval because we need to expand the value
+		eval set -xg $var $value
+
+		continue
+	end
+
+	# evaluate variables. we can use eval because we most likely just used "$var"
+	set value (eval echo $value)
+
+	#echo "set -xg '$var' '$value' (via '$e')"
+	set -xg $var $value
+end
+# ===== Import environment variables from .bashrc - END =====
+`;
+}
+function appendFishImportScript(fishConfigPath) {
+    const configDir = path.dirname(fishConfigPath);
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+    const fishContent = fs.existsSync(fishConfigPath)
+        ? fs.readFileSync(fishConfigPath, 'utf-8')
+        : '';
+    if (!fishContent.includes('Import environment variables from .bashrc - START')) {
+        const fishScript = getFishImportBashExports();
+        fs.appendFileSync(fishConfigPath, fishScript);
+        console.log(`Fish import script added to: ${fishConfigPath}`);
+    }
+    else {
+        console.log(`Fish import script already exists in: ${fishConfigPath}`);
+    }
+}

package/build/index.d.ts

@@ -12,3 +12,4 @@ export declare function writeRaycastConfig(apiKey: string): {
     configPath: string;
 };
 export { setupDevEnvironment } from './dev-setup';
+export { setupAndroidEnvironment } from './android-setup';

package/build/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setupDevEnvironment = void 0;
+exports.setupAndroidEnvironment = exports.setupDevEnvironment = void 0;
 exports.writeClaudeConfig = writeClaudeConfig;
 exports.installDeps = installDeps;
 exports.writeCodexConfig = writeCodexConfig;
@@ -165,3 +165,5 @@ function writeRaycastConfig(apiKey) {
 }
 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");
+Object.defineProperty(exports, "setupAndroidEnvironment", { enumerable: true, get: function () { return android_setup_1.setupAndroidEnvironment; } });

package/dev-setup/docker-compose.yml

@@ -14,4 +14,3 @@ services:
       - SYS_PTRACE
     volumes:
       - .:/pwd
-      - $HOME/.local:/root/.local

package/libs/android-setup.ts

@@ -0,0 +1,263 @@
+import * as fs from 'fs'
+import * as path from 'path'
+import * as os from 'os'
+import { execa } from 'execa'
+import { unzip } from '@gengjiawen/unzip-url'
+import { appendFishImportScript } from './fish-shell-utils'
+
+/** Android SDK configuration */
+const ANDROID_CONFIG = {
+  sdkVersion: '11076708',
+  platformVersion: 'android-36',
+  buildToolsVersion: '36.0.0',
+  cmakeVersion: '3.30.5',
+  ndkVersion: '29.0.14206865',
+} as const
+
+/** Get default Android home directory */
+function getDefaultAndroidHome(): string {
+  return path.join(os.homedir(), 'Android')
+}
+
+/** Get SDK download URL based on platform */
+function getSdkDownloadUrl(sdkVersion: string): string {
+  const platform = os.platform()
+  if (platform === 'darwin') {
+    return `https://dl.google.com/android/repository/commandlinetools-mac-${sdkVersion}_latest.zip`
+  } else if (platform === 'linux') {
+    return `https://dl.google.com/android/repository/commandlinetools-linux-${sdkVersion}_latest.zip`
+  } else {
+    throw new Error(
+      `Unsupported platform: ${platform}. Only macOS and Linux are supported.`
+    )
+  }
+}
+
+/** Get Android environment variables */
+function getAndroidEnvVars(androidHome: string, ndkVersion: string): string {
+  return `
+# ===== Android development environment - START (2025-11-09) =====
+export ANDROID_HOME=${androidHome}
+export ANDROID_SDK_ROOT=\${ANDROID_HOME}
+export ANDROID_NDK_HOME=\${ANDROID_HOME}/ndk/${ndkVersion}
+export PATH=\${ANDROID_HOME}/cmdline-tools/bin:\${ANDROID_HOME}/cmdline-tools/latest/bin:\${ANDROID_HOME}/emulator:\${ANDROID_HOME}/platform-tools:\${ANDROID_HOME}/tools:\${ANDROID_HOME}/tools/bin:\${PATH}
+# ===== Android development environment - END =====
+`
+}
+
+/** Detect shell configuration file */
+function getShellRcFile(): string {
+  const shell = process.env.SHELL || ''
+  const homeDir = os.homedir()
+
+  if (shell.includes('zsh')) {
+    return path.join(homeDir, '.zshrc')
+  } else if (shell.includes('fish')) {
+    return path.join(homeDir, '.config', 'fish', 'config.fish')
+  } else {
+    return path.join(homeDir, '.bashrc')
+  }
+}
+
+/** Check if Android environment variables already exist in shell config */
+function hasAndroidEnvVars(rcFile: string): boolean {
+  if (!fs.existsSync(rcFile)) {
+    return false
+  }
+  const content = fs.readFileSync(rcFile, 'utf-8')
+  return content.includes('ANDROID_HOME')
+}
+
+/** Append Android environment variables to shell config */
+function appendEnvVarsToShellConfig(rcFile: string, envVars: string): void {
+  const shell = process.env.SHELL || ''
+  const homeDir = os.homedir()
+  const bashrcFile = path.join(homeDir, '.bashrc')
+
+  // Write to bashrc
+  if (
+    !fs.existsSync(bashrcFile) ||
+    !fs.readFileSync(bashrcFile, 'utf-8').includes('ANDROID_HOME')
+  ) {
+    fs.appendFileSync(bashrcFile, envVars)
+    console.log(`Environment variables added to: ${bashrcFile}`)
+  } else {
+    console.log(`Environment variables already exist in: ${bashrcFile}`)
+  }
+
+  // For fish shell, always write to bashrc first, then add import script to fish config
+  if (shell.includes('fish')) {
+    appendFishImportScript(rcFile)
+  }
+}
+
+/** Setup Android development environment */
+export async function setupAndroidEnvironment(options?: {
+  androidHome?: string
+  skipEnvVars?: boolean
+}): Promise<{
+  androidHome: string
+  envVarsAdded: boolean
+  shellRcFile?: string
+}> {
+  const androidHome = options?.androidHome || getDefaultAndroidHome()
+  const {
+    sdkVersion,
+    platformVersion,
+    buildToolsVersion,
+    cmakeVersion,
+    ndkVersion,
+  } = ANDROID_CONFIG
+
+  console.log('Starting Android development environment setup...\n')
+
+  // Check if running on supported platform
+  const platform = os.platform()
+  if (platform !== 'linux' && platform !== 'darwin') {
+    throw new Error(
+      `Unsupported platform: ${platform}. Only macOS and Linux are supported.`
+    )
+  }
+
+  console.log(`Platform: ${platform === 'darwin' ? 'macOS' : 'Linux'}`)
+
+  // Create Android directory
+  console.log(`Creating Android SDK directory at: ${androidHome}`)
+  try {
+    if (!fs.existsSync(androidHome)) {
+      fs.mkdirSync(androidHome, { recursive: true })
+    }
+  } catch (error) {
+    throw new Error(
+      `Failed to create Android directory: ${error instanceof Error ? error.message : String(error)}`
+    )
+  }
+
+  // Download and setup Android SDK
+  console.log('\nDownloading and setting up Android SDK...')
+  const sdkUrl = getSdkDownloadUrl(sdkVersion)
+
+  const cmdlineToolsPath = path.join(androidHome, 'cmdline-tools')
+  const latestPath = path.join(cmdlineToolsPath, 'latest')
+  const latestBin = path.join(latestPath, 'bin')
+
+  try {
+    // Download and extract SDK using unzip-url
+    if (!fs.existsSync(latestBin)) {
+      console.log(
+        `Downloading and extracting from: ${sdkUrl} to ${androidHome}`
+      )
+      await unzip(sdkUrl, cmdlineToolsPath)
+      const tmp_toolchain = path.join(cmdlineToolsPath, 'cmdline-tools')
+      fs.renameSync(tmp_toolchain, latestPath)
+      console.log('Android SDK extracted successfully')
+    }
+  } catch (error) {
+    throw new Error(
+      `Failed to download/extract Android SDK: ${error instanceof Error ? error.message : String(error)}`
+    )
+  }
+  const sdkmanagerBinary = path.join(latestBin, 'sdkmanager')
+
+  const sdkmanagerEnv = {
+    ...process.env,
+    ANDROID_HOME: androidHome,
+    ANDROID_SDK_ROOT: androidHome,
+    PATH: `${latestBin}:${process.env.PATH}`,
+  }
+
+  // Accept licenses
+  console.log('\nAccepting Android SDK licenses...')
+  try {
+    await execa(
+      'bash',
+      [
+        '-c',
+        `yes | "${sdkmanagerBinary}" --sdk_root=${androidHome} --licenses`,
+      ],
+      {
+        env: sdkmanagerEnv,
+        stdio: 'inherit',
+      }
+    )
+  } catch (error) {
+    console.warn(
+      'Warning: License acceptance may have failed, but continuing...'
+    )
+  }
+
+  // Install SDK components
+  console.log('\nInstalling Android SDK components...')
+  const components = [
+    'platform-tools',
+    `platforms;${platformVersion}`,
+    `build-tools;${buildToolsVersion}`,
+    `cmake;${cmakeVersion}`,
+    `ndk;${ndkVersion}`,
+  ]
+
+  try {
+    await execa(
+      sdkmanagerBinary,
+      [`--sdk_root=${androidHome}`, ...components],
+      {
+        env: sdkmanagerEnv,
+        stdio: 'inherit',
+      }
+    )
+    console.log('Android SDK components installed successfully')
+  } catch (error) {
+    throw new Error(
+      `Failed to install SDK components: ${error instanceof Error ? error.message : String(error)}`
+    )
+  }
+
+  // Clean up .android directory
+  const androidConfigDir = path.join(androidHome, '.android')
+  if (fs.existsSync(androidConfigDir)) {
+    fs.rmSync(androidConfigDir, { recursive: true, force: true })
+  }
+
+  // Set permissions (only needed on Linux for system-wide installs)
+  if (platform === 'linux' && androidHome.startsWith('/opt')) {
+    try {
+      await execa('chmod', ['-R', '777', androidHome], { stdio: 'inherit' })
+    } catch (error) {
+      console.warn('Warning: Failed to set permissions, but continuing...')
+    }
+  }
+
+  console.log('\n✅ Android SDK installation completed!')
+
+  // Handle environment variables
+  let envVarsAdded = false
+  let shellRcFile: string | undefined
+
+  if (!options?.skipEnvVars) {
+    shellRcFile = getShellRcFile()
+    console.log(`\nConfiguring shell environment in: ${shellRcFile}`)
+
+    if (hasAndroidEnvVars(shellRcFile)) {
+      console.log(
+        'Android environment variables already exist in shell config, skipping...'
+      )
+    } else {
+      const envVars = getAndroidEnvVars(androidHome, ndkVersion)
+      appendEnvVarsToShellConfig(shellRcFile, envVars)
+      envVarsAdded = true
+    }
+
+    console.log('\n📋 To activate the environment in your current shell, run:')
+    console.log(`  source ${shellRcFile}`)
+  }
+
+  console.log(
+    '\n✅ Android development environment setup completed successfully!'
+  )
+
+  return {
+    androidHome,
+    envVarsAdded,
+    shellRcFile,
+  }
+}

package/libs/fish-shell-utils.ts

@@ -0,0 +1,64 @@
+import * as fs from 'fs'
+import * as path from 'path'
+
+/** Get Fish shell script to import bash exports */
+export function getFishImportBashExports(): string {
+  return `
+# ===== Import environment variables from .bashrc - START (2025-11-09) =====
+egrep "^export " ~/.bashrc | while read e
+	set var (echo $e | sed -E "s/^export ([A-Za-z_0-9]+)=(.*)\\$/\\1/")
+	set value (echo $e | sed -E "s/^export ([A-Za-z_0-9]+)=(.*)\\$/\\2/")
+
+	# remove surrounding quotes if existing
+	set value (echo $value | sed -E "s/^\\"(.*)\\"\\$/\\1/")
+
+	# convert Bash \${VAR} to fish {\$VAR} before eval
+	set value (printf '%s' "$value" | sed -E 's/\\$\\{([A-Za-z_][A-Za-z0-9_]*)\\}/{$\\1}/g')
+
+	if test $var = "PATH"
+		# replace ":" by spaces. this is how PATH looks for Fish
+		set value (echo $value | sed -E "s/:/ /g")
+
+		# use eval because we need to expand the value
+		eval set -xg $var $value
+
+		continue
+	end
+
+	# evaluate variables. we can use eval because we most likely just used "$var"
+	set value (eval echo $value)
+
+	#echo "set -xg '$var' '$value' (via '$e')"
+	set -xg $var $value
+end
+# ===== Import environment variables from .bashrc - END =====
+`
+}
+
+/**
+ * Append bash import script to Fish shell config file
+ * This function adds the import script to fish config.fish to automatically
+ * source environment variables from .bashrc
+ */
+export function appendFishImportScript(fishConfigPath: string): void {
+  // Ensure fish config directory exists
+  const configDir = path.dirname(fishConfigPath)
+  if (!fs.existsSync(configDir)) {
+    fs.mkdirSync(configDir, { recursive: true })
+  }
+
+  // Check if import script already exists
+  const fishContent = fs.existsSync(fishConfigPath)
+    ? fs.readFileSync(fishConfigPath, 'utf-8')
+    : ''
+
+  if (
+    !fishContent.includes('Import environment variables from .bashrc - START')
+  ) {
+    const fishScript = getFishImportBashExports()
+    fs.appendFileSync(fishConfigPath, fishScript)
+    console.log(`Fish import script added to: ${fishConfigPath}`)
+  } else {
+    console.log(`Fish import script already exists in: ${fishConfigPath}`)
+  }
+}

package/libs/index.ts

@@ -210,3 +210,6 @@ export function writeRaycastConfig(apiKey: string): { configPath: string } {
 
 // Re-export dev-setup functionality
 export { setupDevEnvironment } from './dev-setup'
+
+// Re-export android-setup functionality
+export { setupAndroidEnvironment } from './android-setup'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gengjiawen/os-init",
   "private": false,
-  "version": "1.6.0",
+  "version": "1.7.1",
   "description": "",
   "main": "index.js",
   "bin": {
@@ -10,7 +10,7 @@
   "scripts": {
     "dev": "tsc -w",
     "server": "nodemon --exec ts-node libs/index.ts",
-    "prepare": "husky install",
+    "prepare": "husky",
     "clean": "rimraf build",
     "format": "prettier --write \"{examples,libs,script,bin}/**/*.{js,ts}\" \"**/*.yml\"",
     "format:check": "prettier --list-different \"{examples,libs,script,bin}/**/*.{js,ts}\" \"**/*.yml\"",
@@ -19,6 +19,7 @@
     "postbuild": "cpy '**/*' '!**/*.ts' ../build/ --cwd=libs --parents"
   },
   "dependencies": {
+    "@gengjiawen/unzip-url": "^1.0.0",
     "commander": "^12.1.0",
     "ip": "^2.0.1",
     "execa": "^8.0.1"