switch-acc-agy 0.1.0

package/README.md

@@ -0,0 +1,382 @@
+# switch-agy
+
+`switch-agy` là tool switch account local cho Antigravity CLI (`agy`) trên
+macOS.
+
+Mục tiêu: sau khi bạn login thủ công mỗi account một lần, bạn có thể switch
+account ngay từ terminal mà không cần mở browser hay nhập code lại:
+
+```bash
+switch-acc-agy-to acc1
+agy --prompt "hello"
+```
+
+Tool hoạt động bằng cách lưu và khôi phục 2 nơi chứa credential mà `agy` đang
+dùng trên máy này:
+
+- `~/.gemini/oauth_creds.json`
+- macOS Keychain generic password `service=gemini`, `account=antigravity`
+
+Tool không tự động login Google. Nó chỉ snapshot credential đã có sẵn trên máy
+và restore lại khi cần switch.
+
+## Yêu Cầu
+
+- macOS
+- Node.js và `npm`
+- `agy` đã cài và chạy được
+- Ít nhất một account Antigravity/Gemini đã login sẵn
+
+Kiểm tra:
+
+```bash
+node --version
+npm --version
+command -v agy
+```
+
+## Cài Đặt
+
+Cách gọn nhất trên máy mới là cài global qua `npm`. Không cần `cd` vào repo để
+tạo symlink tay nữa.
+
+Nếu máy có quyền pull repo qua GitHub SSH:
+
+```bash
+npm install -g git+ssh://git@github.com/XuanMaiHieu/switch-acc-agy.git
+```
+
+Nếu đã clone repo sẵn trên máy:
+
+```bash
+npm install -g /path/to/switch-agy
+```
+
+Verify:
+
+```bash
+command -v switch-acc-agy
+switch-acc-agy paths
+```
+
+`npm` sẽ tự tạo các command global:
+
+- `switch-acc-agy`
+- `switch-acc-agy-save`
+- `switch-acc-agy-to`
+
+Nếu shell chưa nhận ra command ngay, mở terminal mới hoặc reload shell config.
+
+Path kỳ vọng trên máy này:
+
+```text
+store: /Users/abc-dev/.switch-agy
+profiles: /Users/abc-dev/.switch-agy/profiles
+backups: /Users/abc-dev/.switch-agy/backups
+oauth_creds: /Users/abc-dev/.gemini/oauth_creds.json
+keychain_service: gemini
+keychain_account: antigravity
+```
+
+## Setup Lần Đầu Cho Nhiều Account
+
+Bạn cần login thủ công từng account một lần. Sau mỗi lần login, lưu trạng thái
+credential hiện tại thành một profile.
+
+### Lưu Account 1
+
+Login account 1 bằng flow bình thường của Antigravity/Gemini. Kiểm tra account
+đang chạy được:
+
+```bash
+agy --prompt "say account one works"
+```
+
+Lưu lại:
+
+```bash
+switch-acc-agy-save acc1
+```
+
+### Lưu Account 2
+
+Logout hoặc đổi login thủ công sang account 2 bằng flow bình thường của
+Antigravity/Gemini. Kiểm tra account đang chạy được:
+
+```bash
+agy --prompt "say account two works"
+```
+
+Lưu lại:
+
+```bash
+switch-acc-agy-save acc2
+```
+
+Xem danh sách profile đã lưu:
+
+```bash
+switch-acc-agy list
+```
+
+Ví dụ output:
+
+```text
+acc1
+acc2 *
+```
+
+Dấu `*` là profile mà tool lưu hoặc switch gần nhất.
+
+## Sử Dụng Hàng Ngày
+
+Switch sang account 1:
+
+```bash
+switch-acc-agy-to acc1
+agy --prompt "hello from acc1"
+```
+
+Switch sang account 2:
+
+```bash
+switch-acc-agy-to acc2
+agy --prompt "hello from acc2"
+```
+
+Lưu ý quan trọng: sau khi switch, hãy chạy một process `agy` mới. Những session
+`agy` đang mở từ trước có thể vẫn cache token cũ trong memory.
+
+## Lệnh Có Sẵn
+
+Lưu auth hiện tại thành profile:
+
+```bash
+switch-acc-agy save <profile>
+switch-acc-agy-save <profile>
+```
+
+Switch sang một profile đã lưu:
+
+```bash
+switch-acc-agy to <profile>
+switch-acc-agy-to <profile>
+```
+
+Liệt kê profile:
+
+```bash
+switch-acc-agy list
+```
+
+Xem profile được chọn gần nhất:
+
+```bash
+switch-acc-agy current
+```
+
+Xem path và Keychain identifier mà tool đang dùng:
+
+```bash
+switch-acc-agy paths
+```
+
+Xem help:
+
+```bash
+switch-acc-agy --help
+```
+
+## Quy Tắc Đặt Tên Profile
+
+Tên profile hợp lệ:
+
+- Bắt đầu bằng chữ cái
+- Chỉ dùng chữ cái, số, dấu gạch ngang, dấu gạch dưới
+- Tối đa 32 ký tự
+
+Ví dụ hợp lệ:
+
+```text
+acc1
+work
+personal
+gmail_main
+team-pro
+```
+
+Không hợp lệ:
+
+```text
+1acc
+my.account
+work/email
+```
+
+## Dữ Liệu Được Lưu Ở Đâu
+
+Profiles:
+
+```text
+~/.switch-agy/profiles/<profile>/
+  oauth_creds.json
+  keychain_secret
+  metadata.json
+```
+
+Backups:
+
+```text
+~/.switch-agy/backups/<timestamp>/
+  oauth_creds.json
+  keychain_secret
+```
+
+Credential live sẽ bị thay khi switch:
+
+```text
+~/.gemini/oauth_creds.json
+macOS Keychain: service=gemini account=antigravity
+```
+
+Tool cố gắng set quyền file credential là `0600` và quyền thư mục profile là
+`0700`.
+
+## Lưu Ý Bảo Mật
+
+Profile đã lưu chứa OAuth credential thật. Hãy coi `~/.switch-agy` là dữ liệu
+bí mật.
+
+Không commit thư mục này:
+
+```bash
+echo ".switch-agy/" >> ~/.gitignore_global
+git config --global core.excludesfile ~/.gitignore_global
+```
+
+Không paste `oauth_creds.json` hoặc `keychain_secret` vào chat, log, issue,
+ticket.
+
+Nếu một profile bị lộ, hãy revoke session Google đó, login thủ công lại, rồi
+lưu lại profile:
+
+```bash
+switch-acc-agy-save acc1
+```
+
+## Rollback
+
+Mỗi lần switch, tool tự tạo backup:
+
+```text
+~/.switch-agy/backups/YYYYMMDD-HHMMSS
+```
+
+Ví dụ rollback thủ công:
+
+```bash
+backup="$HOME/.switch-agy/backups/20260520-223404"
+cp "$backup/oauth_creds.json" "$HOME/.gemini/oauth_creds.json"
+chmod 600 "$HOME/.gemini/oauth_creds.json"
+security add-generic-password -U -a antigravity -s gemini -w "$(cat "$backup/keychain_secret")"
+```
+
+Sau đó chạy một process `agy` mới:
+
+```bash
+agy --prompt "hello"
+```
+
+## Troubleshooting
+
+### `switch-acc-agy-to: command not found`
+
+Khả năng cao là thư mục global prefix của `npm` chưa nằm trong `PATH`.
+
+Xem prefix hiện tại:
+
+```bash
+npm prefix -g
+```
+
+Thêm dòng này vào shell config:
+
+```bash
+export PATH="$(npm prefix -g)/bin:$PATH"
+```
+
+Sau đó restart terminal hoặc chạy:
+
+```bash
+source ~/.zshrc
+```
+
+### `Keychain item not found`
+
+Account hiện tại chưa được Antigravity lưu vào Keychain item kỳ vọng.
+
+Chạy:
+
+```bash
+agy --prompt "hello"
+```
+
+Nếu bị yêu cầu login thì login thủ công. Sau đó lưu profile:
+
+```bash
+switch-acc-agy-save acc1
+```
+
+### `agy` vẫn dùng account cũ
+
+Đóng các session `agy` cũ và chạy process mới:
+
+```bash
+switch-acc-agy-to acc1
+agy --prompt "which account is active?"
+```
+
+Tool đã đổi credential local, nhưng process đang chạy có thể vẫn cache token
+cũ.
+
+### Browser vẫn mở sau khi switch
+
+Profile đã lưu có thể thiếu credential, hết hạn, hoặc đã bị revoke.
+
+Cách sửa: login thủ công lại account đó rồi ghi đè profile:
+
+```bash
+switch-acc-agy-save acc1
+```
+
+### `agy --prompt` không in output
+
+Kiểm tra log mới nhất của Antigravity CLI:
+
+```bash
+tail -120 ~/.gemini/antigravity-cli/cli.log
+```
+
+Silent auth thành công thường có các dòng:
+
+```text
+ChainedAuth: authenticated via keyring (effective: keyring)
+Print mode: silent auth succeeded
+```
+
+## Tóm Tắt Cơ Chế
+
+`save`:
+
+1. Đọc `~/.gemini/oauth_creds.json`.
+2. Đọc Keychain item `service=gemini`, `account=antigravity`.
+3. Lưu cả hai vào `~/.switch-agy/profiles/<profile>`.
+
+`to`:
+
+1. Backup credential live hiện tại.
+2. Copy `oauth_creds.json` đã lưu vào `~/.gemini/oauth_creds.json`.
+3. Thay Keychain item bằng secret đã lưu của profile.
+4. Cập nhật `~/.switch-agy/current_profile`.
+
+Sau đó `agy` sẽ silent auth qua Keychain và dùng account vừa restore.

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "switch-acc-agy",
+  "version": "0.1.0",
+  "description": "Local account switcher for Antigravity CLI auth on macOS",
+  "bin": {
+    "switch-acc-agy": "switch-acc-agy",
+    "switch-acc-agy-save": "switch-acc-agy",
+    "switch-acc-agy-to": "switch-acc-agy"
+  },
+  "files": [
+    "switch-acc-agy",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin"
+  ],
+  "keywords": [
+    "antigravity",
+    "auth",
+    "cli",
+    "gemini",
+    "switch"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/XuanMaiHieu/switch-acc-agy.git"
+  }
+}

