frank/forgecli
Watch
1
0
Fork
You've already forked forgecli
 0
Code Issues 6 Pull requests 3 Projects Releases 7 Packages Wiki Activity Actions

Agent-Runner: Usage-Limit-Überwachung für Codex und Claude Code #6

New issue
Closed
opened 2026-07-12 09:51:46 +02:00 by frank · 1 comment
frank commented 2026-07-12 09:51:46 +02:00
Owner
Copy link

Ziel

Der Agent-Runner (forge agent watch / forge agent run) soll die Usage-Limits von Codex und Claude Code überwachen. Ist das aktuelle Limit erreicht (z. B. 5h-, 5-Tage-Fenster oder vergleichbare Kontingente), soll der Runner in den Sleep gehen, bis wieder Tokens verfügbar sind.

Motivation

Ohne Limit-Erkennung laufen Agent-Aufrufe gegen erschöpfte Kontingente, scheitern oder verbrauchen unnötig Retries. Stattdessen soll der Runner pausieren und periodisch prüfen, ob wieder Kapazität vorhanden ist.

Anforderungen

Überwachte Agents

  • Codex
  • Claude Code (claude CLI)

Verhalten bei erreichtem Limit

  • Erkennung, dass das aktuelle Usage-Limit (5h, 5 Tage o. Ä.) erschöpft ist
  • Agent-Runner wechselt in Sleep/Pause und startet keine neuen Agent-Läufe
  • Periodische Überprüfung alle 1–5 Minuten, ob wieder Tokens/Kontingent verfügbar sind
  • Sobald Kapazität wieder da ist: normaler Betrieb fortsetzen

Erwartetes Verhalten

  1. Limit erreicht → Runner pausiert (kein Dispatch neuer Issues an den betroffenen Agent)
  2. Alle 1–5 Minuten Status prüfen
  3. Limit wieder frei → Watch/Run-Loop fortsetzen

Offene Punkte / Klärung

  • Wie melden Codex bzw. Claude Code Limit-Erschöpfung (Exit-Code, stderr-Muster, Status-Befehl)?
  • Gemeinsames Poll-Intervall konfigurierbar machen (Default im Bereich 1–5 min)?
  • Pro Agent getrennt pausieren, falls nur einer am Limit ist?

Akzeptanzkriterien

  • Bei erkanntem Usage-Limit startet der Runner keine weiteren Agent-Jobs für den betroffenen Provider
  • Während der Pause erfolgt eine Überprüfung im Intervall 1–5 Minuten
  • Nach freiem Kontingent nimmt der Runner den Normalbetrieb wieder auf
  • Codex und Claude Code sind abgedeckt
## Ziel Der Agent-Runner (`forge agent watch` / `forge agent run`) soll die Usage-Limits von **Codex** und **Claude Code** überwachen. Ist das aktuelle Limit erreicht (z. B. 5h-, 5-Tage-Fenster oder vergleichbare Kontingente), soll der Runner in den Sleep gehen, bis wieder Tokens verfügbar sind. ## Motivation Ohne Limit-Erkennung laufen Agent-Aufrufe gegen erschöpfte Kontingente, scheitern oder verbrauchen unnötig Retries. Stattdessen soll der Runner pausieren und periodisch prüfen, ob wieder Kapazität vorhanden ist. ## Anforderungen ### Überwachte Agents - [x] Codex - [x] Claude Code (`claude` CLI) ### Verhalten bei erreichtem Limit - [ ] Erkennung, dass das aktuelle Usage-Limit (5h, 5 Tage o. Ä.) erschöpft ist - [x] Agent-Runner wechselt in Sleep/Pause und startet keine neuen Agent-Läufe - [x] Periodische Überprüfung alle **1–5 Minuten**, ob wieder Tokens/Kontingent verfügbar sind - [x] Sobald Kapazität wieder da ist: normaler Betrieb fortsetzen ### Erwartetes Verhalten 1. Limit erreicht → Runner pausiert (kein Dispatch neuer Issues an den betroffenen Agent) 2. Alle 1–5 Minuten Status prüfen 3. Limit wieder frei → Watch/Run-Loop fortsetzen ## Offene Punkte / Klärung - Wie melden Codex bzw. Claude Code Limit-Erschöpfung (Exit-Code, stderr-Muster, Status-Befehl)? - Gemeinsames Poll-Intervall konfigurierbar machen (Default im Bereich 1–5 min)? - Pro Agent getrennt pausieren, falls nur einer am Limit ist? ## Akzeptanzkriterien - Bei erkanntem Usage-Limit startet der Runner keine weiteren Agent-Jobs für den betroffenen Provider - Während der Pause erfolgt eine Überprüfung im Intervall 1–5 Minuten - Nach freiem Kontingent nimmt der Runner den Normalbetrieb wieder auf - Codex und Claude Code sind abgedeckt
frank commented 2026-07-12 10:12:09 +02:00
Author
Owner
Copy link

🤖 forge agent started

  • Agent: cursor-agent
  • Model: (default)
  • Mode: pr
  • Trigger: assignee=agent
  • Open ToDos: 6

Agent-Runner: Usage-Limit-Überwachung für Codex und Claude Code — Der Agent-Runner (forge agent watch / forge agent run) soll die Usage-Limits von Codex und Claude Code überwachen. Ist das aktuelle Limit erreicht (z. B. 5h-, 5-Tage-Fenster oder…

🤖 **forge agent started** - Agent: `cursor-agent` - Model: `(default)` - Mode: `pr` - Trigger: `assignee=agent` - Open ToDos: 6 Agent-Runner: Usage-Limit-Überwachung für Codex und Claude Code — Der Agent-Runner (`forge agent watch` / `forge agent run`) soll die Usage-Limits von **Codex** und **Claude Code** überwachen. Ist das aktuelle Limit erreicht (z. B. 5h-, 5-Tage-Fenster oder…
frank closed this issue 2026-07-12 10:26:34 +02:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
agent/issue-68-all-repos-filter-allowlist-owner-org-pat
agent/issue-67-all-repos-eigenes-refresh-intervall-api
agent/issue-69-doku-unattended-server-daemon-systemd-cr
agent/issue-56-agent-user-mapping-zusätzliche-user-üb
agent/issue-59-strukturelle-analyse-der-codebase
agent/issue-36-agent-config-mode-für-aktuelles-verzeic
0.10.0
0.9.0
0.8.0
0.7.0
0.6.0
0.5.0
0.4.0
0.3.3
0.3.2
0.3.1
0.3.0
0.2.0
0.1.0
Labels
Clear labels   
agent:done
Managed by forge agent

  
agent:ready
Managed by forge agent

  
agent:working
Managed by forge agent

  
enhancement
New feature or request

No labels
agent:done
agent:ready
agent:working
enhancement
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
agent
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
frank/forgecli#6
No description provided.