1. Install

The installer downloads the prebuilt CLI from GitHub Releases. Bun, Rust, and Xcode are not needed unless you build OreoDeck from source.

curl -fsSL https://raw.githubusercontent.com/OreoSolutions/oreodeck/main/install.sh | bash

2. Refresh the current shell

If you enabled shell integration during installation, refresh the terminal you already have open. From then on, a regular claude command uses OreoDeck profile resolution.

source ~/.zshrc

3. Add and use a profile

Adding a subscription profile opens a terminal for Claude login. An API-key profile stores the key in macOS Keychain. Set an active fallback, or select a profile only for the current tab or project.

oreodeck add work
ord use work
ord run

4. Verify

Confirm that both command names are available and inspect the resolved account before beginning work.

ord list
ord identity
ord status