Nib turns an idea — or a whole article — into original, white-background, hand-drawn editorial illustrations that all star one character you own. One image, one idea. The character performs the idea; it never just sits there. Because it's sent as the reference on every generation, it stays on-model across an entire piece.
Same character, three looks — and it didn't drift.
nib.henryzh.dev · Free & open source · MIT
Install the skill into your agent — one command, no app to download:
| Agent | Command |
|---|---|
| Claude Code | npx skills add caezium/nib --skill nib |
| Codex CLI | codex plugin add caezium/nib |
| Cursor | Add plugin: caezium/nib |
| Gemini CLI | gemini extensions install caezium/nib |
Then just ask:
Use nib to illustrate: "small habits compound into a big result"
Use nib to make a 5-image set in riso for this article: https://paulgraham.com/ds.html
Use nib: set my avatar to ./avatar.png, then illustrate "saying no protects focus" in woodcut
- Free — use your ChatGPT / Codex subscription. If you're logged into the Codex CLI
(
codex login), Nib generates on your existing subscription. No API key, no per-image charge. - OpenRouter — a few cents an image. Set
OPENROUTER_API_KEYand Nib usesgoogle/gemini-2.5-flash-image(or any image model via--model). Exact 16:9. A whole blog post for under a dollar.
It picks automatically: your OpenRouter key if set, else the free Codex lane.
Don't have a mascot? Use a bundled character:
Use nib with the "blip" character to illustrate "ship small, ship often"
The skills/nib/characters/ library ships ready-to-use
characters (and PRs adding your own are welcome — a character is just a folder with a
one-paragraph spec + a reference image). Or bring your own avatar image, and optionally
describe it in words (--avatar-spec) to lock its design even tighter.
- A character — your avatar image, a bundled pack, or a written description. It's the reference on every render, so it stays recognizable.
- An idea or an article. A URL is fetched and reduced to clean text first. For an article, Nib picks the load-bearing moments (a judgment, a flow, a before/after, a trap, a loop) — 4–8 of them, not one image per paragraph.
- A fresh, concrete metaphor in which the character performs the idea — pushes it, sorts it, steers it, builds it.
- Generate, reviewing each against the quality bar (white background, one idea, the character performing the action, short labels only).
The methodology and the seven looks live in one place — skills/nib/references/ — read by
both the skill engine and the desktop app, so they never drift.
marker · riso · blueprint · woodcut · pixel · clay · gouache — one per piece,
so a set reads as a series. See references/styles.md.
python3 skills/nib/scripts/generate.py \
--idea "trust is built one piece of evidence at a time" \
--style marker --avatar ./avatar.png --out out.pngFlags: --backend auto|openrouter|codex · --model <id> · --avatar-pack <name> ·
--avatar-spec "<text>". Dependency-free (python3 only).
A TypeScript + React desktop app (macOS) — avatar onboarding, a style picker, generation history, and a zoomable lightbox.
Install (macOS, Apple Silicon):
brew install --cask caezium/tap/nibThis is a self-signed pre-1.0 build, so the cask clears the Gatekeeper quarantine flag on
install. If macOS still blocks it, right-click the app and choose Open. Or grab the
.dmg straight from Releases.
Run from source:
npm install && npm run gen # first time
npm run dev # real generation (OpenAI or OpenRouter key)
npm run dev:mock # placeholder images, no API calls
npm run build # package the appThe desktop app sends anonymous usage events (which mode/style, success/failure) and crash reports — never your prompts, avatar, API keys, or images. Turn it off in Settings → Telemetry. The skill sends no telemetry.
Nib's house methodology is adapted from xiaohei (小黑) by helloianneo — the hand-drawn editorial-illustration skill that inspired this project. Nib reimplements its approach in its own words and code.
MIT © 2026 Henry (caezium).