Cockpit Tools

repository·main·Indexed 9 days ago

https://github.com/jlcodes99/cockpit-tools

A universal management utility for AI IDE accounts (v1.3.16) that enables account switching, quota monitoring, and parallel instance execution for services including GitHub Copilot, Cursor, Windsurf, Trae, and Grok CLI. It features a CLI Proxy API for providing compatible interfaces for OpenAI, Gemini, Claude, and Grok, supporting load balancing and OAuth login across multiple accounts.

Tokens
98.6K
Snippets
359
Records
610
Agent score
97%

What's inside Cockpit Tools

  1. Overview of CLI Proxy API

    main

    CLI Proxy API is a proxy server designed to provide compatible API interfaces for CLI tools. It allows users to use local or multi-account access for various AI models through OpenAI, Gemini, Claude, and Grok compatible clients and SDKs.

    Key Capabilities:

    • Compatibility: Supports OpenAI, Gemini, Claude, and Grok compatible endpoints.
    • OAuth Support: Enables OpenAI Codex (GPT models), Claude Code, and Grok Build via OAuth login.
    • Load Balancing: Provides round-robin load balancing across multiple accounts for Gemini, OpenAI, Claude, and Grok.
    • Advanced Features: Supports streaming, non-streaming, WebSocket responses, function calling/tools, and multimodal input (text and images).
    • Routing: Supports Amp CLI and IDE extensions with provider routing and model mapping (e.g., routing claude-opus-4.5 to claude-sonnet-4).
    • Extensibility: Reusable Go SDK for embedding the proxy and support for OpenAI-compatible upstream providers (like OpenRouter) via configuration.
  2. Overview of Cockpit Tools

    main

    Cockpit Tools is a universal account management tool designed for AI IDEs. It enables users to efficiently manage multiple AI IDE accounts by providing features such as one-click account switching, quota monitoring, automatic task awakening, and support for running multiple instances of applications in parallel. This allows users to maximize the resources available across different service accounts.

    Supported AI IDEs and Services

    The tool currently supports a wide range of platforms, including:

    • Antigravity IDE
    • Codex
    • GitHub Copilot
    • Windsurf
    • Kiro
    • Cursor
    • Grok CLI
    • CodeBuddy (including CodeBuddy CN)
    • Qoder
    • Trae (including Trae Solo, Trae CN, Trae Solo CN)
    • Zed
    • ZCode

    Key Features

    • One-click Account Switching: Quickly toggle between different service accounts.
    • Multi-account Management: Organize and maintain multiple credentials.
    • Application Multi-opening: Run multiple instances of the same application in parallel.
    • Quota Monitoring: Track the remaining usage/quota for your accounts.
    • Awakening Tasks: Automate processes to keep accounts active.
    • Plugin Linkage: Integrate with various plugins for enhanced functionality.
  3. Overview of CLIProxyAPI

    main

    CLIProxyAPI is a proxy server that provides OpenAI, Gemini, Claude, Codex, and Grok compatible API interfaces specifically designed for CLI tools. It allows users to use local or multi-account CLI setups by accessing them through any client or SDK compatible with OpenAI (including Responses), Gemini, or Claude.

    Key capabilities include:

    • OAuth Support: Access to OpenAI Codex (GPT series), Claude Code, and Grok Build via OAuth login.
    • Multi-Account Management: Supports multi-account polling and load balancing for Gemini, OpenAI, Claude, and Grok.
    • Advanced Features: Supports streaming, non-streaming, and WebSocket responses; function calling/tool use; and multimodal input (text and images).
    • Flexible Routing: Supports Gemini AIStudio API keys and allows connecting to upstream OpenAI-compatible providers (e.g., OpenRouter) via configuration.
  4. Overview of Cockpit Tools features

    main

    Cockpit Tools is a management suite for AI-powered IDEs and CLI tools. It provides a centralized dashboard to monitor account statuses, quotas, and reset times across sixteen different platforms.

    Key capabilities include:

    • Dashboard: Real-time quota monitoring and quick actions (refresh/wake-up) for platforms like Antigravity IDE, Codex, GitHub Copilot, Windsurf, Kiro, Cursor, Grok CLI, CodeBuddy, Qoder, Trae, Zed, and ZCode.
    • Account Management: Support for multiple import methods (OAuth, Refresh Token, JSON, local state) and batch operations (tags, bulk actions, export).
    • Multi-Instance Support: The ability to run multiple isolated instances of supported tools (e.g., Cursor, Windsurf, Grok CLI) by using separate user data directories, custom instance directories, and isolated launch arguments. This allows handling different projects with different accounts simultaneously.
    • Switch Injection: For many supported clients (Windsurf, Kiro, Cursor, CodeBuddy, Qoder, Trae, Zed), Cockpit can automatically inject the selected account credentials into the official client and launch it.
  5. Ecosystem and Integrations for CLIProxyAPI

    main

    CLIProxyAPI is a core component used by a wide variety of third-party tools to enable AI coding assistants (like Claude Code, Cursor, and Gemini CLI) to work using existing LLM subscriptions (ChatGPT, Claude, Gemini, etc.) without requiring manual API keys.

    Key categories of integrated tools include:

    • Desktop & Menu Bar Apps: Tools like vibeproxy, Quotio, CodMate, ProxyPilot, ZeroLimit, 霖君, and ProxyPal provide native GUIs (macOS, Windows, Linux) for managing subscriptions, tracking quotas, and providing one-click proxy control.
    • VSCode Extensions: Claude Proxy VSCode allows for quick switching between Claude Code models via the CLIProxyAPI backend.
    • Management & Dashboards: CPA-XXX Panel, CLIProxyAPI Dashboard, and All API Hub provide web-based administration, real-time log streaming, usage analytics, and API key management.
    • CLI & TUI Tools: CCS (Claude Code Switch) and CodexCliPlus focus on command-line account switching and runtime management.
    • Monitoring & Inspection: CLIProxyAPI Quota Inspector and CLIProxy Pool Watch provide real-time visibility into account quotas (e.g., 5-hour and weekly windows) and account availability.
    • Alternative Implementations/Ports: Projects like 9Router, OmniRoute, and Playful Proxy API Panel (PPAP) are inspired by or compatible with the CLIProxyAPI architecture, offering features like smart routing, load balancing, and OpenAI-compatible endpoints.
  6. Supported Platforms and Languages for Cockpit Tools

    main

    Cockpit Tools is cross-platform and supports a wide variety of international users.

    Supported Operating Systems

    • macOS
    • Windows
    • Linux

    Supported Languages

    The interface supports 18 languages, including English, Simplified Chinese, Traditional Chinese, Japanese, German, Spanish, French, Italian, Korean, Portuguese, Russian, Turkish, Polish, Czech, Arabic, Vietnamese, and Indonesian.

  7. Explore projects built on CLIProxyAPI

    main

    CLIProxyAPI serves as a foundation for a wide ecosystem of tools designed to manage AI subscriptions (Claude Code, ChatGPT, Gemini, Codex, etc.) without requiring manual API keys. These projects range from desktop GUI wrappers and VSCode extensions to management dashboards and CLI tools.

    Key Categories of CLIProxyAPI Projects:

    • Desktop GUI & Menu Bar Apps: Tools like vibeproxy (macOS), CodMate (macOS), ProxyPilot (Windows), ZeroLimit (Windows), LinJun (Cross-platform), and ProxyPal (Cross-platform) provide native interfaces for managing accounts, monitoring quotas, and switching providers.
    • Management Dashboards: CPA-XXX Panel (Web management), CLIProxyAPI Dashboard (Next.js/React dashboard), and All API Hub (Browser extension) offer real-time logs, usage statistics, and configuration management.
    • Developer Tools & Extensions: Claude Proxy VSCode (VSCode extension for switching models) and CCS (Claude Code Switch) (CLI wrapper for switching accounts/models).
    • Monitoring & Inspection: CLIProxyAPI Quota Inspector and CLIProxy Pool Watch focus on real-time quota tracking (e.g., 5h/7d limits) and account availability.
    • Routing & Gateways: 9Router and OmniRoute provide smart routing, automatic fallback, and load balancing across multiple LLM providers using OpenAI-compatible endpoints.
  8. Supported Platforms and Languages

    main

    Supported Platforms

    Cockpit Tools is officially compatible with:

    • macOS
    • Windows
    • Linux

    Supported Languages

    The interface supports 18 languages, including English, Simplified Chinese, Traditional Chinese, Japanese, German, Spanish, French, Italian, Korean, Portuguese, Russian, Turkish, Polish, Czech, Arabic, Vietnamese, and Indonesian.

  9. Understand Cockpit Tools security and data storage

    main

    Cockpit Tools is a local desktop tool designed to manage accounts without relying on a centralized cloud for your credentials.

    Data Storage Locations

    • ~/.antigravity_cockpit: Antigravity IDE accounts, configurations, and WebSocket status.
    • ~/.codex: Codex official auth.json.
    • ~/.grok: Grok CLI official instance and auth.json.
    • ~/.zcode/v2: ZCode encrypted credentials and quota cache.
    • System Local App Data Directory (com.antigravity.cockpit-tools): Stores multi-account data for Codex, GitHub Copilot, Windsurf, Kiro, Cursor, Grok CLI, CodeBuddy, Qoder, Trae, Zed, and ZCode.

    Security Notes

    • Grok CLI Credentials: Access and refresh tokens are stored in plain text JSON. Security relies on OS-level user isolation and file permissions (0700 for directories, 0600 for files on Unix).
    • WebSocket Security: By default, the WebSocket service listens only on 127.0.0.1 (localhost).
    • macOS Permissions: If an agent (e.g., Codex) executes shell commands that access protected folders (Desktop, Documents, etc.), macOS may attribute the permission request to "Cockpit Tools". This is because the agent is a child process of the main application.
  10. Understand Windsurf Credit semantics

    main

    In version 0.8.10, the interpretation of Windsurf credits changed to align with monthly quota semantics.

    • availablePromptCredits and availableFlexCredits are now interpreted as monthly total quotas.
    • Remaining balance is calculated as: total - used.
  11. Monitor Codex API Usage and Costs

    main

    The Codex API service includes built-in usage statistics and cost estimation.

    Features:

    • Model Pricing: Supports price presets for current Codex models (including gpt-5.5). Users can manually edit custom USD / 1M tokens prices on the model page.
    • Cost Tracking: The service saves a price snapshot for every request. Total overview, account-level, and model/key-level statistics display estimated USD value based on input/output/cache usage.
    • Error Classification: Usage statistics distinguish between successful requests, failures, client cancellations, and stream_incomplete (cases where the stream ended without a completion event or due to an EOF error).
  12. macOS: IDE launch attribution and permissions

    main

    On macOS, Cockpit Tools launches IDEs (Codex, VS Code, CodeBuddy) using the open -a (LaunchServices) method rather than executing binaries directly.

    Benefit: This ensures that macOS TCC permission prompts (e.g., "Allow app to access the Downloads folder") are correctly attributed to the target IDE instead of Cockpit Tools.