Skip to content

v1.4.0

Choose a tag to compare

@manufosela manufosela released this 25 Mar 19:10

What's New

Rate Limit Detection

When a CLI agent (Claude, Codex, Gemini, Aider) hits its usage cap during a pipeline run, Karajan now detects the rate limit automatically and pauses the session instead of marking it as failed. Resume when the token window resets:

kj resume --session <session-id>

Auto-Fallback to Available Agent

Configure a fallback agent so the pipeline continues uninterrupted when the primary agent is rate-limited:

coder_options:
  fallback_coder: codex   # Switch to Codex if Claude hits its limit

Or per-run: kj run "Task" --coder-fallback codex

If all agents are rate-limited, the session pauses for manual resume.

Changes

  • src/utils/rate-limit-detector.js — pattern matching for rate limit messages from all supported agents
  • src/orchestrator/agent-fallback.js — fallback orchestration utility with checkpoint tracking
  • src/orchestrator/iteration-stages.js — rate limit detection + fallback integration in coder/refactorer/reviewer stages
  • src/orchestrator.js — handle pause action from stages
  • src/config.jsfallback_coder config option
  • src/cli.js--coder-fallback CLI flag
  • 26 new tests across 3 test files

Full Changelog: v1.3.0...v1.4.0