usage

Documentation

Overview

Package usage provides access to the Anthropic quota usage API.

Index

• Variables
• func CountCompactions(transcriptPath string) int
• func FormatQuotaWindow(win *QuotaWindow, label string) string
• type Data
  • func Fetch() (*Data, error)
  • func ParseBody(body []byte) (*Data, error)
• type ExtraUsage
• type QuotaWindow

Variables

var CachePath = "/tmp/claude-usage-cache.json"

CachePath is the path to the usage cache file. Replaceable for testing.

var CacheTTL = 60 * time.Second

CacheTTL is the cache duration for usage data. Configurable at startup.

var HTTPGetFn httpclient.GetFn = httpclient.Get

HTTPGetFn is the function used for HTTP requests. Replaceable for testing.

Functions

func CountCompactions

func CountCompactions(transcriptPath string) int

CountCompactions counts compact_boundary entries in a session transcript JSONL.

func FormatQuotaWindow

func FormatQuotaWindow(win *QuotaWindow, label string) string

FormatQuotaWindow formats a single quota window for display.

Types

type Data

type Data struct {
	FiveHour  *QuotaWindow
	SevenDay  *QuotaWindow
	Extra     *ExtraUsage
	ErrorType string
}

Data is the parsed response from Anthropic usage API.

func Fetch

func Fetch() (*Data, error)

Fetch retrieves quota usage from Anthropic API (with caching).

func ParseBody

func ParseBody(body []byte) (*Data, error)

ParseBody parses the usage API response body.

type ExtraUsage

type ExtraUsage struct {
	MonthlyLimit float64
	UsedCredits  float64
}

ExtraUsage represents monthly extra/overuse budget.

type QuotaWindow

type QuotaWindow struct {
	Utilization      float64
	ResetsAt         time.Time
	TotalMinutes     int
	RemainingMinutes int
}

QuotaWindow represents a single usage quota window (5-hour or 7-day).