gh-multi 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# gh-multi
+
+Multi-account GitHub Copilot plugin for OpenCode that hooks into the native provider or runs standalone.
+
+## What It Does
+
+This plugin intercepts GitHub Copilot API requests and distributes them across multiple GitHub accounts. It automatically rotates credentials using round-robin or sticky strategies to maximize quota usage. This prevents rate limiting and extends coding sessions when single-account quotas are exhausted.
+
+## Requirements
+
+- Node.js 18+
+- OpenCode
+- Multiple GitHub accounts with Copilot access
+
+## Installation
+
+1. Navigate to the plugin directory:
+   ```bash
+   cd ~/.config/opencode/gh-multi
+   ```
+
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+3. Build the plugin:
+   ```bash
+   npm run build
+   ```
+
+## Configuration
+
+The configuration file is located at `~/.config/opencode/copilot.json`.
+
+**Example:**
+
+```json
+{
+  "logging": {
+    "enabled": true,
+    "level": "info"
+  },
+  "rotation_strategy": "round-robin"
+}
+```
+
+## Usage
+
+1. Run the OpenCode authentication command:
+   ```bash
+   opencode auth login
+   ```
+
+2. Select **GitHub Copilot Multi-Account** from the provider list.
+
+3. Follow the CLI prompts to authenticate each GitHub account via device flow.
+
+4. Once authenticated, the plugin will automatically manage credential rotation during chat sessions.
+
+## Logging
+
+Logs are written to the `gh-multi_logs` directory within the plugin folder.
+
+- **Location**: `~/.config/opencode/gh-multi/gh-multi_logs/gh-multi-{timestamp}.log`
+- **Debug Mode**: Set `"level": "debug"` in `copilot.json` or use the environment variable `GH_MULTI_DEBUG=1`.
+
+## License
+
+Proprietary

package/gh-multi-dist/constants.d.ts

@@ -0,0 +1,14 @@
+export declare const GITHUB_CLIENT_ID = "Ov23li8tweQw6odWQebz";
+export declare const GITHUB_SCOPES = "read:user";
+export declare const GITHUB_AUTH_URL = "https://github.com/login/device/code";
+export declare const GITHUB_TOKEN_URL = "https://github.com/login/oauth/access_token";
+export declare const USER_AGENT = "opencode-copilot-auth/0.1.0";
+export declare const OPENCODE_USER_AGENT: string;
+export declare const MAX_HEALTH = 100;
+export declare const INITIAL_HEALTH = 100;
+export declare const MIN_HEALTH_THRESHOLD = 20;
+export declare const DEFAULT_RATE_LIMIT_COOLDOWN: number;
+export declare const MAX_FAILURES_BEFORE_SUSPEND = 10;
+export declare const SESSION_CLEANUP_INTERVAL_MS: number;
+export declare const QUOTA_SYNC_INTERVAL_MS: number;
+export declare const SYNC_EVERY_N_REQUESTS = 10;

package/gh-multi-dist/constants.js

@@ -0,0 +1,16 @@
+export const GITHUB_CLIENT_ID = "Ov23li8tweQw6odWQebz";
+export const GITHUB_SCOPES = "read:user";
+export const GITHUB_AUTH_URL = "https://github.com/login/device/code";
+export const GITHUB_TOKEN_URL = "https://github.com/login/oauth/access_token";
+export const USER_AGENT = "opencode-copilot-auth/0.1.0";
+const VERSION = process.env.npm_package_version || "0.1.0";
+export const OPENCODE_USER_AGENT = `opencode/${VERSION}`;
+export const MAX_HEALTH = 100;
+export const INITIAL_HEALTH = 100;
+export const MIN_HEALTH_THRESHOLD = 20;
+export const DEFAULT_RATE_LIMIT_COOLDOWN = 5 * 60 * 1000;
+export const MAX_FAILURES_BEFORE_SUSPEND = 10;
+export const SESSION_CLEANUP_INTERVAL_MS = 5 * 60 * 1000;
+export const QUOTA_SYNC_INTERVAL_MS = 2 * 60 * 1000;
+export const SYNC_EVERY_N_REQUESTS = 10;
+//# sourceMappingURL=constants.js.map

package/gh-multi-dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AACzC,MAAM,CAAC,MAAM,eAAe,GAAG,sCAAsC,CAAC;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,6CAA6C,CAAC;AAE9E,MAAM,CAAC,MAAM,UAAU,GAAG,6BAA6B,CAAC;AAExD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC;AAC3D,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,OAAO,EAAE,CAAC;AAEzD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC;AAC9B,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AACzD,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAE9C,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC"}

package/gh-multi-dist/index.d.ts

@@ -0,0 +1,4 @@
+import { Plugin } from "@opencode-ai/plugin";
+export declare const nativeHook: Plugin;
+export declare const multiHook: Plugin;
+export default nativeHook;

package/gh-multi-dist/index.js

