Feature Request: Add Command to Check Synthetic Provider Subscription Status

[diegonix]

Feature Request: Add Command to Check Synthetic Provider Subscription Status

Description The Synthetic LLM provider exposes an endpoint to check the current subscription quota and renewal status:

GET https://api.synthetic.new/v2/quotas

Example Response

{
  "subscription": {
    "limit": 135,
    "requests": 28.55,
    "renewsAt": "2025-10-27T02:01:31.030Z"
  }
}

This endpoint provides useful information about the current usage limit, remaining requests, and renewal time.

Proposed Feature Add a new command in Code Puppy to easily check this subscription status directly from the CLI.

Possible Command Options

• /status → show provider status if only one LLM provider is configured
• /provider synthetic status → explicitly query the Synthetic provider’s status

Example CLI Output

┌─────────────────────────────────────────────┐
│ Provider      : Synthetic                   │
│ Requests used : 28.55 / 135                 │
│ Renews at     : 2025-10-27 02:01 UTC        │
└─────────────────────────────────────────────┘

Implementation Notes

• Make an authenticated GET request to https://api.synthetic.new/v2/quotas
• Parse and display the values in a user-friendly format
• Handle API or network errors gracefully

Optional Enhancement Optionally, the same API could be called automatically after the model finishes processing a task, providing near real-time feedback on subscription usage directly in the CLI output.

Why It’s Useful

• Provides visibility into current API usage and limits
• Helps prevent unexpected failures due to quota exhaustion
• Useful for users running multiple agents or long-running tasks