Command Options

Galaxy CLI hỗ trợ các command options để cấu hình hành vi từ lúc khởi động.

Danh sách Options

--help / -h

Hiển thị thông tin help và thoát.

galaxy --help

Output:

Galaxy CLI - AI Pair Programming Tool

Usage:
  galaxy [options]

Options:
  -h, --help      Show help
  -v, --version   Show version
  --test          Enable test planning
  --review        Enable code review
  --git           Enable git operations

--version / -v

Hiển thị phiên bản hiện tại.

galaxy --version
# Output: 2.0.0

--test

Enable test planning step trong execution plan.

galaxy --test

Khi enable:

• Planning Agent sẽ thêm step “Write unit tests”
• Galaxy tự động generate test files
• Chạy tests sau khi implement features

Example Plan:

☐ Step 1: Initialize project
☐ Step 2: Implement Feature A
☐ Step 3: Implement Feature B
☐ Step 4: Write unit tests        ← Added by --test
☐ Step 5: Write integration tests  ← Added by --test

Mẹo

Sử dụng --test khi muốn Galaxy tự động generate tests cho dự án.

--review

Enable code review step trong execution plan.

galaxy --review

Khi enable:

• Planning Agent thêm step “Code review & refactoring”
• Galaxy review code quality
• Suggest improvements
• Refactor if needed

Example Plan:

☐ Step 1: Initialize project
☐ Step 2: Implement Feature A
☐ Step 3: Implement Feature B
☐ Step 4: Code review & refactoring  ← Added by --review

Ghi chú

Code review giúp đảm bảo code quality trước khi hoàn thành dự án.

--git

Enable Git operations.

galaxy --git

Khi enable:

• Galaxy có thể sử dụng Git tools
• Auto commit sau khi complete steps
• Git diff để review changes

Chú ý

Chỉ enable --git khi bạn đã init git repo và muốn Galaxy tự động commit.

Kết hợp nhiều Options

Bạn có thể kết hợp nhiều options:

# Enable cả test và review
galaxy --test --review

# Enable tất cả
galaxy --test --review --git

Example Plan với tất cả options:

☐ Step 1: Initialize project
☐ Step 2: Implement Feature A
☐ Step 3: Implement Feature B
☐ Step 4: Write tests              ← --test
☐ Step 5: Code review              ← --review
☐ Step 6: Git commit changes       ← --git

So sánh Options vs Internal Commands

Setting	Command Option	Internal Command	Khi nào dùng?
Test Planning	--test	/test true	Option: Set từ đầu Command: Toggle runtime
Code Review	--review	/review true	Option: Set từ đầu Command: Toggle runtime
Git Operations	--git	/git true	Option: Set từ đầu Command: Toggle runtime

Mẹo

Command Options → Set config khi khởi động
Internal Commands → Thay đổi config trong session

Use Cases

Development Workflow

# Quick prototyping (no tests, no review)
galaxy

# Standard development (with tests)
galaxy --test

# Production-ready (with tests & review)
galaxy --test --review

# Full workflow (tests, review, auto commit)
galaxy --test --review --git

Learning & Experimentation

# Học cách viết tests
galaxy --test

# Học best practices từ code review
galaxy --review

Team Projects

# Ensure code quality cho team
galaxy --test --review --git

Environment Variables

Ngoài command options, bạn có thể cấu hình qua environment variables:

# .env hoặc export
GALAXY_TEST_ENABLED=true
GALAXY_REVIEW_ENABLED=true
GALAXY_GIT_ENABLED=false

Priority:

1. Command options (highest)
2. Internal commands
3. Environment variables
4. config.json
5. Default values (lowest)

Example 1

# .env: GALAXY_TEST_ENABLED=false
galaxy --test

# Result: Test ENABLED (option overrides .env)

Example 2

# .env: GALAXY_TEST_ENABLED=true
galaxy
# Result: Test ENABLED (from .env)

# Then in session:
> /test false
# Result: Test DISABLED (command overrides .env)

Best Practices

Start Simple

Bắt đầu không dùng options, sau đó thêm dần khi cần:

# Session 1: Prototype
galaxy

# Session 2: Add tests
galaxy --test

# Session 3: Full workflow
galaxy --test --review

Default Settings

Nếu bạn luôn muốn enable test, set trong config.json:

{
  "test": true
}

Thay vì gõ --test mỗi lần.

Git Auto-commit

Cẩn thận với --git option. Review commits trước khi push:

git log
git diff HEAD~1

Troubleshooting

Options không hoạt động

Check syntax:

# ❌ Wrong
galaxy -test

# ✅ Correct
galaxy --test

Options bị ignore

Check option order:

# ✅ Options trước arguments
galaxy --test --review

# ❌ Options sau arguments (có thể bị ignore)
galaxy myproject --test

Settings không persist

Ghi chú

Command options chỉ apply cho session hiện tại. Để persist, dùng config.json.

Các bước tiếp theo

• Commands - Tìm hiểu internal commands
• Configuration - Cấu hình nâng cao
• Quick Start - Bắt đầu sử dụng