🌌 Galaxy Code

AI-Powered Coding Assistant - An intelligent CLI tool that helps you build, analyze, and enhance your software projects with AI.

🚀 Quick Start

Install Galaxy Code globally:

npm install -g galaxy-code

Or run directly with npx:

npx galaxy-code

📚 Documentation

Comprehensive documentation is available at: https://galaxy-code-cli.vercel.app

🎯 What is Galaxy Code?

Galaxy Code is an AI-powered coding assistant that helps developers:

• 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

Powered by advanced AI models and a comprehensive toolset, Galaxy Code acts as your AI pair programmer.

🛠 AI Model Support

Galaxy Code supports multiple AI providers:

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

Ollama (Local)

• Models: Any model hosted locally via Ollama
• Features: Privacy-focused, offline development
• Setup: Install Ollama and pull required models

🚀 Usage

Running Galaxy Code

After installation, simply run:

galaxy-code

Or with npx (no installation required):

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 |

Example Usage

# Start with default settings
$ galaxy-code

# Enable test planning from startup
$ galaxy-code --test

# Display current configuration
$ galaxy-code --config

# Reset configuration to defaults
$ galaxy-code --reset-config

# Enable development mode
$ galaxy-code --dev

# Disable auto-update
$ galaxy-code --no-auto-update

In-App Command Examples

# Analyze current project
> Analyze this project

# Create a new Next.js application
> Create a Next.js e-commerce app with TypeScript

# Add authentication to existing project
> Add JWT authentication to this app

# Ask technical questions
> What are React hooks?

# Enable test planning
> /test true

# Switch to Claude agent
> /mode claude

# Check system information
> /information

# View command history
> /history

# Exit the application
> /exit

🏗 How It Works

1. Project Analysis

Galaxy Code can analyze existing projects to understand:

• Project structure and architecture
• Technology stack in use
• Key features and components
• Potential improvement areas

2. Feature-Driven Planning

When creating or adding features, Galaxy Code follows a structured approach:

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

All file operations, git commands, and system calls are handled through integrated tools that:

• Automatically create and modify files
• Execute shell commands safely
• Track progress and report results
• Handle errors gracefully

📋 Prerequisites

Before using Galaxy Code, ensure you have:

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

Create a .env file in your working directory with your API keys:

# 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
OLLAMA_HOST=http://localhost:11434
DEBUG=false

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Kevin Bui (Bùi Trọng Hiếu)

• Email: [email protected]
• GitHub: @kevinbui

🙏 Acknowledgments

• Ink - React for interactive command-line apps
• Anthropic Claude - Advanced AI models
• Google Gemini - AI orchestration
• Ollama - Local AI model serving