package/switch-acc-agy

@@ -0,0 +1,236 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+APP_NAME="switch-acc-agy"
+STORE_DIR="${SWITCH_AGY_STORE:-$HOME/.switch-agy}"
+PROFILES_DIR="$STORE_DIR/profiles"
+BACKUPS_DIR="$STORE_DIR/backups"
+GEMINI_DIR="${GEMINI_DIR:-$HOME/.gemini}"
+OAUTH_CREDS="$GEMINI_DIR/oauth_creds.json"
+KEYCHAIN_SERVICE="${SWITCH_AGY_KEYCHAIN_SERVICE:-gemini}"
+KEYCHAIN_ACCOUNT="${SWITCH_AGY_KEYCHAIN_ACCOUNT:-antigravity}"
+
+usage() {
+  cat <<EOF
+Usage:
+  $APP_NAME save <profile>       Save current Antigravity/Gemini auth as profile
+  $APP_NAME to <profile>         Switch current auth to saved profile
+  $APP_NAME list                 List saved profiles
+  $APP_NAME current              Show active profile marker
+  $APP_NAME paths                Show credential paths used by this tool
+
+Aliases:
+  switch-acc-agy-save <profile>
+  switch-acc-agy-to <profile>
+EOF
+}
+
+die() {
+  printf 'Error: %s\n' "$*" >&2
+  exit 1
+}
+
+info() {
+  printf '%s\n' "$*"
+}
+
+validate_profile() {
+  local name="${1:-}"
+  [[ "$name" =~ ^[A-Za-z][A-Za-z0-9_-]{0,31}$ ]] || \
+    die "invalid profile name '$name'. Use letters, numbers, hyphen, underscore; start with a letter; max 32 chars."
+  printf '%s' "$name" | tr '[:upper:]' '[:lower:]'
+}
+
+ensure_store() {
+  mkdir -p "$PROFILES_DIR" "$BACKUPS_DIR" "$GEMINI_DIR"
+  chmod 700 "$STORE_DIR" "$PROFILES_DIR" "$BACKUPS_DIR" 2>/dev/null || true
+}
+
+profile_dir() {
+  local profile
+  profile="$(validate_profile "$1")"
+  printf '%s/%s' "$PROFILES_DIR" "$profile"
+}
+
+require_security() {
+  command -v security >/dev/null 2>&1 || die "macOS security command not found"
+}
+
+read_keychain_secret() {
+  require_security
+  security find-generic-password -a "$KEYCHAIN_ACCOUNT" -s "$KEYCHAIN_SERVICE" -w 2>/dev/null
+}
+
+write_keychain_secret() {
+  local secret_file="$1"
+  require_security
+  [[ -s "$secret_file" ]] || die "missing saved keychain secret: $secret_file"
+
+  # Command substitution intentionally removes the display newline that
+  # `security -w` appends; the keychain password itself is the credential blob.
+  local secret
+  secret="$(LC_ALL=C cat "$secret_file")"
+  security add-generic-password \
+    -U \
+    -a "$KEYCHAIN_ACCOUNT" \
+    -s "$KEYCHAIN_SERVICE" \
+    -w "$secret" >/dev/null
+}
+
+save_current_backup() {
+  local stamp backup_dir
+  stamp="$(date +%Y%m%d-%H%M%S)"
+  backup_dir="$BACKUPS_DIR/$stamp"
+  mkdir -p "$backup_dir"
+  chmod 700 "$backup_dir" 2>/dev/null || true
+
+  if [[ -f "$OAUTH_CREDS" ]]; then
+    cp "$OAUTH_CREDS" "$backup_dir/oauth_creds.json"
+    chmod 600 "$backup_dir/oauth_creds.json" 2>/dev/null || true
+  fi
+
+  if read_keychain_secret >"$backup_dir/keychain_secret" 2>/dev/null; then
+    chmod 600 "$backup_dir/keychain_secret" 2>/dev/null || true
+  else
+    rm -f "$backup_dir/keychain_secret"
+  fi
+
+  printf '%s' "$backup_dir"
+}
+
+save_profile() {
+  local profile dir
+  profile="$(validate_profile "$1")"
+  dir="$(profile_dir "$profile")"
+
+  [[ -f "$OAUTH_CREDS" ]] || die "OAuth file not found: $OAUTH_CREDS"
+  read_keychain_secret >/dev/null || die "Keychain item not found: service=$KEYCHAIN_SERVICE account=$KEYCHAIN_ACCOUNT"
+
+  ensure_store
+  mkdir -p "$dir"
+  chmod 700 "$dir" 2>/dev/null || true
+
+  cp "$OAUTH_CREDS" "$dir/oauth_creds.json"
+  chmod 600 "$dir/oauth_creds.json" 2>/dev/null || true
+
+  read_keychain_secret >"$dir/keychain_secret"
+  chmod 600 "$dir/keychain_secret" 2>/dev/null || true
+
+  {
+    printf '{\n'
+    printf '  "profile": "%s",\n' "$profile"
+    printf '  "savedAt": "%s",\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+    printf '  "oauthPath": "%s",\n' "$OAUTH_CREDS"
+    printf '  "keychainService": "%s",\n' "$KEYCHAIN_SERVICE"
+    printf '  "keychainAccount": "%s"\n' "$KEYCHAIN_ACCOUNT"
+    printf '}\n'
+  } >"$dir/metadata.json"
+  chmod 600 "$dir/metadata.json" 2>/dev/null || true
+
+  printf '%s\n' "$profile" >"$STORE_DIR/current_profile"
+  chmod 600 "$STORE_DIR/current_profile" 2>/dev/null || true
+  info "Saved profile '$profile'."
+}
+
+switch_profile() {
+  local profile dir backup_dir
+  profile="$(validate_profile "$1")"
+  dir="$(profile_dir "$profile")"
+
+  [[ -d "$dir" ]] || die "profile '$profile' not found"
+  [[ -f "$dir/oauth_creds.json" ]] || die "profile '$profile' missing oauth_creds.json"
+  [[ -f "$dir/keychain_secret" ]] || die "profile '$profile' missing keychain_secret"
+
+  ensure_store
+  backup_dir="$(save_current_backup)"
+
+  cp "$dir/oauth_creds.json" "$OAUTH_CREDS"
+  chmod 600 "$OAUTH_CREDS" 2>/dev/null || true
+  write_keychain_secret "$dir/keychain_secret"
+
+  printf '%s\n' "$profile" >"$STORE_DIR/current_profile"
+  chmod 600 "$STORE_DIR/current_profile" 2>/dev/null || true
+
+  info "Switched Antigravity auth to '$profile'."
+  info "Backup of previous auth: $backup_dir"
+  info "Run a new agy process for the switch to take effect."
+}
+
+list_profiles() {
+  ensure_store
+  local current=""
+  [[ -f "$STORE_DIR/current_profile" ]] && current="$(tr -d '\n' <"$STORE_DIR/current_profile")"
+
+  local found=0 dir name marker
+  for dir in "$PROFILES_DIR"/*; do
+    [[ -d "$dir" ]] || continue
+    found=1
+    name="$(basename "$dir")"
+    marker=""
+    [[ "$name" == "$current" ]] && marker=" *"
+    printf '%s%s\n' "$name" "$marker"
+  done
+  [[ "$found" -eq 1 ]] || info "No profiles saved."
+}
+
+show_current() {
+  if [[ -f "$STORE_DIR/current_profile" ]]; then
+    tr -d '\n' <"$STORE_DIR/current_profile"
+    printf '\n'
+  else
+    info "No active profile marker."
+  fi
+}
+
+show_paths() {
+  cat <<EOF
+store: $STORE_DIR
+profiles: $PROFILES_DIR
+backups: $BACKUPS_DIR
+oauth_creds: $OAUTH_CREDS
+keychain_service: $KEYCHAIN_SERVICE
+keychain_account: $KEYCHAIN_ACCOUNT
+EOF
+}
+
+cmd="${1:-}"
+alias_cmd=0
+case "$(basename "$0")" in
+  switch-acc-agy-save)
+    cmd="save"
+    alias_cmd=1
+    ;;
+  switch-acc-agy-to)
+    cmd="to"
+    alias_cmd=1
+    ;;
+esac
+
+case "$cmd" in
+  save)
+    [[ "$alias_cmd" -eq 1 ]] || shift || true
+    [[ $# -eq 1 ]] || { usage; exit 2; }
+    save_profile "$1"
+    ;;
+  to|switch)
+    [[ "$alias_cmd" -eq 1 ]] || shift || true
+    [[ $# -eq 1 ]] || { usage; exit 2; }
+    switch_profile "$1"
+    ;;
+  list|ls)
+    list_profiles
+    ;;
+  current)
+    show_current
+    ;;
+  paths)
+    show_paths
+    ;;
+  help|-h|--help|"")
+    usage
+    ;;
+  *)
+    usage
+    exit 2
+    ;;
+esac