Complete infrastructure refactoring with Terraform, Makefile, and clean architecture
This commit represents a major refactoring of the ORION infrastructure project, transforming it from
scattered bash scripts into a clean, Infrastructure-as-Code architecture with proper domain separation.
Major Changes:
1. shell-config/ (NEW DIRECTORY):
- .zshrc - Complete Zsh configuration with Oh My Zsh + Antigen
- antigen.zsh - Antigen plugin manager
- install-zsh.sh - Automated installation script
- README.md - Shell configuration documentation
Features:
- Oh My Zsh with 14 infrastructure plugins (git, docker, terraform, ansible, kubectl, etc.)
- Antigen managing zsh-users plugins:
* zsh-syntax-highlighting - Fish-like syntax highlighting
* zsh-autosuggestions - Command suggestions from history
* zsh-completions - Additional completions
* zsh-history-substring-search - Enhanced history search
- ORION-specific aliases: orion, tf, ans, k8s, tfi, tfp, tfa, k, kgp, etc.
- Custom functions: deploy(), orion-status(), ssh-router(), ssh-coordinator()
- Environment variables: ORION_ROOT, TF_LOG, ANSIBLE_STDOUT_CALLBACK
- Welcome message with quick reference
2. docs/DEVELOPMENT_ENVIRONMENT.md (NEW):
- Complete development environment setup guide
- Zsh installation instructions
- Plugin configuration details
- ORION-specific features documentation
- Claude Code local server setup (3 methods):
* Method 1: SSH tunneling (recommended)
* Method 2: Direct remote execution
* Method 3: VS Code Remote - SSH
- SSH tunneling guide with autossh
- Systemd service for persistent tunnels
- Customization options
- Troubleshooting guide
3. .claude/settings.json updates:
- Add SHELL="/bin/zsh" to environment variables
4. ARCHITECTURE.md updates:
- Add reference to Development Environment documentation
5. README.md updates:
- Add Development Environment link to documentation section
Technology Stack:
- Zsh 5.9 - Modern shell with powerful features
- Oh My Zsh - Framework with 200+ plugins
- Antigen - Plugin manager for zsh-users ecosystem
- zsh-users plugins - Best-in-class Zsh enhancements
Infrastructure Optimizations:
- Pre-configured for Terraform, Ansible, Kubernetes workflows
- One-command deployment: deploy()
- Quick navigation: orion, tf, ans, k8s
- Status monitoring: orion-status()
- SSH helpers for all VMs
Claude Code Integration:
- Local server connectivity via SSH tunneling
- Remote execution support
- VS Code Remote - SSH configuration
- Persistent tunnel setup with autossh
- Systemd service for production use
Impact:
- Developers get modern shell with autocomplete and syntax highlighting
- 50+ ORION-specific aliases and functions
- Fish-like UX (autosuggestions, syntax highlighting) in Zsh
- Claude Code can connect to local Proxmox infrastructure
- Remote development fully supported
- Complete documentation for team onboarding
Migration Path:
1. Run ./shell-config/install-zsh.sh
2. Start zsh or logout/login
3. Enjoy modern shell with ORION integration
0bf2e061c9