0bf2e061c9
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
|
||
|---|---|---|
| .. | ||
| .zshrc | ||
| README.md | ||
| antigen.zsh | ||
| install-zsh.sh | ||
README.md
ORION Shell Configuration
Zsh + Oh My Zsh + Antigen + zsh-users plugins for infrastructure development
🚀 Quick Start
# Run the installation script
./install-zsh.sh
# Start zsh
zsh
# Or set as default shell (requires logout)
chsh -s $(which zsh)
📦 What's Included
- Zsh 5.9 - Modern shell
- Oh My Zsh - Framework with 14+ infrastructure plugins
- Antigen - Plugin manager
- zsh-users plugins:
zsh-syntax-highlighting- Fish-like syntax highlightingzsh-autosuggestions- Fish-like autosuggestionszsh-completions- Additional completionszsh-history-substring-search- Better history search
📁 Files
shell-config/
├── .zshrc # Complete Zsh configuration
├── antigen.zsh # Antigen plugin manager
├── install-zsh.sh # Automated installation script
└── README.md # This file
🎯 Features
Infrastructure Aliases
# Navigation
orion, tf, ans, k8s
# Terraform
tfi, tfp, tfa, tfd, tfo, tfs
# Kubernetes
k, kgp, kgs, kgn, kd, kl, ke
# Make
m, mh, mdeploy, mverify
Custom Functions
deploy() # Quick deploy ORION stack
orion-status() # Complete infrastructure status
ssh-router() # SSH to router VM
ssh-coordinator() # SSH to AI coordinator
ssh-netbox() # SSH to NetBox
ssh-k8s-master() # SSH to K8s master
proxmox-vms() # List Proxmox VMs
proxmox-lxc() # List LXC containers
📚 Documentation
See docs/DEVELOPMENT_ENVIRONMENT.md for complete documentation including:
- Detailed installation guide
- Plugin configuration
- Claude Code integration
- SSH tunneling for remote development
- Customization options
- Troubleshooting
🔧 Manual Installation
If you prefer manual installation:
# 1. Install Zsh
sudo apt-get install zsh git curl wget
# 2. Install Oh My Zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
# 3. Install Antigen
curl -L git.io/antigen > ~/antigen.zsh
# 4. Copy configuration
cp .zshrc ~/.zshrc
cp antigen.zsh ~/antigen.zsh
# 5. Start zsh
zsh
💡 Quick Tips
Autosuggestions: Type a few letters, press → to accept
Syntax Highlighting: Green = valid command, Red = invalid
History Search: Press ↑ to search history by substring
Quick Deploy: Just type deploy
Status Check: Type orion-status for complete overview
Last Updated: 2025-11-22