galaxy-code

🌌 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:

• Business Analysis - Understands requirements and constraints
• Technical Planning - Creates implementation steps
• Execution - Generates code and runs necessary commands
• 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:

• Node.js >= 18.14.1
• 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: [e-mail]
• GitHub: @kevinbui

🙏 Acknowledgments

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