lvrged

Reduce an image's vision-token cost under a hard budget. Get back a CDN URL for the reduced copy and the exact token count. CLI for the lvrged / syndicate API.

npx lvrged reduce photo.jpg --json
npx lvrged reduce --url https://example.com/big.jpg --max-tokens 10 --json
lvrged auth show

First run auto-provisions an anonymous key into ~/.config/lvrged/config.json. No signup required.

Flags (reduce)

| flag | default | notes | |---|---|---| | --max-tokens <n> | 10 | soft-token budget (1–256) — match your encoder | | --patch-size <n> | 16 | encoder patch size in px | | --pool <n> | 3 | pooling kernel size | | --format <fmt> | jpeg | jpeg | webp | png | | --url <https://…> | — | fetch edge-side, skip your uplink | | --json | off | machine-readable stdout (agents: always use) | | --base-url <url> | https://api.lvrged.dev | override API base |

Exit codes

0 ok · 1 API error · 2 validation · 3 auth/quota

Onboarding an agent

Paste the repo's AGENT.md into any assistant — it installs this CLI, offers a before/after token comparison, and shows the savings.

License: MIT