CopilotHydra

CopilotHydra is an OpenCode plugin for using multiple GitHub Copilot accounts side by side.

Status

• Stable — v0.3.8
• Tested with OpenCode 1.3.x and 1.20.x
• Scope: GitHub.com Copilot, macOS/Linux first, Windows best-effort

What it does

• adds and re-authenticates Copilot accounts through opencode auth login
• keeps accounts separated through account-scoped providers
• supports explicit manual routing per account/model
• tracks the current documented personal-plan Copilot model baseline across GPT-4.1, GPT-5 variants, Claude, Gemini, Grok, Raptor mini, and Goldeneye
• provides CLI maintenance commands for sync, audit, repair, mismatch review, and usage snapshots

Quick start

Install globally or as a dev dependency:

npm install -g copilothydra
# or
npm install copilothydra

Then use the primary flow in OpenCode:

opencode auth login

Useful CLI commands:

copilothydra list-accounts
copilothydra sync-config
copilothydra backfill-keychain
copilothydra export-primary-compat <account-id>
copilothydra audit-storage
copilothydra repair-storage
copilothydra review-mismatch <account-id>
copilothydra usage

Known limitations

• Native OS keychain publishing is best-effort; copilot-secrets.json retained for fallback.
• Capped at 8 active accounts (architecture limit).
• User-declared plans — no automatic plan verification; runtime mismatches are flagged.
• macOS/Linux primary, Windows best-effort.
• Enterprise-managed GitHub.com and GHES are not supported.

See Operator guide for native integrations, backfill instructions, and support boundaries.

For the live upstream model list, see GitHub's official Supported AI models in GitHub Copilot.

Docs

• Changelog
• Operator guide — auth/recovery, mismatch review, storage repair, support boundaries
• Technical reference — compatibility matrix, release gate, storage security, parity notes

Development

npm run build
npm run typecheck
npm test