Skip to content

[Feature]: Add a lightweight command-line interface #57

Description

@AlexanderLanin

Before submitting

  • I searched existing issues and pull requests for a similar request.

Problem

OpenQuota is very useful for consolidating quotas and usage across AI coding providers, but it currently requires opening the desktop dashboard. This makes it difficult to use from a terminal, shell scripts, CI-style checks, headless environments, or lightweight Linux setups where installing or running a desktop UI is undesirable.

Proposed solution

Please consider adding an optional, lightweight CLI interface that reuses the existing provider integrations and local data, for example:

openquota status
openquota status --provider codex
openquota status --json
openquota providers

The default output could be concise and human-readable, showing current quota usage, reset times, today's usage, and errors. A --json option would make the output useful for scripts. Ideally, the CLI would:

  • use the same local credentials and cache as the desktop app;
  • avoid opening a window or requiring a running GUI session;
  • return meaningful exit codes when a provider cannot be refreshed;
  • support a cached or offline mode to avoid network requests.

A separate executable or a subcommand of the installed OpenQuota binary would both be reasonable implementation options. It would be helpful if release artifacts exposed the CLI so users did not need to install the full development toolchain.

Provider

Not provider-specific.

Platforms

All supported platforms

Alternatives or additional context

A CLI could complement the existing tray/dashboard experience rather than replace it. The first useful milestone could be read-only status output; configuration commands could remain out of scope initially.

Thanks for considering this!

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions