Guise is a CLI identity manager for your developer tools. It allows you to seamlessly switch contexts (profiles) for tools like OpenAI Codex, Google Gemini, Anthropic Claude, and GitHub Copilot.
Think of it as a "vault" for your configuration files. Switch from "Personal" to "Work" credentials instantly with a beautiful TUI.
- Profile Switching: Safely swap configuration directories (e.g.,
~/.codex,~/.config/github-copilot). - Context Awareness: "Adopts" existing configurations so you don't lose your setup.
- Cross-Platform : Works on macOS, Linux, and Windows.
- Beautiful TUI: Built with Bubble Tea.
The easiest way to install Guise is via the install script:
curl -sL https://raw.githubusercontent.com/jagtesh/guise/main/install.sh | bashiwr -useb https://raw.githubusercontent.com/jagtesh/guise/main/install.ps1 | iexIf you have Go installed:
go install github.com/jagtesh/guise@latestRun the tool:
guise- Arrows (↑/↓): Navigate lists.
- Arrows (←/→): Switch between Provider list and Profile list.
- Enter: Select Provider / Activate Profile.
- n: New Profile (Captures current config).
- d: Delete Profile.
- q: Quit.
Guise stores its data in ~/.guise.
config.json: Maps providers to their target directories.store/: Contains the backed-up configuration files for each profile.
Guise comes pre-configured for:
- OpenAI Codex
- Google Gemini
- Anthropic Claude
- GitHub Copilot CLI
You can add custom providers by editing ~/.guise/config.json.
BSD 3-Clause