Lemnos Cost Guard

Track token usage, enforce budgets, detect context bloat, and route to cheaper models.

Quick Reference

Script	Purpose
`scripts/track_cost.py`	Log a cost entry after a task
`scripts/cost_report.py`	Generate cost summary
`scripts/context_analyzer.py`	Scan workspace for bloat

Pricing and model routing rules: references/model_pricing.md

Workflow

After Every Significant Task

Log cost immediately using session delta (session_status before vs after):

python3 skills/lemnos-cost-guard/scripts/track_cost.py \
  --task "email batch" \
  --input 45000 \
  --output 1200 \
  --model claude-sonnet-4-6

Logs to: logs/cost-YYYY-MM-DD.jsonl

Daily Briefing — Cost Summary Block

Run before sending the morning briefing:

python3 skills/lemnos-cost-guard/scripts/cost_report.py --days 1 --budget 5.00 --format brief

Include output verbatim in briefing. Flag anything over 80% of budget.

Budget Alerts

≥80% of $5/day → warn Nick, pause non-revenue tasks
≥100% of $5/day → hard stop, notify Nick immediately
Single call >500K input tokens → immediate alert
I/O ratio >50:1 → context bloat warning, recommend compaction

Context Bloat Check (run weekly or when costs spike)

python3 skills/lemnos-cost-guard/scripts/context_analyzer.py \
  --workspace /root/.openclaw/workspace

Context Loading Rules (enforce on every session)

Load ONLY what the current task requires:

Task	Load
Morning briefing	SOUL.md, USER.md, MEMORY.md, HEARTBEAT.md, today's memory
Email outreach	MEMORY.md (Lemnos rules only), sent-log.md
LinkedIn research	sent-log.md only
Crypto/market	MEMORY.md (crypto section only)
Heartbeat (nothing to do)	HEARTBEAT.md only

Do NOT load full MEMORY.md + all skills + all reference files unless the task requires it.

Model Routing

See references/model_pricing.md for full table. Quick rules:

Simple tasks (format, classify, status check) → Haiku ($0.80/M input)
Default → Sonnet ($3/M input)
Opus → never, unless explicitly requested

Cost Log Format

Each entry in logs/cost-YYYY-MM-DD.jsonl:

{
  "ts": "2026-02-24T18:00:00Z",
  "task": "email batch send",
  "model": "claude-sonnet-4-6",
  "input_tokens": 45000,
  "output_tokens": 1200,
  "ratio": 37.5,
  "cost_usd": 0.153,
  "notes": "batch 1 + batch 2"
}

ClawHub Distribution

Free tier: daily cost tracking + budget alerts Premium ($40-60/mo): full dashboards, model routing automation, context optimization reports, weekly/monthly rollups

Skill file: lemnos-cost-guard.skill