maximal
Copilot, Claude and Codex
walked into a taskbar…
What is this
You already have a GitHub Copilot subscription? Of course you do. Connect Claude Code, Codex, opencode, and more to your existing GitHub Copilot subscription with maximal.
Use Claude Code, Codex, Copilot Chat, opencode: or whatever the cool kids make tomorrow. Run them all, or switch to something new using maximal.
Download
Click the installer for you, or a copy for a friend. We'll show you what to do with it once the download starts.
What to do with it: double-click the
.dmg to open it, then drag
maximal.app onto the Applications shortcut.
Eject the disk image and you're done.
What to do with it: double-click the
.msi to install. SmartScreen will warn you the
first time — see the warning below.
What to do with it: copy/paste into a terminal, Claude Code CLI, or Copilot CLI.
iex (irm https://github.com/stuffbucket/maximal/releases/download/v0.3.5/install.ps1) What to do with it: copy/paste into a terminal, Claude Code CLI, or Copilot CLI.
tar -xzf maximal-v0.3.5-darwin-arm64.tar.gz && ./maximal --help What to do with it: copy/paste into a terminal, Claude Code CLI, or Copilot CLI.
brew install stuffbucket/tap/maximal What to do with it: extract the
.zip and run maximal.exe from
a PowerShell prompt in the extracted folder. No installer.
First-launch warning
macOS bundles are signed and notarized. Windows builds aren't yet — like plenty of apps you've already installed, SmartScreen will throw an "are you sure?" on first launch. Click through once and you're set.
macOS: nothing to click through. The
.dmg is signed and notarized by Apple, so
the app launches like any other Mac app — drag, eject,
double-click.
macOS: macOS quarantines downloaded
binaries. Either approve once in System Settings → Privacy & Security → Open Anyway, or strip the flag from a Terminal:
xattr -dr com.apple.quarantine ./maximal.
Windows: SmartScreen will say "Windows
protected your PC" on the .msi. Click
More info, then Run anyway.
Windows: SmartScreen will flag the
.ps1. Click More info → Run anyway.
If PowerShell's execution policy rejects the script, run it
with powershell -ExecutionPolicy Bypass -File install.ps1.
Homebrew: nothing to click through. Brew strips the quarantine flag on install, so the binary just runs.
Windows: SmartScreen will block the first
run of maximal.exe. Right-click →
Properties → Unblock, or click
More info → Run anyway.
Setup
- Install.
Double-click the
.dmgto mount it, dragmaximal.apponto the Applications shortcut, and eject the disk image. Extract the tarball:tar -xzf maximal-v0.3.5-darwin-arm64.tar.gz. The binary is./maximal— run it from there or symlink it onto yourPATH. Double-click the.msiand step through the installer. It putsmaximalon yourPATH. Right-clickinstall.ps1and choose Run with PowerShell, or use the one-liner shown in the Download section above to install in one step. Extract the.zip.maximal.exeis at the root of the extracted folder — run it from there, or add the folder to yourPATH. From any terminal, runbrew install stuffbucket/tap/maximal. Brew handles the tap, the binary, and PATH for you. - Authenticate.
Open Terminal and run the one-time GitHub
device-code flow. This is the only required terminal step.
Open PowerShell and run the one-time
GitHub device-code flow. This is the only required
terminal step.
maximal setup - Point your client at it. The proxy listens on
localhost:4141. Configure Claude Code or Codex with that base URL — see the README for client snippets.