@@ -0,0 +1,110 @@
+import { CopilotAccountManager } from "./plugin/accounts.js";
+import { TokenManager } from "./plugin/token.js";
+import { createMultiAccountFetch } from "./plugin/fetch.js";
+import { loadConfig } from "./plugin/config/loader.js";
+import { CopilotCLI } from "./plugin/cli.js";
+import { log } from "./plugin/logger.js";
+let accountManager = null;
+let tokenManager = null;
+let customFetch = null;
+let config = null;
+let initPromise = null;
+async function ensureInitialized(input) {
+    if (initPromise)
+        return initPromise;
+    initPromise = (async () => {
+        config = await loadConfig();
+        log.initialize(input, config.logging);
+        log.info("init", "GH-MULTI COPILOT INITIALIZING");
+        accountManager = new CopilotAccountManager(config);
+        // Optimization: loadAccounts only performs local disk reads. 
+        // Network sync is fired in background (fire-and-forget) within loadAccounts.
+        await accountManager.loadAccounts();
+        tokenManager = new TokenManager();
+        customFetch = createMultiAccountFetch(accountManager, tokenManager);
+        const shutdown = async () => {
+            if (accountManager)
+                await accountManager.shutdown();
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+        log.info("init", "GH-MULTI COPILOT READY");
+    })();
+    return initPromise;
+}
+export const nativeHook = async (input) => {
+    await ensureInitialized(input);
+    return {
+        auth: {
+            provider: "github-copilot",
+            loader: async (getAuth) => {
+                const auth = await getAuth();
+                log.info("GH_MULTI", "[LOADER:github-copilot] Injecting multi-account fetch");
+                const result = typeof auth === 'string' ? { token: auth } : { ...auth };
+                return {
+                    ...result,
+                    fetch: customFetch
+                };
+            }
+        },
+        "chat.headers": async (input, output) => {
+            if (input.model.providerID === "github-copilot") {
+                log.info("GH_MULTI", "[HEADERS:github-copilot] Injecting session ID", {
+                    sessionID: input.sessionID
+                });
+                output.headers["x-session-id"] = input.sessionID;
+            }
+        }
+    };
+};
+export const multiHook = async (input) => {
+    await ensureInitialized(input);
+    return {
+        auth: {
+            provider: "gh-multi",
+            methods: [
+                {
+                    type: "api",
+                    label: "GitHub Copilot Multi-Account",
+                    authorize: async () => {
+                        log.info("auth", "Starting gh-multi authorization flow");
+                        const cli = new CopilotCLI(accountManager);
+                        await cli.showMenu();
+                        const accounts = accountManager.listAccounts();
+                        if (accounts.length === 0) {
+                            return {
+                                type: "failed",
+                                message: "No accounts configured. Please add an account."
+                            };
+                        }
+                        log.info("auth", `Authorization complete. ${accounts.length} account(s) configured.`);
+                        return {
+                            type: "success",
+                            key: "gh-multi-managed",
+                            provider: "gh-multi"
+                        };
+                    }
+                }
+            ],
+            loader: async (getAuth) => {
+                const auth = await getAuth();
+                log.info("GH_MULTI", "[LOADER:gh-multi] Injecting multi-account fetch");
+                return {
+                    ...auth,
+                    fetch: customFetch,
+                    baseURL: "https://api.githubcopilot.com"
+                };
+            }
+        },
+        "chat.headers": async (input, output) => {
+            if (input.model.providerID === "gh-multi") {
+                log.info("GH_MULTI", "[HEADERS:gh-multi] Injecting session ID", {
+                    sessionID: input.sessionID
+                });
+                output.headers["x-session-id"] = input.sessionID;
+            }
+        }
+    };
+};
+export default nativeHook;
+//# sourceMappingURL=index.js.map

package/gh-multi-dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/gh-multi-dist/plugin/accounts.d.ts

@@ -0,0 +1,62 @@
+import { CopilotConfig } from "./config/index.js";
+export interface CopilotAccount {
+    username: string;
+    oauthToken: string;
+    addedAt: number;
+    status: "active" | "rate_limited" | "suspended" | "quota_exhausted";
+    enabled?: boolean;
+    health_score: number;
+    last_error_at?: number;
+    rateLimitedUntil?: number;
+    failureCount?: number;
+    lastUsed?: number;
+    sku?: string;
+    quotaResetDate?: string;
+    lastQuotaSync?: number;
+    premiumRemaining?: number;
+    premiumTotal?: number;
+}
+export declare class CopilotAccountManager {
+    private accounts;
+    private config;
+    private sessionIdToUsername;
+    private sessionCleanupInterval;
+    private dataDir?;
+    private saveTimeout;
+    private quotaSyncInterval;
+    private requestCount;
+    constructor(config: CopilotConfig, dataDir?: string);
+    shutdown(): Promise<void>;
+    private startQuotaSync;
+    stopQuotaSync(): void;
+    private startSessionCleanup;
+    stopSessionCleanup(): void;
+    private cleanupStaleSessions;
+    private syncAllQuotas;
+    private syncQuotaForAccount;
+    hasAccounts(): boolean;
+    hasHealthyAccounts(): boolean;
+    loadAccounts(): Promise<void>;
+    addAccount(oauthToken: string): Promise<CopilotAccount>;
+    refreshAccountInfo(username: string): Promise<CopilotAccount | null>;
+    private requestSave;
+    private saveAccounts;
+    getCurrentOrNext(sessionId?: string, model?: string): Promise<CopilotAccount | null>;
+    private selectAccountByQuota;
+    private selectNextAccount;
+    markQuotaExhausted(account: CopilotAccount): void;
+    markRateLimited(account: CopilotAccount, cooldownMs: number): Promise<void>;
+    markSuccess(account: CopilotAccount, _duration?: number): void;
+    markFailed(account: CopilotAccount, error?: Error, statusCode?: number): void;
+    listAccounts(): CopilotAccount[];
+    updateAccount(username: string, updates: Partial<CopilotAccount>): Promise<void>;
+    toggleAccount(username: string, enabled: boolean): Promise<void>;
+    updateAccountQuota(username: string, quota: {
+        premium: {
+            remaining: number;
+            total: number;
+        };
+        resetDate?: string | null;
+    }): void;
+    removeAccount(username: string): Promise<void>;
+}