galaxy-code 0.1.5 → 0.1.7

package/README.md

@@ -1,679 +1,228 @@
-# 🌌 Galaxy CLI
+# 🌌 Galaxy Code
 
-**AI Pair Programming Tool** - Công cụ lập trình với AI trợ lý thông minh, hỗ trợ phân tích, lập kế hoạch và tạo code tự động.
+**AI-Powered Coding Assistant** - An intelligent CLI tool that helps you build, analyze, and enhance your software projects with AI.
 
----
+[![npm version](https://img.shields.io/npm/v/galaxy-code.svg)](https://www.npmjs.com/package/galaxy-code)
+[![License](https://img.shields.io/npm/l/galaxy-code.svg)](https://github.com/buikevin/galaxy-code/blob/main/LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-available-brightgreen)](https://galaxy-code-cli.vercel.app)
 
-## ⚠️ Trạng thái Alpha
+## 🚀 Quick Start
 
-> **Dự án đang trong giai đoạn phát triển Alpha**
->
-> Galaxy CLI hiện đang trong giai đoạn phát triển và thử nghiệm Alpha. Phiên bản chính thức (stable release) sẽ được công bố trong tương lai khi dự án đã hoàn thiện và được kiểm thử kỹ lưỡng.
->
-> **Lưu ý:**
-> - ⚠️ Dự án chưa được public trên GitHub hay các kho package registry
-> - 🔄 API và cấu trúc có thể thay đổi trong quá trình phát triển
-> - ⛔ Không khuyến nghị sử dụng cho môi trường production hiện tại
->
-> **Để cập nhật thông tin về phiên bản chính thức:**
-> - 📧 Email: kevinbui210191@gmail.com / hieubt2@msb.com.vn
-> - 📱 Theo dõi repository để nhận thông báo khi project được public
+Install Galaxy Code globally:
 
----
-
-## 📋 Mục lục
-
-- [Giới thiệu](#giới-thiệu)
-- [Công nghệ sử dụng](#công-nghệ-sử-dụng)
-- [Kiến trúc hệ thống](#kiến-trúc-hệ-thống)
-- [Luồng hoạt động](#luồng-hoạt-động)
-- [Cài đặt](#cài-đặt)
-- [Sử dụng](#sử-dụng)
-- [AI Models & Vai trò](#ai-models--vai-trò)
-- [Danh sách Tools](#danh-sách-tools)
-
----
-
-## 🎯 Giới thiệu
-
-**Galaxy CLI** là công cụ AI pair programming mạnh mẽ được xây dựng với:
-
-- **Giao diện CLI hiện đại** sử dụng Ink (React for CLI)
-- **Multi-AI orchestration** với Gemini 2.5 Flash làm trung tâm điều phối
-- **27+ công cụ chuyên biệt** cho file operations, git, testing, document parsing
-- **Intelligent planning** với qwen3-coder:480b-cloud
-- **Business Analysis** với gpt-oss:120b-cloud
-
-## 🛠 Công nghệ sử dụng
-
-### Frontend CLI
-
-- **Ink** - React cho terminal, render component như web app
-- **ink-spinner** - Loading animations (dots, arc, etc.)
-- **figlet** - ASCII art banner
-- **TypeScript** - Type safety
-
-### AI & LLM Stack
-
-- **Google Gemini 2.5 Flash** - Orchestrator chính, tool calling
-- **Ollama Models**:
-  - `gpt-oss:120b-cloud` - Business Analysis & Requirements
-  - `qwen3-coder:480b-cloud` - Code generation & Planning
-
-### Tools & Utilities
-
-- **Bun** - Fast runtime và package manager
-- **PDF/DOCX/XLSX parsers** - Document analysis
-- **Node.js child_process** - Command execution
-- **Git CLI integration** - Version control
-
----
-
-## 🏗 Kiến trúc hệ thống
-
-```
-┌─────────────────────────────────────────────┐
-│         Galaxy CLI (Ink React App)          │
-│  - User Input với autocomplete              │
-│  - Spinner loading states                   │
-│  - Figlet banner                            │
-└─────────────────┬───────────────────────────┘
-                  │
-                  ▼
-┌─────────────────────────────────────────────┐
-│      Gemini 2.5 Flash (Orchestrator)        │
-│  - Tool calling & function execution        │
-│  - Plan execution & todos display           │
-│  - Multi-language support (EN/VI)           │
-└─────────────────┬───────────────────────────┘
-                  │
-        ┌─────────┴─────────────┐
-        │                       │
-        ▼                       ▼
-┌───────────────┐       ┌──────────────────┐
-│  BA Analyzer  │       │ Planning Agent   │
-│ gpt-oss:120b  │       │ qwen3-coder:480b │
-│               │       │ Feature-driven   │
-└───────────────┘       └──────────────────┘
-        │                       │
-        │                       ▼
-        │               ┌──────────────────────┐
-        │               │ Execution Plan       │
-        │               │ - Feature steps      │
-        │               │ - Tool selection     │
-        │               └──────────────────────┘
-        │                       │
-        └───────────┬───────────┘
-                    ▼
-        ┌───────────────────────────┐
-        │   Code Generate Agent     │
-        │   qwen3-coder:480b-cloud  │
-        │                           │
-        │ ┌─────────────────────┐   │
-        │ │ Integrated Tools:   │   │
-        │ │ - file_write        │   │
-        │ │ - file_read         │   │
-        │ │ - command_run       │   │
-        │ │ - file_search       │   │
-        │ └─────────────────────┘   │
-        │                           │
-        │ Output: {step, status,    │
-        │  message, filesCreated}   │
-        └───────────────────────────┘
-                    │
-                    ▼
-        ┌───────────────────────────┐
-        │  Tool Registry (28 tools) │
-        │                           │
-        │  📁 File   🔧 Command     │
-        │  🔀 Git    📝 Document    │
-        │  🧪 Test   🔍 Search      │
-        └───────────────────────────┘
+```bash
+npm install -g galaxy-code
 ```
 
-### Design Pattern: **Orchestrator + Tools**
-
-**Trước đây** (Multi-agent):
-
-- 11 agents riêng biệt
-- Phức tạp, khó maintain
-- Nhiều context switching
-
-**Hiện tại** (Feature-Driven):
+Or run directly with npx:
 
-- 1 Orchestrator (Gemini) - Điều phối & todos display
-- 3 Specialized agents:
-  - BA Analyzer (gpt-oss) - Requirements analysis
-  - Planning Agent (qwen3-coder) - Feature-based planning
-  - Code Generate Agent (qwen3-coder) - Self-contained executor
-- 28 focused tools
-- Feature-driven execution (1 feature = 1 step)
-
----
-
-## 🔄 Luồng hoạt động
-
-### 1️⃣ **Analyze Existing Project**
-
-```
-User: "Phân tích dự án này"
-  │
-  ├─> file_tree(cwd) → Lấy cấu trúc thư mục
-  ├─> file_read(package.json, README) → Đọc tech stack
-  └─> Trả về phân tích toàn diện
+```bash
+npx galaxy-code
 ```
 
-**Output**: Project description, tech stack, features, architecture
-
----
+## 📚 Documentation
 
-### 2️⃣ **Create New Project**
+Comprehensive documentation is available at: [https://galaxy-code-cli.vercel.app](https://galaxy-code-cli.vercel.app)
 
-```
-User: "Tạo app Next.js e-commerce"
-  │
-  ├─> 🔍 ba_it_analyze(userRequest, context)
-  │     ↓
-  │   ┌─────────────────────────────────────┐
-  │   │ BA Analysis Result (English)        │
-  │   │ - projectName                       │
-  │   │ - type: "create_project"            │
-  │   │ - coreFeatures: [...]               │
-  │   │ - technicalStack: {...}             │
-  │   │ - estimatedDevelopmentTime          │
-  │   │ - recommendations: [...]            │
-  │   │ - questionsForUser: [...]           │
-  │   └─────────────────────────────────────┘
-  │     ↓
-  ├─> 📊 PRESENT to User (Vietnamese/English)
-  │
-  │   📊 **Phân tích dự án**: Next.js E-commerce
-  │   💡 **Mô tả**: Ứng dụng thương mại điện tử...
-  │
-  │   **✨ Tính năng chính**:
-  │   - Catalog sản phẩm
-  │   - Giỏ hàng
-  │   - Thanh toán (Stripe)
-  │   ...
-  │
-  │   Bạn đồng ý phương án này?
-  │
-  │     ↓
-  ├─> ⏸️  WAIT for user confirmation
-  │     ↓
-  ├─> ✅ User: "Đồng ý, làm đi"
-  │     ↓
-  ├─> 📋 plan_task(userContext, baAnalysis)
-  │     ↓
-  │   ┌─────────────────────────────────────────────┐
-  │   │ Feature-Driven Plan                         │
-  │   │ {                                           │
-  │   │   summary: "Build e-commerce with 3 features",│
-  │   │   steps: [                                  │
-  │   │     {step: 1, tool: "command_run",          │
-  │   │      action: "Init Next.js"},               │
-  │   │     {step: 2, tool: "install_dependencies"},│
-  │   │     {step: 3, tool: "code_generate",        │
-  │   │      featureName: "Product Catalog",        │
-  │   │      featureDescription: "...",             │
-  │   │      priority: "must-have"},                │
-  │   │     {step: 4, tool: "code_generate",        │
-  │   │      featureName: "Shopping Cart"},         │
-  │   │     {step: 5, tool: "code_generate",        │
-  │   │      featureName: "Checkout"}               │
-  │   │   ],                                        │
-  │   │   estimatedTime: "long"                     │
-  │   │ }                                           │
-  │   └─────────────────────────────────────────────┘
-  │     ↓
-  ├─> 📋 **Present Plan with Todos**:
-  │
-  │     📋 Implementation Plan (long):
-  │     ☐ Step 1: Initialize Next.js project
-  │     ☐ Step 2: Install dependencies
-  │     ☐ Step 3: Implement Product Catalog
-  │     ☐ Step 4: Implement Shopping Cart
-  │     ☐ Step 5: Implement Checkout
-  │
-  │     ↓
-  └─> 🚀 **Execute Steps Sequentially**:
-
-      Step 1: command_run("npm create next-app...")
-      ☒ Step 1: Initialize Next.js - Completed
-
-      Step 2: install_dependencies()
-      ☒ Step 2: Install dependencies - Installed
-
-      Step 3: code_generate({
-        step: 3,
-        featureName: "Product Catalog",
-        technicalStack: {...},
-        userStories: [...],
-        dataModel: [...]
-      })
-      ↓ Code Generate Agent:
-        - Generates complete code
-        - Writes files: components/, api/, types/
-        - Returns: {step: 3, status: 'done', filesCreated: [...]}
-      ☒ Step 3: Product Catalog - Created 5 files
-
-      Step 4: code_generate(Shopping Cart)
-      ☒ Step 4: Shopping Cart - Created 3 files
-
-      Step 5: code_generate(Checkout)
-      ☒ Step 5: Checkout - Created 4 files
-
-      ✅ All steps completed! Created 12 files total.
-```
+## 🎯 What is Galaxy Code?
 
----
+Galaxy Code is an AI-powered coding assistant that helps developers:
 
-### 3️⃣ **Add Feature to Existing Project**
+- **Create new projects** from scratch with AI planning
+- **Analyze existing projects** to understand codebase structure
+- **Add features** to existing applications intelligently
+- **Generate production-ready code** with best practices
+- **Manage development workflow** with integrated tools
 
-```
-User: "Thêm authentication vào app"
-  │
-  ├─> 🔍 ba_it_analyze(userRequest, context)
-  │     │ type: "update_project"
-  │     ↓
-  ├─> 📊 Present analysis
-  │     ↓
-  ├─> 📋 plan_task(userContext, baAnalysis)
-  │     │ → Skip project setup
-  │     │ → Focus on feature implementation
-  │     ↓
-  └─> 🚀 Execute steps
-```
+Powered by advanced AI models and a comprehensive toolset, Galaxy Code acts as your AI pair programmer.
 
----
+## 🛠 AI Model Support
 
-### 4️⃣ **Simple Questions**
+Galaxy Code supports multiple AI providers:
 
-```
-User: "React hooks là gì?"
-  │
-  └─> 💬 Direct answer (no tools)
-```
+### Claude (Anthropic)
+- **Models**: Claude 3.5 Sonnet, Claude 3.5 Haiku, Claude Opus
+- **Features**: Full tool use support, streaming responses
+- **API Key**: `ANTHROPIC_API_KEY` environment variable
 
----
+### Gemini (Google)
+- **Models**: Gemini 2.5 Flash and other Gemini models
+- **Features**: Tool calling, planning capabilities
+- **API Key**: `GOOGLE_AI_API_KEY` or `GEMINI_API_KEY` environment variable
 
-## 📦 Cài đặt
+### Ollama (Local)
+- **Models**: Any model hosted locally via Ollama
+- **Features**: Privacy-focused, offline development
+- **Setup**: Install Ollama and pull required models
 
-### Yêu cầu hệ thống
+## 🚀 Usage
 
-- **Bun** >= 1.0
-- **Ollama** với models:
-  - `gpt-oss:120b-cloud`
-  - `qwen3-coder:480b-cloud`
-- **Google Gemini API Key**
+### Running Galaxy Code
 
-### Bước 1: Clone & Install
+After installation, simply run:
 
 ```bash
-cd terminal/galaxy_cli
-bun install
+galaxy-code
 ```
 
-### Bước 2: Setup Environment
+Or with npx (no installation required):
 
 ```bash
-# .env file
-GEMINI_API_KEY=your_gemini_api_key_here
-OLLAMA_HOST=http://localhost:11434
-```
+npx galaxy-code
+```
+
+### CLI Options (Startup Flags)
+
+| Flag             | Description                          | Default     |
+| ---------------- | ------------------------------------ | ----------- |
+| `--help`         | Show help information                | -           |
+| `--version`      | Display version                      | -           |
+| `--git`          | Enable git operations                | From config |
+| `--test`         | Enable test planning                 | From config |
+| `--config`       | Display current configuration        | false       |
+| `--reset-config` | Reset configuration to defaults      | false       |
+| `--dev`          | Enable development mode with DevTools| false       |
+| `--no-auto-update`| Disable auto-update on startup      | false       |
+
+### In-App Commands
+
+While running Galaxy Code, you can use these commands:
+
+| Command              | Description                                    |
+| -------------------- | ---------------------------------------------- |
+| `/help`              | Show available commands                        |
+| `/exit`              | Exit the application                           |
+| `/clear`             | Clear conversation history                     |
+| `/history`           | Show recent inputs (last 10)                   |
+| `/pwd`               | Show current working directory                 |
+| `/information`       | Display system information                     |
+| `/git true/false`    | Enable/disable git operations                  |
+| `/test true/false`   | Enable/disable test planning                   |
+| `/mode claude/gemini/ollama/manual` | Switch agent mode       |
+| `/config`            | Open configuration folder                      |
 
-### Bước 3: Build
+### Example Usage
 
 ```bash
-bun run build
-```
+# Start with default settings
+$ galaxy-code
 
-### Bước 4: Run
-
-```bash
-bun run start
-# hoặc
-bun run dev
-```
+# Enable test planning from startup
+$ galaxy-code --test
 
----
+# Display current configuration
+$ galaxy-code --config
 
-## 🚀 Sử dụng
+# Reset configuration to defaults
+$ galaxy-code --reset-config
 
-### Chạy CLI
+# Enable development mode
+$ galaxy-code --dev
 
-```bash
-# Development mode với watch
-bun run dev
-
-# Production mode
-bun run start
-
-# Với CLI flags
-bun run start --test          # Enable test planning
-bun run start --review        # Enable review planning
-bun run start --test --review # Enable both
-bun run start --help          # Show help
-bun run start --version       # Show version
+# Disable auto-update
+$ galaxy-code --no-auto-update
 ```
 
-### CLI Flags
-
-| Flag        | Short | Default | Mô tả                       |
-| ----------- | ----- | ------- | --------------------------- |
-| `--help`    | `-h`  | -       | Hiển thị trợ giúp           |
-| `--version` | `-v`  | -       | Hiển thị version            |
-| `--test`    | -     | `false` | Enable test planning step   |
-| `--review`  | -     | `false` | Enable review planning step |
-
-### Commands (Trong CLI)
-
-| Command        | Mô tả                       | Example                             |
-| -------------- | --------------------------- | ----------------------------------- |
-| `/help`        | Hiển thị danh sách lệnh     | `/help`                             |
-| `/exit`        | Thoát khỏi Galaxy CLI       | `/exit`                             |
-| `/clear`       | Xóa lịch sử hội thoại       | `/clear`                            |
-| `/history`     | Xem 10 input gần nhất       | `/history`                          |
-| `/pwd`         | Hiển thị thư mục làm việc   | `/pwd`                              |
-| `/information` | Hiển thị thông tin hệ thống | `/information`                      |
-| `/test`        | Toggle test planning        | `/test true` hoặc `/test false`     |
-| `/review`      | Toggle review planning      | `/review true` hoặc `/review false` |
-
-### Example Usage
+### In-App Command Examples
 
 ```bash
-# Phân tích dự án hiện tại
-> Phân tích dự án này
+# Analyze current project
+> Analyze this project
 
-# Tạo project mới
-> Tạo app Next.js với TypeScript và Tailwind
+# Create a new Next.js application
+> Create a Next.js e-commerce app with TypeScript
 
-# Thêm tính năng
-> Thêm authentication với JWT
+# Add authentication to existing project
+> Add JWT authentication to this app
 
-# Hỏi đáp
-> Giải thích về React Context API
+# Ask technical questions
+> What are React hooks?
 
-# Bật/tắt test planning
+# Enable test planning
 > /test true
-✅ Test planning enabled
-
-# Kiểm tra thông tin hệ thống
-> /information
-📊 System Information:
-Name: Galaxy CLI
-Version: 2.0.0
-Current Project: /home/user/my-project
-Testing: ON
-Review Code: OFF
-```
-
----
-
-## 🤖 AI Models & Vai trò
-
-### 1. **Gemini 2.5 Flash** (Orchestrator)
-
-- **Vai trò**: Central coordinator & plan executor
-- **Nhiệm vụ**:
-  - Tool calling & function execution
-  - Plan execution với todos display (☐/☒)
-  - Workflow decision making
-  - Multi-language response (EN/VI)
-  - User interaction & confirmation
-
-### 2. **gpt-oss:120b-cloud** (BA Analyzer)
 
-- **Vai trò**: Business Analysis expert
-- **Nhiệm vụ**:
-  - Phân tích yêu cầu người dùng
-  - Xác định features, tech stack, data model
-  - Phân loại: `create_project` vs `update_project`
-  - Đề xuất recommendations & questions
-  - Output: **English only** (internal consistency)
+# Switch to Claude agent
+> /mode claude
 
-### 3. **qwen3-coder:480b-cloud** (Planning Agent)
-
-- **Vai trò**: Feature-driven planner
-- **Nhiệm vụ**:
-  - Map coreFeatures → execution steps
-  - 1 must-have feature = 1 code_generate step
-  - **Conditional test/review steps** based on CLI flags
-  - Chọn tools phù hợp (command_run, install_dependencies, code_generate)
-  - Ước lượng thời gian (quick/medium/long)
-  - Input: userContext + baAnalysis + system context (test/review flags)
-  - Output: **English only** (step array với featureName, tool, reasoning)
-
-### 4. **qwen3-coder:480b-cloud** (Code Generate Agent) ✨ NEW
-
-- **Vai trò**: Self-contained feature executor
-- **Nhiệm vụ**:
-  - Nhận feature spec từ planning step
-  - Generate production-ready code (NO placeholders)
-  - Tự động write files, run commands
-  - Integrated tools: file_write, file_read, command_run, file_search
-  - Return: `{step, status: 'done'|'error', message, filesCreated}`
-- **Input**:
-  - step, featureName, featureDescription, priority
-  - technicalStack, userStories, dataModel, apiEndpoints
-- **Output**: Execution result với file list
-
----
-
-## 🔧 Danh sách Tools
-
-### 📁 File Operations (6 tools)
-
-- `file_read` - Đọc nội dung file
-- `file_write` - Ghi/tạo file mới
-- `file_list` - List files trong thư mục
-- `file_search` - Tìm kiếm pattern trong files
-- `file_tree` - Hiển thị cây thư mục
-- `file_delete` - Xóa file
-
-### 🔀 Git Operations (5 tools)
-
-- `git_status` - Check git status
-- `git_commit` - Commit changes
-- `git_push` - Push to remote
-- `git_pull` - Pull từ remote
-- `git_diff` - Xem git diff
-
-### 🔧 Command & Testing (3 tools)
-
-- `command_run` - Chạy shell command
-- `install_dependencies` - Auto-detect & install deps
-- `test_run` - Chạy tests
-
-### 📝 Document Parsing (1 tool)
-
-- `document_parse` - Parse PDF, DOCX, XLSX
-
-### 🧠 AI Analysis & Planning (3 tools)
-
-- `ba_it_analyze` - Business analysis với gpt-oss:120b
-- `plan_task` - Feature-driven planning với qwen3-coder:480b
-- `code_generate` - ✨ **Self-contained feature executor** với qwen3-coder:480b
-
-### 🏗 Project Setup (2 tools)
-
-- `project_ask_config` - Interactive project setup
-- `project_build_command` - Generate build commands
-
----
-
-## 📊 Decision Logic
-
-### Khi nào dùng `ba_it_analyze`?
-
-✅ **Dùng khi**:
-
-- Tạo dự án MỚI (bắt buộc)
-- Thêm tính năng LỚN (auth, payments, complex systems)
-- Yêu cầu CHUNG CHUNG ("build app", "e-commerce")
-
-❌ **Không dùng**:
-
-- Câu hỏi đơn giản
-- Phân tích dự án hiện tại (dùng `file_tree` + `file_read`)
-
-### Khi nào dùng `plan_task`?
-
-✅ **Dùng khi**:
+# Check system information
+> /information
 
-- Sau khi user xác nhận BA analysis
-- Cần implementation nhiều bước
-- Refactoring phức tạp
+# View command history
+> /history
 
-**Required params**:
+# Exit the application
+> /exit
+```
 
-- `userContext` (bắt buộc) - Yêu cầu của user
-- `baAnalysis` (optional) - Kết quả từ ba_it_analyze
+## 🏗 How It Works
 
-### Khi nào dùng `code_generate`?
+### 1. Project Analysis
 
-✅ **Dùng khi**:
+Galaxy Code can analyze existing projects to understand:
 
-- Orchestrator execute step từ plan
-- Step có tool = "code_generate"
-- Cần implement 1 feature hoàn chỉnh
+- Project structure and architecture
+- Technology stack in use
+- Key features and components
+- Potential improvement areas
 
-**Required params**:
+### 2. Feature-Driven Planning
 
-- `step` - Step number
-- `featureName` - Tên feature từ coreFeatures
-- `featureDescription` - Mô tả chi tiết
-- `technicalStack` - Tech stack từ BA
-- Optional: userStories, dataModel, apiEndpoints
+When creating or adding features, Galaxy Code follows a structured approach:
 
-**Output**: `{step, status: 'done'|'error', message, filesCreated: [...]}`
+1. **Business Analysis** - Understands requirements and constraints
+2. **Technical Planning** - Creates implementation steps
+3. **Execution** - Generates code and runs necessary commands
+4. **Verification** - Optionally runs tests and code reviews
 
----
+### 3. Integrated Tool Execution
 
-## 🎨 UI Components
+All file operations, git commands, and system calls are handled through integrated tools that:
 
-### Banner
+- Automatically create and modify files
+- Execute shell commands safely
+- Track progress and report results
+- Handle errors gracefully
 
-```
-   ____       _                    ____ _     ___
-  / ___| __ _| | __ ___  ___   _  / ___| |   |_ _|
- | |  _ / _` | |/ _` \ \/ / | | || |   | |    | |
- | |_| | (_| | | (_| |>  <| |_| || |___| |___ | |
-  \____|\__,_|_|\__,_/_/\_\\__, | \____|_____|___|
-                           |___/
-```
+## 📋 Prerequisites
 
-### Loading States
+Before using Galaxy Code, ensure you have:
 
-- Spinner với dots animation: `⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏`
-- Color: cyan
-- Text: "Thinking..."
+1. **Node.js** >= 18.14.1
+2. **AI Provider API Keys** (at least one):
+   - **Anthropic Claude**: `ANTHROPIC_API_KEY` for Claude models
+   - **Google Gemini**: `GOOGLE_AI_API_KEY` or `GEMINI_API_KEY` for Gemini models
+   - **Ollama**: Local installation with required models
 
----
+### Environment Configuration
 
-## 🔐 Environment Variables
+Create a `.env` file in your working directory with your API keys:
 
-```bash
-# Required
-GEMINI_API_KEY=        # Google Gemini API key
-OLLAMA_HOST=           # Ollama server URL (default: http://localhost:11434)
+```env
+# Required (choose at least one)
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+GOOGLE_AI_API_KEY=your_google_api_key_here
+# or
+GEMINI_API_KEY=your_gemini_api_key_here
 
 # Optional
-DEBUG=                 # Enable debug logs (true/false)
-```
-
----
-
-## 🏃 Development
-
-### Project Structure
-
-```
-terminal/galaxy_cli/
-├── source/
-│   ├── ai/
-│   │   └── orchestrator.ts      # Gemini orchestrator
-│   ├── connections/
-│   │   ├── gemini.ts            # Gemini connection
-│   │   └── ollama.ts            # Ollama connection
-│   ├── prompts/
-│   │   ├── orchestrator.ts      # Main workflow prompts
-│   │   ├── ba-it-analyzer.ts    # BA analysis prompts
-│   │   └── planning-agent.ts    # Planning prompts
-│   ├── tools/
-│   │   ├── ba-it-analyzer.ts    # BA analyzer tool
-│   │   ├── planning-agent.ts    # Planning agent tool
-│   │   ├── file-operations.ts   # File tools
-│   │   ├── git-operations.ts    # Git tools
-│   │   └── registry.ts          # Tool registry
-│   ├── app.tsx                  # Main Ink app
-│   └── cli.tsx                  # CLI entry
-├── dist/                        # Compiled output
-├── package.json
-└── tsconfig.json
-```
-
-### Build & Test
-
-```bash
-# Development với auto-reload
-bun run dev
-
-# Build TypeScript
-bun run build
-
-# Type checking
-bun run type-check
-
-# Format code
-bun run format
+OLLAMA_HOST=http://localhost:11434
+DEBUG=false
 ```
 
----
-
-## 📈 Roadmap
-
-- [ ] **Execution Engine**: Tự động chạy plan steps
-- [ ] **Code Review Agent**: Review code trước khi commit
-- [ ] **Testing Agent**: Tự động generate tests
-- [ ] **Documentation Agent**: Auto-generate docs
-- [ ] **Multi-project support**: Làm việc với nhiều projects
-- [ ] **Plugin system**: Mở rộng tools dễ dàng
-- [ ] **Web UI**: Dashboard quản lý projects
-
----
-
-## 🤝 Contributing
-
-Contributions are welcome! Please follow these steps:
-
-1. Fork the repo
-2. Create feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit changes (`git commit -m 'Add amazing feature'`)
-4. Push to branch (`git push origin feature/amazing-feature`)
-5. Open Pull Request
-
----
-
 ## 📄 License
 
-MIT License - see LICENSE file for details
-
----
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
 ## 👨‍💻 Author
 
-**Bùi Trọng Hiếu (Kevin Bui)**
-
-- **Personal Email:** kevinbui210191@gmail.com
-- **Work Email:** hieubt2@msb.com.vn
-- **GitHub:** [@kevinbui210191](https://github.com/kevinbui210191)
+**Kevin Bui (Bùi Trọng Hiếu)**
 
----
+- Email: kevinbui210191@gmail.com
+- GitHub: [@kevinbui](https://github.com/kevinbui)
 
 ## 🙏 Acknowledgments
 
-- **Ink** - React for CLI
-- **Google Gemini** - LLM orchestration
-- **Ollama** - Local LLM hosting
-- **Bun** - Fast JavaScript runtime
+- [Ink](https://github.com/vadimdemedes/ink) - React for interactive command-line apps
+- [Anthropic Claude](https://www.anthropic.com/claude) - Advanced AI models
+- [Google Gemini](https://ai.google.dev/) - AI orchestration
+- [Ollama](https://ollama.com/) - Local AI model serving