Feature: per-agent usageCommand in acpClients to surface subscription plan quota
- Lenguaje dominante
- Rust
- Estrellas
- 2.3k
- Forks
- 231
- Merge medio
- 2 h 46 min
- PR fusionados (30 d)
- 577
Descripción
## Context
ACP has no concept of **plan quota** (limits, reset windows, burn-down). Subscription-backed CLIs — Claude Max, Codex (ChatGPT), Kimi coding plan, GLM coding plan — each expose their remaining usage through their own CLI commands or account endpoints, none of which is visible inside BitFun. When orchestrating a fleet of subscription CLIs as ACP agents, the orchestrator currently has no way to see which agent's plan is nearly exhausted before dispatching work.
## Proposal
Add an optional field on each `acpClients` entry, for example:
```json
{
"kimi": {
"command": "kimi",
"args": ["acp"],
"usageCommand": "kimi usage --json",
"usageIntervalMinutes": 30
}
}
```
- `usageCommand`: a shell command whose (text or JSON) output represents that agent's remaining quota
- BitFun runs it on demand (button on the agent card / ACP settings row) and/or on a refresh interval, parses, and displays the result next to the agent
This keeps quota semantics out of the ACP protocol (where they don't belong) while making them visible exactly where dispatch decisions are made.
## Use case
Multi-agent orchestration over subscription CLIs: check remaining quota per agent before assigning a long-running task, and avoid routing work to an agent whose plan window is exhausted.
Guía de contribución
Línea de trabajo
Start by locating the acpClients configuration, the ACP agent card/settings row, and the existing command execution or refresh paths. Trace how an agent's configuration reaches the UI; done means an optional usageCommand and interval can be configured per agent, invoked on demand or during refresh, and its text or JSON result is displayed without changing the ACP protocol.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Stack tecnológico
- rust
- Área
- backend, desktop
- Tipo de issue
- Nueva funcionalidad
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Estado de actividad
- Activo
- Claridad
- Bastante claro
- Aptitud para principiantes
- 45/100