Upgrades and migration
Run shine --version before upgrading and read every item that applies to your starting version
Manage shell presets
Shell presets install scripts into Shine's managed directory and create directly callable command
Upgrade from Shine 1.x
This guide covers upgrading an existing 1.x installation to Shine 2.10. Review the lifecycle security
Manage application configuration
Application presets install configuration where the application expects it. Existing unmanaged files
Initialize and manage a system
System presets provide selectable development-environment initialization steps for macOS, Ubuntu,
Customize presets
Use an overlay for a small number of customizations. Use an external presets_dir when you need to
Migrate system presets to v2
This page is for users maintaining custom v1 system presets. If you only use the system presets
Manage environment variables and secrets
Shine stores variables used by preset templates and can seal sensitive project-environment values
SSH sessions, secret brokering, and file transfer
shine ssh opens a normal SSH session with optional selected environment forwarding, on-demand local
Tasks and application artifacts
This guide shows how to save personal command shortcuts and run application artifact scripts.
Protect environment secrets when using AI agents
When AI agents such as Claude Code or Codex participate in development, secret safety involves more
Synchronize the terminal theme
In managed shell profiles on macOS and Ubuntu, Shine can detect whether the terminal background is