Customizable Claude Code statusline with rate-limit curves, context bar, and git info
Three read-only tools with basic descriptions but significant gaps in schema documentation and parameter clarity. Tool names lack action verbs (context_usage, rate_limits, session_summary are nouns). Input schemas visible but minimal, session_id parameters lack type constraints and validation guidance. Descriptions are adequate (100-150 chars) but do not explain when to use each tool vs. alternatives or what downstream operations they enable. No output schemas documented. Error handling absent.
Current context window usage for a Claude Code session. Reads cc-statusline's persisted state. Returns the latest segment peak, total across all compaction segments, and percent of window + usable budget.
Latest known Claude Code rate-limit snapshot (5-hour and 7-day windows). Shared across all sessions; whichever session last fired the statusline wrote these numbers.
One-shot bundle of context_usage + rate_limits for a session.
Tool names are nouns, not action verbs. 'context_usage', 'rate_limits', 'session_summary' do not start with get_, list_, or describe_. LLMs infer intent from verb-first names; noun-only names are ambiguous.
No output schemas documented. LLMs cannot plan downstream operations or extract fields without knowing the response structure. Descriptions mention 'returns' but do not specify field names, types, or nesting.
session_id parameter lacks validation guidance. Description says 'Optional. If omitted, the most-recently-updated session is used' but does not specify format (UUID? hex string?), length, or examples. LLMs cannot validate input.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 49 | 2026-07-28+ | v2 |
No error handling documented. What happens if session_id is invalid? If state file is missing? If rate limits have never been recorded? LLMs have no recovery guidance.
Tool descriptions do not explain when to call each tool vs. alternatives. Why call context_usage instead of session_summary? When is rate_limits useful alone? Disambiguation is missing.