Claude Code and Claude Flow on Fly.io

A complete remote AI-assisted development environment running Claude Code and Claude Flow on Fly.io infrastructure with zero local installation, auto-suspend VMs, and persistent storage.

⚡ Quick Start

# Clone and deploy
git clone https://github.com/pacphi/claude-flow-on-fly.git
cd claude-flow-on-fly
./scripts/vm-setup.sh --app-name my-claude-dev --region iad

# Connect and configure
ssh developer@my-claude-dev.fly.dev -p 10022
./scripts/vm-configure.sh

# Start developing
claude

Prerequisites: Fly.io CLI + SSH keys + Claude Max or API key

📚 Documentation

• Quick Start Guide - Fast setup using automated scripts
• Complete Setup - Manual setup walkthrough
• Architecture - System architecture and file structure
• Cost Management - Optimization strategies and monitoring
• Customization - Extensions, tools, and configuration
• Security - Security features and best practices
• Agents - Agent management, search, and development
• Turbo Flow - Mimic enterprise AI development features from turbo-flow-claude
• Contributing - Contribution guidelines and roadmap
• Reference - Complete command and configuration reference
• Troubleshooting - Common issues and solutions

IDE Setup

• IDE Setup Guide - Common setup for all IDEs
• VSCode - VS Code-specific configuration
• IntelliJ - JetBrains IDE-specific configuration

🌟 Key Features

• Zero Local Setup - All AI tools run on remote VMs
• Cost Optimized - Auto-suspend VMs (see cost guide for details)
• IDE Integration - VSCode and IntelliJ remote development
• Team Ready - Shared or individual VMs with persistent volumes
• Secure - SSH access with Fly.io network isolation
• Scalable - Dynamic resource allocation

🚀 Getting Started

1. Deploy VM: Run automated setup script
2. Connect IDE: Use VSCode Remote-SSH or IntelliJ Gateway
3. Configure: One-time environment setup
4. Develop: Start coding with AI assistance

See Quick Start Guide for detailed walkthrough.

💰 Cost Management

VMs auto-suspend when idle for optimal cost efficiency.

Manual controls:

./scripts/vm-suspend.sh    # Suspend to save costs
./scripts/vm-resume.sh     # Resume when needed
./scripts/cost-monitor.sh  # Track usage

Tip

See the cost management guide for optimization strategies.

🔧 Essential Commands

# VM Management
flyctl status -a my-claude-dev
./scripts/vm-teardown.sh --app-name my-claude-dev

# Development
ssh developer@my-claude-dev.fly.dev -p 10022
claude

Full command reference.

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

• Anthropic for Claude Code and Claude AI
• Reuven Cohen for Claude Flow
• Fly.io for an excellent container hosting platform