Upgrades and migration
Run shine --version before upgrading and read every item that applies to your starting version
Manage shell presets
Shell presets install reusable scripts as commands you can call directly in Bash, Zsh, or
Upgrade from Shine 1.x
This guide covers upgrading an existing 1.x installation to Shine 2.10. Review the approval
Manage application configuration
Application presets install configuration where the application expects it. Existing unmanaged
Initialize and manage a system
Use system presets to install selected development tools on macOS, Ubuntu, or Windows and enable
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