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
• 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.

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