opencode-account-manager 0.4.1 → 0.4.3

package/README.md

@@ -1,266 +1,232 @@
 # OpenCode Account Manager (OCAM)
 
-TUI Dashboard để quản lý tất cả providers, MCP servers, và plugin accounts của [OpenCode](https://opencode.ai).
+<div align="center">
+  <h3>TUI Dashboard for OpenCode Account Management</h3>
+  <p>Manage providers, MCP servers, and plugin accounts in one place.</p>
+  
+  <p>
+    <a href="https://www.npmjs.com/package/opencode-account-manager">
+      <img src="https://img.shields.io/npm/v/opencode-account-manager.svg" alt="npm version">
+    </a>
+    <a href="https://www.npmjs.com/package/opencode-account-manager">
+      <img src="https://img.shields.io/npm/dw/opencode-account-manager.svg" alt="npm downloads">
+    </a>
+    <a href="https://github.com/d-init-d/opencode-account-manager/blob/main/LICENSE">
+      <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License">
+    </a>
+  </p>
+
+  <p>
+    <strong>English</strong> | 
+    <a href="./README_VI.md">Tiếng Việt</a>
+  </p>
+</div>
 
-## Tính năng
+---
 
-### Dashboard
-- **Providers**: Xem tất cả AI providers (Google, Ollama, Claudible, Antigravity Manager) với số models
-- **MCP Servers**: Xem trạng thái enabled/disabled của các MCP servers
-- **Plugin Accounts**: Quản lý accounts của Antigravity Auth plugin
-  - Xem rate limit status theo từng model (claude, gemini)
-  - Enable/Disable accounts
-  - Xóa accounts
+## Features
 
-### Export/Import (v0.4.0)
-- **Encrypted Export (.ocam)**: Mã hóa AES-256-GCM với password
-- **Plain JSON Export**: Format không mã hóa (backward compatible)
-- **File Browser**: Chọn nhanh Desktop/Documents, duyệt folder, paste path
-- **Import Preview**: Xem accounts nào đã tồn tại trước khi import
-- **Overwrite Mode**: Accounts trùng sẽ được cập nhật khi import
+- **Providers View**: See all AI providers (Google, Ollama, Anthropic, etc.) with model counts
+- **MCP Servers**: View enabled/disabled status of MCP servers
+- **Plugin Accounts**: Manage Google accounts connected to OpenCode
+  - Rate limit status per model (claude, gemini)
+  - Enable/Disable/Delete accounts
+- **Encrypted Export**: AES-256-GCM encryption with password protection
+- **Multi-format Import**: Support for encrypted `.ocam`, plain JSON, and Antigravity Manager exports
 
 ---
 
-## Cài đặt
+## Installation
 
-### Cách 1: Clone từ GitHub (Recommended)
+### Option A: Let an LLM do it
 
-```bash
-# Clone repo
-git clone https://github.com/d-init-d/opencode-account-manager.git
-cd opencode-account-manager
+Paste this into any LLM agent (Claude Code, OpenCode, Cursor, etc.):
 
-# Cài dependencies
-npm install
+```
+Install opencode-account-manager globally via npm, then run "ocam" to verify installation.
+Repository: https://github.com/d-init-d/opencode-account-manager
+```
 
-# Build TypeScript
-npm run build
+### Option B: Install from npm
 
-# (Optional) Link để dùng command `ocam` ở mọi nơi
-npm link
+```bash
+npm install -g opencode-account-manager
 ```
 
-### Cách 2: Cài trực tiếp từ GitHub
+### Option C: Install from GitHub
 
 ```bash
 npm install -g github:d-init-d/opencode-account-manager
 ```
 
-### Kiểm tra cài đặt
+### Verify installation
 
 ```bash
-# Nếu đã npm link hoặc cài global
 ocam --version
-
-# Hoặc chạy trực tiếp
-node dist/cli.js --version
 ```
 
 ---
 
-## Sử dụng
+## For LLM Agents
+
+### Step-by-Step Instructions
 
-### Mở Dashboard (TUI)
+1. Run `npm install -g opencode-account-manager` to install globally
+2. Run `ocam` to start the TUI dashboard
+3. The dashboard will auto-detect OpenCode config at `~/.config/opencode/opencode.json`
+
+### Verification
 
 ```bash
-# Cách 1: Command ngắn (nếu đã npm link)
-ocam
+ocam --version
+# Expected output: 0.4.2
+```
 
-# Cách 2: Command đầy đủ
-opencode-account-manager
+---
 
-# Cách 3: Từ thư mục project
-npm run dashboard
+## Usage
 
-# Cách 4: Chạy trực tiếp
-node dist/cli.js dashboard
+### Start Dashboard
+
+```bash
+ocam
+# or
+opencode-account-manager
 ```
 
 ### CLI Commands
 
 ```bash
-# Xem danh sách accounts
+# List accounts
 ocam list
 
-# Export accounts ra file JSON
+# Export accounts
 ocam export -o backup.json
 
-# Import accounts từ file
+# Import accounts
 ocam import backup.json
 
-# Import từ Antigravity Manager folder
+# Import from Antigravity Manager folder
 ocam import-am
 
-# Xem help
+# Help
 ocam --help
 ```
 
 ---
 
-## Phím tắt trong Dashboard
+## Keyboard Shortcuts
 
 ### Main Dashboard
 
-| Phím | Chức năng |
-|------|-----------|
-| `Tab` | Chuyển section (Providers → Accounts → MCP) |
-| `R` | Refresh dữ liệu |
-| `E` | Export accounts (mở menu chọn format) |
-| `I` | Import accounts (mở file browser) |
-| `A` | Import từ Antigravity Manager folder |
-| `S` | Bật Select Mode (trong section Accounts) |
-| `Q` | Thoát |
-
-### Select Mode (trong Accounts)
-
-| Phím | Chức năng |
-|------|-----------|
-| `↑/↓` | Di chuyển lên/xuống |
-| `Space` | Chọn/bỏ chọn account |
-| `A` | Chọn tất cả |
-| `N` | Bỏ chọn tất cả |
-| `E` | Enable các accounts đã chọn |
-| `D` | Disable các accounts đã chọn |
-| `X` | Export các accounts đã chọn |
-| `DEL` | Xóa các accounts đã chọn |
-| `S` / `Esc` | Thoát Select Mode |
-
-### Export Flow
-
-1. Bấm `E` để export
-2. Chọn format: `[1] Encrypted (.ocam)` hoặc `[2] Plain JSON`
-3. Chọn folder lưu file
-4. Nhập password (chỉ với encrypted)
-5. Done!
-
-### Import Flow
-
-1. Bấm `I` để import
-2. Duyệt và chọn file `.ocam` hoặc `.json`
-3. Nhập password (chỉ với file encrypted)
-4. Xem preview các accounts
-5. Bấm `Enter` để confirm import
+| Key | Action |
+|-----|--------|
+| `Tab` | Switch section (Providers → Accounts → MCP) |
+| `R` | Refresh data |
+| `E` | Export accounts |
+| `I` | Import accounts |
+| `A` | Import from Antigravity Manager |
+| `S` | Enter Select Mode |
+| `Q` | Quit |
+
+### Select Mode (Accounts)
+
+| Key | Action |
+|-----|--------|
+| `↑/↓` | Navigate |
+| `Space` | Toggle selection |
+| `A` | Select all |
+| `N` | Deselect all |
+| `E` | Enable selected |
+| `D` | Disable selected |
+| `X` | Export selected |
+| `DEL` | Delete selected |
+| `Esc` | Exit Select Mode |
 
 ---
 
-## File Formats
+## Supported Import Formats
 
-### Encrypted (.ocam)
-- Mã hóa AES-256-GCM với scrypt key derivation
-- Cần password để mở
-- Khuyến nghị dùng khi backup hoặc share
-
-### Plain JSON (.json)
-- Human-readable, không mã hóa
-- Chứa refresh tokens dạng clear text
-- Chỉ nên dùng cho local backup
+| Format | Extension | Description |
+|--------|-----------|-------------|
+| Encrypted | `.ocam` | AES-256-GCM encrypted, password required |
+| Portable | `.json` | OpenCode Account Manager plain export |
+| AM Export | `.json` | Antigravity Manager app export `[{email, refresh_token}]` |
+| Plugin Native | `.json` | `antigravity-accounts.json` format |
 
 ---
 
-## Các file cấu hình
-
-| File | Vị trí | Mô tả |
-|------|--------|-------|
-| `opencode.json` | `~/.config/opencode/` | Config chính của OpenCode (providers, MCP) |
-| `antigravity-accounts.json` | `%APPDATA%/opencode/` | Accounts của plugin (Windows) |
-| `antigravity-accounts.json` | `~/.config/opencode/` | Accounts của plugin (Linux/Mac) |
-| `ocam-config.json` | `%APPDATA%/opencode/` | Preferences của app (recent folders) |
+## Configuration Paths
 
----
+| File | Windows | Linux/Mac |
+|------|---------|-----------|
+| OpenCode config | `~/.config/opencode/opencode.json` | `~/.config/opencode/opencode.json` |
+| Plugin accounts | `%APPDATA%/opencode/antigravity-accounts.json` | `~/.config/opencode/antigravity-accounts.json` |
+| OCAM preferences | `%APPDATA%/opencode/ocam-config.json` | `~/.config/opencode/ocam-config.json` |
 
-## Yêu cầu hệ thống
-
-- **Node.js**: >= 16.x
-- **OpenCode**: Cần cài sẵn OpenCode với Antigravity Auth plugin
-- **Terminal**: Hỗ trợ Unicode và 256 colors (Windows Terminal, iTerm2, etc.)
+> **Note**: `~` on Windows resolves to your user home directory (e.g., `C:\Users\YourName`)
 
 ---
 
-## Screenshots
+## Requirements
 
-```
-* OpenCode Account Manager - Dashboard
-────────────────────────────────────────────────────────────────
-Providers  Models  MCP On  MCP Off  Accounts  Available  Limited
-    4        29       6        0        5          3         2
-
-Sections: [1] Providers  [2] Accounts  [3] MCP  (Tab to switch)
-
-╭─ PROVIDERS ──────────────────────────────────────────────────╮
-│ PROVIDER            MODELS  TYPE      BASE URL              │
-│ Google              7       builtin   -                     │
-│ Ollama              5       custom    http://localhost:11434│
-│ Claudible           3       custom    https://claudible.io  │
-│ Antigravity Manager 14      custom    http://localhost:8045 │
-╰──────────────────────────────────────────────────────────────╯
-
-╭─ PLUGIN ACCOUNTS (opencode-antigravity-auth) ────────────────╮
-│ EMAIL                         STATUS     RATE LIMIT          │
-│ user1@gmail.com               enabled    claude: 2.1h        │
-│ user2@gmail.com               enabled    OK                  │
-│ user3@gmail.com               disabled   -                   │
-╰──────────────────────────────────────────────────────────────╯
-
-╭─ MCP SERVERS ────────────────────────────────────────────────╮
-│ SERVER              STATUS     ENV   COMMAND                 │
-│ playwright          enabled    0     npx @playwright/mcp     │
-│ firecrawl           enabled    1     npx firecrawl-mcp       │
-│ github              enabled    1     npx @modelcontextprot...│
-╰──────────────────────────────────────────────────────────────╯
-
-┌──────────────────────────────────────────────────────────────┐
-│ [R] Refresh  [E] Export  [I] Import  [A] AM Import  [S] Select Mode  [Q] Quit │
-└──────────────────────────────────────────────────────────────┘
-```
+- **Node.js**: >= 16.x
+- **OpenCode**: Installed and configured
+- **Terminal**: Unicode and 256 colors support (Windows Terminal, iTerm2, etc.)
 
 ---
 
 ## Troubleshooting
 
-### Lỗi "command not found: ocam"
+### "command not found: ocam"
 
 ```bash
-# Nếu chưa npm link, chạy:
-cd /path/to/opencode-account-manager
-npm link
-
-# Hoặc chạy trực tiếp:
-node /path/to/opencode-account-manager/dist/cli.js
+npm install -g opencode-account-manager
 ```
 
-### Lỗi "Cannot find module"
+### "Plugin accounts file not found"
+
+Login at least one account first:
 
 ```bash
-# Rebuild project
-npm run build
+opencode auth login
 ```
 
-### Lỗi "Plugin accounts file not found"
+### "Cannot find module"
+
+Reinstall the package:
 
-Cần đăng nhập ít nhất 1 account trong OpenCode trước:
 ```bash
-opencode auth login
+npm uninstall -g opencode-account-manager
+npm install -g opencode-account-manager
 ```
 
 ---
 
 ## Documentation
 
-- [ROADMAP.md](./docs/ROADMAP.md) - Lịch sử phiên bản và kế hoạch
-- [BLUEPRINT.md](./docs/BLUEPRINT.md) - Kiến trúc kỹ thuật
+- [ROADMAP.md](./docs/ROADMAP.md) - Version history and plans
+- [BLUEPRINT.md](./docs/BLUEPRINT.md) - Technical architecture
 
 ---
 
 ## Contributing
 
-1. Fork repo
-2. Tạo branch: `git checkout -b feature/ten-tinh-nang`
-3. Commit: `git commit -m "feat: mô tả"`
-4. Push: `git push origin feature/ten-tinh-nang`
-5. Tạo Pull Request
+1. Fork the repo
+2. Create branch: `git checkout -b feature/your-feature`
+3. Commit: `git commit -m "feat: description"`
+4. Push: `git push origin feature/your-feature`
+5. Create Pull Request
 
 ---
 
 ## License
 
-MIT
+MIT License. See [LICENSE](./LICENSE) for details.
+
+---
+
+## Credits
+
+- [OpenCode](https://opencode.ai) - The AI coding assistant this tool is built for
+- [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth) - Optional plugin for Google OAuth authentication

package/README_VI.md

@@ -0,0 +1,232 @@
+# OpenCode Account Manager (OCAM)
+
+<div align="center">
+  <h3>TUI Dashboard quản lý tài khoản OpenCode</h3>
+  <p>Quản lý providers, MCP servers, và plugin accounts trong một giao diện.</p>
+  
+  <p>
+    <a href="https://www.npmjs.com/package/opencode-account-manager">
+      <img src="https://img.shields.io/npm/v/opencode-account-manager.svg" alt="npm version">
+    </a>
+    <a href="https://www.npmjs.com/package/opencode-account-manager">
+      <img src="https://img.shields.io/npm/dw/opencode-account-manager.svg" alt="npm downloads">
+    </a>
+    <a href="https://github.com/d-init-d/opencode-account-manager/blob/main/LICENSE">
+      <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License">
+    </a>
+  </p>
+
+  <p>
+    <a href="./README.md">English</a> | 
+    <strong>Tiếng Việt</strong>
+  </p>
+</div>
+
+---
+
+## Tính năng
+
+- **Xem Providers**: Hiển thị tất cả AI providers (Google, Ollama, Anthropic, etc.) với số lượng models
+- **MCP Servers**: Xem trạng thái bật/tắt của các MCP servers
+- **Quản lý Accounts**: Quản lý các tài khoản Google đang kết nối với OpenCode
+  - Trạng thái rate limit theo từng model (claude, gemini)
+  - Bật/Tắt/Xóa accounts
+- **Export mã hóa**: Mã hóa AES-256-GCM với mật khẩu bảo vệ
+- **Import đa định dạng**: Hỗ trợ file `.ocam` mã hóa, JSON thuần, và file export từ Antigravity Manager
+
+---
+
+## Cài đặt
+
+### Cách A: Nhờ AI cài giúp
+
+Paste đoạn này vào bất kỳ AI agent nào (Claude Code, OpenCode, Cursor, etc.):
+
+```
+Cài đặt opencode-account-manager từ npm, sau đó chạy "ocam" để kiểm tra.
+Repository: https://github.com/d-init-d/opencode-account-manager
+```
+
+### Cách B: Cài từ npm
+
+```bash
+npm install -g opencode-account-manager
+```
+
+### Cách C: Cài từ GitHub
+
+```bash
+npm install -g github:d-init-d/opencode-account-manager
+```
+
+### Kiểm tra cài đặt
+
+```bash
+ocam --version
+```
+
+---
+
+## Dành cho AI Agents
+
+### Hướng dẫn từng bước
+
+1. Chạy `npm install -g opencode-account-manager` để cài global
+2. Chạy `ocam` để mở TUI dashboard
+3. Dashboard sẽ tự động đọc config OpenCode tại `~/.config/opencode/opencode.json`
+
+### Xác minh
+
+```bash
+ocam --version
+# Kết quả mong đợi: 0.4.2
+```
+
+---
+
+## Sử dụng
+
+### Mở Dashboard
+
+```bash
+ocam
+# hoặc
+opencode-account-manager
+```
+
+### Các lệnh CLI
+
+```bash
+# Liệt kê accounts
+ocam list
+
+# Export accounts
+ocam export -o backup.json
+
+# Import accounts
+ocam import backup.json
+
+# Import từ thư mục Antigravity Manager
+ocam import-am
+
+# Trợ giúp
+ocam --help
+```
+
+---
+
+## Phím tắt
+
+### Dashboard chính
+
+| Phím | Chức năng |
+|------|-----------|
+| `Tab` | Chuyển section (Providers → Accounts → MCP) |
+| `R` | Làm mới dữ liệu |
+| `E` | Export accounts |
+| `I` | Import accounts |
+| `A` | Import từ Antigravity Manager |
+| `S` | Vào chế độ chọn |
+| `Q` | Thoát |
+
+### Chế độ chọn (Accounts)
+
+| Phím | Chức năng |
+|------|-----------|
+| `↑/↓` | Di chuyển |
+| `Space` | Chọn/bỏ chọn |
+| `A` | Chọn tất cả |
+| `N` | Bỏ chọn tất cả |
+| `E` | Bật các account đã chọn |
+| `D` | Tắt các account đã chọn |
+| `X` | Export các account đã chọn |
+| `DEL` | Xóa các account đã chọn |
+| `Esc` | Thoát chế độ chọn |
+
+---
+
+## Định dạng Import được hỗ trợ
+
+| Định dạng | Đuôi file | Mô tả |
+|-----------|-----------|-------|
+| Mã hóa | `.ocam` | Mã hóa AES-256-GCM, cần mật khẩu |
+| Portable | `.json` | Export thuần từ OpenCode Account Manager |
+| AM Export | `.json` | Export từ app Antigravity Manager `[{email, refresh_token}]` |
+| Plugin Native | `.json` | Định dạng `antigravity-accounts.json` |
+
+---
+
+## Đường dẫn cấu hình
+
+| File | Windows | Linux/Mac |
+|------|---------|-----------|
+| Config OpenCode | `~/.config/opencode/opencode.json` | `~/.config/opencode/opencode.json` |
+| Plugin accounts | `%APPDATA%/opencode/antigravity-accounts.json` | `~/.config/opencode/antigravity-accounts.json` |
+| Cài đặt OCAM | `%APPDATA%/opencode/ocam-config.json` | `~/.config/opencode/ocam-config.json` |
+
+> **Lưu ý**: `~` trên Windows là thư mục home của user (ví dụ: `C:\Users\TenBan`)
+
+---
+
+## Yêu cầu hệ thống
+
+- **Node.js**: >= 16.x
+- **OpenCode**: Đã cài đặt và cấu hình
+- **Terminal**: Hỗ trợ Unicode và 256 màu (Windows Terminal, iTerm2, etc.)
+
+---
+
+## Xử lý lỗi
+
+### "command not found: ocam"
+
+```bash
+npm install -g opencode-account-manager
+```
+
+### "Plugin accounts file not found"
+
+Đăng nhập ít nhất một tài khoản trước:
+
+```bash
+opencode auth login
+```
+
+### "Cannot find module"
+
+Cài lại package:
+
+```bash
+npm uninstall -g opencode-account-manager
+npm install -g opencode-account-manager
+```
+
+---
+
+## Tài liệu
+
+- [ROADMAP.md](./docs/ROADMAP.md) - Lịch sử phiên bản và kế hoạch
+- [BLUEPRINT.md](./docs/BLUEPRINT.md) - Kiến trúc kỹ thuật
+
+---
+
+## Đóng góp
+
+1. Fork repo
+2. Tạo branch: `git checkout -b feature/ten-tinh-nang`
+3. Commit: `git commit -m "feat: mo-ta"`
+4. Push: `git push origin feature/ten-tinh-nang`
+5. Tạo Pull Request
+
+---
+
+## Giấy phép
+
+MIT License. Xem [LICENSE](./LICENSE) để biết chi tiết.
+
+---
+
+## Credits
+
+- [OpenCode](https://opencode.ai) - AI coding assistant mà công cụ này được xây dựng cho
+- [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth) - Plugin tùy chọn để xác thực Google OAuth

package/dist/cli.js

@@ -35,7 +35,7 @@ const program = new commander_1.Command();
 program
     .name("ocam")
     .description("OpenCode Account Manager - TUI dashboard and CLI for managing accounts")
-    .version("0.4.0");
+    .version("0.4.3");
 // Default command - show dashboard
 program
     .command("dashboard", { isDefault: true })

package/dist/core/importers/amExport.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Import accounts from Antigravity Manager EXPORTED files
+ *
+ * AM Export Format (from app export button):
+ * [
+ *   { "email": "xxx@gmail.com", "refresh_token": "1//..." },
+ *   ...
+ * ]
+ *
+ * This is different from AM folder structure (accounts.json + accounts/*.json)
+ */
+import { Account } from "../types";
+/**
+ * Single entry in AM export file
+ */
+export interface AMExportEntry {
+    email: string;
+    refresh_token: string;
+}
+/**
+ * Type guard to check if data is an AM export file (array of entries)
+ */
+export declare function isAMExportFile(data: unknown): data is AMExportEntry[];
+export interface ImportFromAMExportResult {
+    accounts: Account[];
+    skipped: string[];
+    errors: string[];
+    source: "am-export";
+}
+/**
+ * Import accounts from AM export file content
+ */
+export declare function importFromAMExportContent(entries: AMExportEntry[]): ImportFromAMExportResult;
+/**
+ * Import accounts from AM export file path
+ */
+export declare function importFromAMExportFile(filePath: string): ImportFromAMExportResult;
+/**
+ * Check if a file is an AM export file (by reading and checking format)
+ */
+export declare function isAMExportFilePath(filePath: string): boolean;
+//# sourceMappingURL=amExport.d.ts.map

package/dist/core/importers/amExport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amExport.d.ts","sourceRoot":"","sources":["../../../src/core/importers/amExport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,aAAa,EAAE,CAYrE;AA0CD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,wBAAwB,CAmC5F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB,CA+BjF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAU5D"}