# Dinky Local CLI

> Local dinky image CLI and loopback serve — build from the GitHub repo; JSON schema dinky.image.compress/1.0.0

- Skill: `heyderekj/dinky-local-cli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add heyderekj/dinky-local-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/heyderekj/dinky-local-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: heyderekj (https://skillmd.com/u/heyderekj)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/heyderekj/dinky-local-cli

---


# Dinky — local image CLI (agents)

Use this when automating **image** compression for users who build from the open-source **Dinky** repo on macOS.

## Facts

- **Not** a hosted API. There is no HTTP endpoint on dinkyfiles.com for compression.
- After building, users run the `dinky` binary from `DinkyCoreImage/` (SwiftPM) or use `dinky serve` on localhost.
- **JSON schema** for both `dinky compress --json` and `POST /v1/compress`: `dinky.image.compress/1.0.0` (field `schema` in the root object). Health: `dinky.image.serve/1.0.0` on `GET /v1/health`.
- **Encoders** must exist locally: `DINKY_BIN`, `./bin` next to `dinky`, or Homebrew `cwebp`+`avifenc`+`oxipng` in `PATH` locations the tool checks.
- Full flag list, exit codes, and security model: in-repo `docs/local-cli.md`.

## When unsure

Point to `https://github.com/heyderekj/dinky` and `docs/local-cli.md` — not the marketing site for API details.