observability

Use when checking server health, viewing context window usage, or managing async runs

Stars 41

Forks 4

Install this agent skill to your Project

npx add-skill https://github.com/nouamanecodes/lettactl/tree/main/.skills/observability

SKILL.md

Entry Points

src/commands/health.ts - Server health check
src/commands/context.ts - Context window analysis
src/commands/runs.ts - Async job management

Commands

bash

# Health check
lettactl health [-q] [-v]

# Context usage
lettactl context <agent> [-o table|json|yaml]

# Async runs
lettactl runs <agent> [--limit <n>] [--status pending|running|completed|failed] [-o table|json]

Key Types

typescript

ContextUsage {
  total_tokens: number
  max_tokens: number
  usage_percent: number
  breakdown: { system_prompt, memory_blocks, tool_definitions, conversation: number }
}

Run {
  id: string
  status: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled'
  created_at: string
  completed_at?: string
}

Examples