# Agent Usage Optimizer Step 1 Read And Validate Quota Cache

> Sub-skill of agent-usage-optimizer: Step 1 — Read and Validate Quota Cache.

- Skill: `vamseeachanta/agent-usage-optimizer-step-1-read-and-validate-quota-cache` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/agent-usage-optimizer-step-1-read-and-validate-quota-cache`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/agent-usage-optimizer-step-1-read-and-validate-quota-cache/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/agent-usage-optimizer-step-1-read-and-validate-quota-cache

---


# Step 1 — Read and Validate Quota Cache

## Step 1 — Read and Validate Quota Cache


```bash
QUOTA_FILE="$HOME/.cache/agent-quota.json"

# Check cache exists and is fresh (< 1 hour old)
if [[ ! -f "$QUOTA_FILE" ]]; then
  echo "WARN: quota cache not found at $QUOTA_FILE"
  echo "Run: bash scripts/monitoring/query-quota.sh"
  echo "Falling back to default routing rules."
  CACHE_FRESH=false
else
  CACHE_AGE_SECS=$(( $(date +%s) - $(date -r "$QUOTA_FILE" +%s) ))
  if [[ $CACHE_AGE_SECS -gt 3600 ]]; then
    echo "WARN: quota cache is $(( CACHE_AGE_SECS / 60 ))m old — consider refreshing"
    CACHE_FRESH=false
  else
    CACHE_FRESH=true
  fi
fi

# Parse quota values (requires jq)
CLAUDE_PCT=$(jq -r '.agents[] | select(.provider=="Codex") | .pct_remaining' "$QUOTA_FILE" 2>/dev/null || echo 100)
CODEX_PCT=$(jq  -r '.agents[] | select(.provider=="codex")  | .pct_remaining' "$QUOTA_FILE" 2>/dev/null || echo 100)
GEMINI_PCT=$(jq -r '.agents[] | select(.provider=="gemini") | .pct_remaining' "$QUOTA_FILE" 2>/dev/null || echo 100)
CACHE_TS=$(jq  -r '.timestamp' "$QUOTA_FILE" 2>/dev/null || echo "unknown")
```