The world's first CLI with complete server state snapshotting and cherry blossom-themed aesthetics.
A revolutionary, security-first command-line interface for Cherry Servers infrastructure management featuring military-grade encryption, complete server state capture via the Capsule System, and beautiful cherry blossom-themed user experience.
- 🔬 Complete Server Snapshot: Users, packages, services, configs, data, SSH keys, crontabs, network settings
- 🔐 Military-Grade Security: AES-256-GCM encryption with SHA-512 integrity verification
- 📦 Intelligent Optimization: 90%+ size reduction through rebuild artifact detection
- 🚀 Secure Transfer: Encrypted transmission with remote confirmation
- ⚡ Automated Restoration: One-command server recreation from capsules
- AES-256-GCM Encryption for all data transfers
- TLS 1.3 for secure API communications
- GPG Integration for file encryption
- SSH Key Management with automated deployment
- Zero-Knowledge Operation with automatic cleanup
- Smart SSH Management with automatic user switching
- Cherry Blossom Aesthetics with sakura-themed interface
- Emoji-Rich Feedback for immediate visual context
- Progressive Help System with contextual guidance
- Peer Discovery with automatic topology mapping
- NAT Traversal using sophisticated hole-punching
- End-to-End Encryption for secure peer communication
- Load Balancing with intelligent peer selection
- Fault Tolerance with automatic failover
macOS/Linux:
# One-line installation (both binaries)
curl -sSL https://raw.githubusercontent.com/cherryservers/cherry-cli/main/install.sh | bash
# Manual installation (both binaries)
git clone https://github.com/cherryservers/cherry-cli.git
cd cherry-cli
make && make install
# Install individual binaries
make install-foundation # Installs seedling
make install-cherry # Installs cherryWindows (WSL2):
# Install WSL2 + Ubuntu (Run as Administrator)
wsl --install
# In Ubuntu terminal
sudo apt update && apt install -y build-essential libssl-dev git
git clone https://github.com/cherryservers/cherry-cli.git
cd cherry-cli && make && make install# Initialize configuration
cherry init
# Set your Cherry Servers API token
export CHERRY_AUTH_TOKEN="your-token-here"
# Verify installation
seedling --version # Foundation implementation (v1.0.0)
cherry --version # Primary development interface (v2.1.0-nightly)
cherry list# Create complete server snapshot
cherry server produce capsule
# → Creates encrypted .capsule file with full server state
# Transfer server state to new environment
cherry server beam capsule production-server
# → Secure transmission with integrity verification
# Restore complete server from capsule
cherry server receive capsule
# → Automated server recreation with all configurations# Transfer encrypted files
cherry send document.pdf my-server # Single file with AES-256
cherry send ./project/ production-server # Entire directory compressed
cherry send backup.tar.gz staging-server # Large files optimized# Smart SSH with user switching
cherry blossom # SSH to active server
cherry blossom deploy # SSH and switch to 'deploy' user
cherry blossom www-data # SSH and switch to 'www-data'
cherry blossom pair # Set up SSH key authentication# Server management
cherry server activate my-server # Set active server
cherry server info # Detailed server information
cherry server create --plan c1-small --image ubuntu_22_04
cherry install docker # Install tools on active server# P2P operations
cherry p2p init # Initialize P2P node
cherry p2p peers # List connected peers
cherry p2p send peer-id "Hello Cherry!" # Secure messaging
cherry p2p discover # Network topology discoveryCherry CLI implements a dual-architecture approach with two complementary implementations:
- Binary:
seedling - Status: ✅ Fully Functional with 120+ commands
- Architecture: Mature monolithic design with proven stability
- Features: Complete Capsule System, P2P networking, security features
- Use Case: Production deployments requiring immediate functionality
- Binary:
cherry - Status: 🚧 Active Development (modular design complete)
- Architecture: Clean modular structure with enhanced performance
- Features: Memory-safe design, <30ms startup, comprehensive testing
- Use Case: Primary development interface with modern C practices
cherry-cli/
├── interfaces/
│ ├── foundation/ # 🏛️ Production-ready implementation (seedling)
│ │ ├── src/ # 36 source files, 120+ commands
│ │ ├── include/ # Comprehensive headers
│ │ └── platforms/ # Multi-platform support
│ └── cherry/ # ⚡ Primary development interface (cherry)
│ ├── src/
│ │ ├── core/ # System initialization
│ │ ├── commands/ # Modular command structure
│ │ ├── lib/ # Core libraries
│ │ └── p2p/ # P2P networking subsystem
│ └── tests/ # Comprehensive test suite
- AES-256-GCM: File and capsule encryption
- SHA-512: Integrity verification
- TLS 1.3: API communications
- GPG: Additional file encryption layer
- libsodium: P2P networking security
- ✅ Buffer Overflow Protection
- ✅ Memory Leak Prevention
- ✅ Input Validation & Sanitization
- ✅ Principle of Least Privilege
- ✅ Zero-Knowledge Temporary Files
- Audit Logging: Comprehensive operation tracking
- Access Control: Role-based permissions
- Data Residency: Configurable storage locations
- Encryption at Rest: All stored data encrypted
| Platform | Status | Installation Method | Notes |
|---|---|---|---|
| macOS | ✅ Full Support | Homebrew, Source | Native performance |
| Linux | ✅ Full Support | Package Manager, Source | All major distributions |
| Windows | ✅ WSL2 Support | WSL2 + Ubuntu | Cherry iTerm experience |
| ARM64 | ✅ Native Support | Source compilation | Apple Silicon, ARM servers |
- 🌸 Cherry iTerm Wrapper: Complete iTerm experience in Windows Terminal
- 🤖 Claude Code Integration: AI-powered development workflows
- ⌨️ iTerm-Style Shortcuts: Familiar macOS hotkeys (Ctrl+T, Ctrl+D)
- 🎨 Custom Themes: Cherry-branded color schemes
- 💾 Session Management: Multi-project layout persistence
| Metric | Specification | Typical Performance |
|---|---|---|
| Startup Time | <100ms | ~50ms |
| Memory Usage | <8MB | ~4MB |
| Command Response | <200ms | ~100ms |
| File Transfer | 50MB/s+ | ~80MB/s |
| Metric | Target | Achieved |
|---|---|---|
| Startup Time | <30ms | ~15ms |
| Memory Usage | <4MB | ~2MB |
| Binary Size | <2MB | ~1.5MB |
| Response Time | <50ms | ~25ms |
cherry list # List all servers
cherry info <server-id> # Detailed server info
cherry create --plan c1-small --image ubuntu # Create server
cherry server activate <server> # Set active server
cherry ssh <server> [user] # SSH connectioncherry send <file> <server> # Encrypted file transfer
cherry retrieve <server>:<remote> <local> # Secure file retrieval
cherry deploy <project> <server> # Project deploymentcherry idea add "API Rate Limiting" # Capture new ideas
cherry idea list --priority 4,5 # Review high-priority ideas
cherry idea search "authentication" # Find related concepts
cherry idea connect 23 31 --type implements # Link related ideas
cherry idea analyze 42 --enhance # AI-powered idea analysischerry server produce capsule # Create server snapshot
cherry server beam capsule <target> # Transfer server state
cherry blossom [user] # Enhanced SSH
cherry p2p init # P2P networking
cherry install <tool> # Tool installationcherry init # Initial setup
cherry config show # View configuration
cherry doctor # System health check
cherry --help # Comprehensive help- 🌸 Sakura Pink: Primary accent for key operations
- 🌿 Spring Green: Success states and positive feedback
- 🌌 Sky Blue: Information and guidance
- 🤍 Cherry White: Clean, readable text
- 🌙 Twilight Purple: Error states and warnings
- Emoji-Rich Feedback: Visual context for operations
- Progressive Loading: Beautiful progress indicators
- Contextual Help: Smart suggestions and guidance
- Accessibility: WCAG-compliant color schemes
- Multi-Theme Support: Dark, light, and monochrome modes
# Clone repository
git clone https://github.com/cherryservers/cherry-cli.git
cd cherry-cli
# Foundation implementation
cd implementations/foundation
make clean && make debug
# Evolution implementation
cd implementations/evolution
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Debug ..
make -j$(nproc)- C Standard: C11 with GNU extensions
- Memory Safety: Comprehensive bounds checking
- Documentation: Doxygen-compatible comments
- Testing: Unit and integration test coverage
- Security: Static analysis and vulnerability scanning
- Fork the repository
- Create feature branch following naming conventions
- Implement changes with comprehensive tests
- Ensure security and performance standards
- Submit pull request with detailed description
- Architecture Overview
- Idea Management System
- P2P Networking Guide
- API Integration
- Performance Tuning
- 📖 Documentation: Comprehensive guides and references
- 🐛 GitHub Issues: Bug reports and feature requests
- 💬 Discussions: Community questions and support
- 📧 Security: security@cherryservers.com for vulnerabilities
- Cherry Servers API: https://docs.cherryservers.com/
- cherryctl CLI: https://github.com/cherryservers/cherryctl
- Community Forum: https://community.cherryservers.com/
Cherry CLI is released under the MIT License. See LICENSE for complete terms.
- Cherry Servers Team: API and infrastructure support
- OpenSSL Project: Cryptographic foundation
- libsodium Developers: Modern cryptography library
- Security Researchers: Vulnerability disclosure and improvements
- Open Source Community: Dependencies and continuous improvement
For security vulnerabilities, please email security@cherryservers.com with details. We follow responsible disclosure practices and will acknowledge contributions appropriately.
- Cherry Server Capsule System with AES-256-GCM encryption
- Complete server state snapshotting and restoration
- Blossom user management with SSH automation
- Advanced P2P networking with NAT traversal
- Secure file transfer with GPG integration
- Windows support via Cherry iTerm wrapper
- Idea Management System: Comprehensive concept capture and development workflow
- AI-Powered Optimization: ML-based server configuration recommendations
- Distributed Capsules: Multi-server orchestrated snapshots
- Cloud Storage Integration: Direct AWS S3/GCS capsule storage
- Incremental Snapshots: Delta-based updates for efficiency
- Performance Analytics: Real-time optimization recommendations
- Multi-Tenant Architecture: Organization-based access control
- Policy Engine: Rule-based automation and security enforcement
- Disaster Recovery: Automated failover and restoration workflows
- Compliance Dashboard: Audit trail and compliance reporting
- API Management: RESTful API for programmatic access
🌸 Made with love and cherry blossoms 🌸
Where revolutionary technology meets beautiful design in server management.
