Lists your newest events: the client, how the iteration ended, the minutes and the share of the usage window it used as the client reported it. An event holds no prompt, code or output.
Usage
overlane usage events showExamples
overlane usage events showBehavior
- Effect:
read(changes nothing). - Needs credentials: yes. Uses the network: yes.
- Supports
--dry-run: no. Accepts--force: no. - Machine-readable description:
overlane schema usage events show.
Result
With --json (the default when stdout is not a terminal) the command prints this JSON Schema’s shape on stdout.
{
"type": "object",
"properties": {
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"eventId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"executor": {
"type": "string",
"enum": [
"claude-code",
"codex",
"gemini-cli",
"cursor"
]
},
"outcome": {
"type": "string",
"enum": [
"verified",
"pending",
"quota",
"failed",
"no_progress"
]
},
"minutes": {
"type": "number",
"minimum": 0
},
"spendPercent": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"resetsAt": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
{
"type": "null"
}
]
},
"recordedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"shared": {
"type": "boolean"
}
},
"required": [
"eventId",
"executor",
"outcome",
"minutes",
"spendPercent",
"resetsAt",
"recordedAt",
"shared"
],
"additionalProperties": false
}
}
},
"required": [
"events"
],
"additionalProperties": false
}See exit codes for the status the process returns.