Sử dụng cơ bản

Hướng dẫn này giới thiệu các tính năng cơ bản và cách sử dụng Galaxy CLI hiệu quả.

Giao diện CLI

Khi khởi động, Galaxy hiển thị ASCII art banner:

   ____       _                    ____ _     ___
  / ___| __ _| | __ ___  ___   _  / ___| |   |_ _|
 | |  _ / _` | |/ _` \ \/ / | | || |   | |    | |
 | |_| | (_| | | (_| |>  <| |_| || |___| |___ | |
  \____|\__,_|_|\__,_/_/\_\\__, | \____|_____|___|
                           |___/

Version: 2.0.0
ENTER to send • \ + ENTER for new line • @ to mention files
Current folder: /path/to/project
Agent=auto Git=OFF Test=OFF Review=OFF

> _

Input Prompt

> _  # Cursor chờ input

Bạn có thể:

Nhập natural language requests
Sử dụng internal commands (bắt đầu với /)
Dùng keyboard shortcuts

Các tính năng cơ bản

1. Hỏi đáp (Q&A)

Galaxy có thể trả lời câu hỏi về programming:

> React hooks là gì?

> So sánh Next.js App Router và Pages Router

> Cách optimize performance cho React app?

2. Phân tích dự án

Yêu cầu Galaxy phân tích cấu trúc và tech stack:

> Phân tích dự án này

Galaxy sẽ:

Scan file structure (file_tree)
Đọc package.json, README.md
Analyze tech stack
List features hiện có
Suggest improvements

Example Output:

📊 Phân tích dự án: My Next.js App

🏗️ Tech Stack:
- Next.js 14 (App Router)
- TypeScript
- Tailwind CSS
- Prisma + PostgreSQL

✨ Features:
1. User Authentication
2. Blog Posts (CRUD)
3. Comment System

📁 Cấu trúc:
- app/ - Next.js pages
- components/ - React components
- lib/ - Utilities
- prisma/ - Database schema

💡 Đề xuất:
1. Add API documentation
2. Implement caching layer
3. Add E2E tests
4. Setup CI/CD

3. Tạo dự án mới

Mô tả dự án muốn tạo

> Tạo app todo list với React và TypeScript

Galaxy phân tích và đề xuất

BA Agent sẽ phân tích requirements
Xác nhận plan
Terminal window
```
> yes, làm đi
```
Galaxy tự động implement

Từng step sẽ được execute với progress tracking

Xem chi tiết →

4. Thêm tính năng

Thêm feature mới vào dự án hiện có:

> Thêm search functionality với debouncing

> Implement real-time notifications với WebSocket

Xem chi tiết →

5. Refactoring

Yêu cầu Galaxy refactor code:

> Refactor components folder để dễ maintain hơn

> Extract reusable hooks từ component này

6. Debugging help

> Tại sao component này re-render nhiều lần?

> Làm sao fix lỗi "hydration mismatch" trong Next.js?

Input Features

Multi-line Input

Để nhập nhiều dòng, dùng \ + Enter:

> Tạo app với features sau: \
  - User authentication \
  - Post CRUD \
  - Comment system

Command History

Dùng ↑ / ↓ để duyệt lịch sử input:

> /history  # Xem 10 input gần nhất

Recent inputs:
1. Tạo app Next.js
2. Thêm authentication
3. Phân tích dự án

Command Autocomplete

Khi gõ /, Galaxy hiển thị suggestions:

> /h
┌─────────────────────────────────────┐
│ /help           Hiển thị lệnh       │
│ /history        Xem lịch sử         │
└─────────────────────────────────────┘

Dùng Tab hoặc ↓ để chọn, Enter để execute.

Loading States

Galaxy hiển thị progress khi đang làm việc:

Spinner

⠋ Thinking...

Tool Execution

⚡ EXECUTE (npm install react)
↳ ✓ Success. Output: 12 lines.

File Operations

📝 APPLY PATCH (src/App.tsx)
↳ Succeeded. File edited. (+15 added, -3 removed)

Todos Progress

📋 Implementation Plan:
☐ Step 1: Initialize project
☒ Step 2: Install dependencies - Completed
⚙ Step 3: Implement Feature A - In progress...
☐ Step 4: Implement Feature B

Working Directory

Galaxy làm việc trong current working directory:

> /pwd
⚙ Working directory: /Users/you/projects/my-app

Để đổi directory, thoát Galaxy và cd:

> /exit
$ cd ../another-project
$ bun run start

Session Management

Bắt đầu session mới

bun run start

Clear conversation

> /clear
✅ Cleared conversation and progress

Thoát Galaxy

> /exit
⚙ Goodbye!

Hoặc Ctrl+C.

Progress Tracking

Galaxy lưu progress vào file .galaxy/progress.json:

{
  "projectName": "My App",
  "createdAt": "2025-01-10T10:00:00Z",
  "steps": [
    {
      "step": 1,
      "action": "Initialize project",
      "status": "completed"
    },
    {
      "step": 2,
      "action": "Implement Feature A",
      "status": "in-progress"
    }
  ]
}

Xem progress location:

> /progress
📄 Progress file: /path/to/project/.galaxy/progress.json

Best Practices

Mô tả chi tiết

Càng chi tiết càng tốt khi describe requirements:

# ❌ Vague
> Tạo app blog

# ✅ Detailed
> Tạo blog app với Next.js 14,
  Markdown posts, tag system,
  search, và RSS feed

Confirm before execute

Luôn review plan trước khi confirm:

# Review plan
📋 Implementation Plan:
☐ Step 1: ...
☐ Step 2: ...

# Adjust if needed
> Thêm step test vào plan

# Then confirm
> yes

Incremental work

Làm từng phần thay vì all-at-once:

# Session 1
> Tạo basic structure

# Session 2
> Thêm authentication

# Session 3
> Thêm admin panel

Review generated code

Luôn review code được generate:

git diff
# Review changes

npm run dev
# Test functionality

Tips & Tricks

1. Combine với Git

# Commit trước khi Galaxy làm việc
git add .
git commit -m "Before Galaxy changes"

# Chạy Galaxy
> Thêm feature X

# Review changes
git diff

# Commit hoặc rollback
git commit -m "Added feature X"
# or
git reset --hard HEAD

2. Use với existing projects

# Backup trước
cp -r . ../backup

# Chạy Galaxy
> Refactor codebase này

# Test thoroughly
npm test
npm run build

3. Learning tool

Dùng Galaxy để học:

> Giải thích code này và cách improve nó
> [paste code]

> Viết lại component này theo best practices

Keyboard Shortcuts

Phím	Chức năng
`Enter`	Send message
`\` + `Enter`	New line
`↑` / `↓`	Browse history
`Tab`	Next suggestion
`Shift+Tab`	Previous suggestion
`Esc`	Close suggestions
`Ctrl+C`	Exit Galaxy

Troubleshooting

Galaxy không respond

# Check Ollama running
ollama list

# Check Gemini API key
echo $GEMINI_API_KEY

Tool execution failed

# Check terminal output
# Galaxy hiển thị error details

# Try again hoặc skip step
> skip step này, làm tiếp

Out of sync

# Clear và restart
> /clear
> Bắt đầu lại từ đầu

Các bước tiếp theo

Examples - Xem ví dụ chi tiết
Commands - Tất cả internal commands
CLI Flags - Command-line flags