clawzembic

# Clawzembic — Weight Loss for Your OpenClaw Instance

**Lighthouse-style audit for OpenClaw efficiency.** Run it, get a grade (A+ to F), shed the bloat.

Scans your installation and scores it across six critical categories: context injection, cron health, session bloat, config health, skill bloat, and transcript size. You get one overall letter grade plus category-by-category breakdown with actionable findings.

**Zero dependencies.** Python 3.8+ stdlib only.

## Quick Start

```bash
# Audit this machine
bash skills/clawzembic/lean-audit.sh

# Audit a remote instance (VM, etc.)
bash skills/clawzembic/lean-audit.sh --remote user@host

# JSON output for dashboards/integrations
bash skills/clawzembic/lean-audit.sh --json

# Show automated fix suggestions
bash skills/clawzembic/lean-audit.sh --fix

# Custom .openclaw directory
bash skills/clawzembic/lean-audit.sh --dir /path/to/.openclaw
```

## What It Checks

| Category | Weight | What Gets Flagged |
|----------|--------|-------------------|
| Context Injection | 25% | Oversized MEMORY.md, bloated workspace files eating tokens |
| Cron Health | 25% | Wrong models, high thinking on routine tasks, main-session pollution |
| Session Bloat | 20% | Stale sessions hogging context, waste ratio above 35% |
| Config Health | 15% | Heartbeat too frequent, subagent defaults, missing compaction |
| Skill Bloat | 10% | Too many skills injected, unused skills inflating system prompt |
| Transcript Size | 5% | Disk hogs, oversized transcripts (>10MB files) |

## Grade Scale

- **A+/A** (90-100): Lean machine 💪
- **B+/B** (75-89): Good shape, minor tweaks
- **C+/C** (60-74): Needs a diet 🍕
- **D+/D** (45-59): Significant bloat 🫠
- **F** (<45): Emergency Clawzembic needed 💊

## Agent Usage

When Jeffrey asks you to audit or optimize an OpenClaw instance:

1. Run `bash skills/clawzembic/lean-audit.sh` (or `--remote user@claudette` for the VM)
2. Review the report and present key findings with context
3. Offer `--fix` mode for auto...

# 💊 Clawzempic

**Weight Loss for Your OpenClaw Instance**

A Lighthouse-style audit for OpenClaw efficiency. Run it, get a grade (A+ to F), and shed the bloat.

## What It Does

Clawzempic scans your OpenClaw installation and scores it across six critical efficiency categories. Think of it as a health checkup for your AI assistant — identifying wasted tokens, bloated sessions, misconfigured crons, oversized context injection, and opportunities to right-size your models.

You get:
- **One letter grade** (A+ to F) summarizing overall health
- **Category-by-category breakdown** with weighted scoring
- **Actionable findings** — exactly what's bloated and why
- **Optional fix mode** — automated remediation suggestions

## Audit Categories

| Category | Weight | What Gets Flagged |
|----------|--------|-------------------|
| **Context Injection** | 25% | Oversized MEMORY.md, bloated workspace files eating tokens on every session init |
| **Cron Health** | 25% | Wrong models (Opus for routine tasks), high thinking on simple jobs, main-session pollution |
| **Session Bloat** | 20% | Stale sessions hogging context, waste ratio, sessions running at 40%+ capacity |
| **Config Health** | 15% | Heartbeat too frequent, subagent defaults, missing compaction/pruning |
| **Skill Bloat** | 10% | Too many skills injected into system prompt, unused skills |
| **Transcript Size** | 5% | Disk hogs, oversized transcripts (>10MB files) |

## Grade Scale

- **A+/A** (90-100): Lean machine 💪
- **B+/B** (75-89): Good shape, minor tweaks
- **C+/C** (60-74): Needs a diet 🍕
- **D+/D** (45-59): Significant bloat 🫠
- **F** (<45): Emergency Clawzembic needed 💊

## Quick Start

```bash
# Audit this machine
bash skills/clawzembic/lean-audit.sh

# Audit a remote instance (VM, etc.)
bash skills/clawzembic/lean-audit.sh --remote user@host

# JSON output for dashboards/integrations
bash skills/clawzembic/lean-audit.sh --json

# Show automated fix suggestions
bash skills/clawzembic/lean-audit.sh --f...