v0.5.0 — Gemini 3.x models + naba skills/doctor
Modernizes naba's Gemini model usage and adds binary-embedded skill lifecycle and health commands.
Highlights
- Current GA models. Default model is now
gemini-3.1-flash-image(the priorgemini-2.0-flash-exp-image-generationwas retired upstream and broke fresh installs).gemini-3-pro-imageis available as a higher-quality tier. - Quality & imageConfig flags.
--quality {fast,high}(model alias) and--aspect/--resolution(GeminiimageConfig) on all generative commands. Resolution precedence:--model>--quality> configmodel> configquality> built-in default. New config keys:aspect,resolution,quality. Invalid aspect/resolution values are rejected client-side. naba skills. New command group —install/upgrade/remove/status— that deploys the Claude Code skill from files embedded in the binary (offline, version-matched), with a hidden integrity marker sostatuscan report up-to-date / complete / unmodified.upgradeprunes stale files.naba doctor. New health command: verifies skills install matches the binary, validates the API key live (models.list, no image cost), checks the configured model is reachable, and confirms config/version. Non-zero exit on failure.- Correct output extensions. Output files now match the response format: a mismatched
-oextension is corrected on disk (with a warning), and JSON output reportsrequested_format/actual_format. - MCP parity. The MCP image tools expose
aspect/resolution/quality, and tool results report the written file's format.
Breaking changes
- Default model changed to
gemini-3.1-flash-image. Existingmodel:config values keep working via precedence; only the empty/dead default changes. install.sh/install.pyremoved, superseded bynaba skills install. Uninstall is nownaba skills remove. The pre-plan-002 per-command skills (/naba-generate, …) are not embedded and must be removed manually:rm -rf ~/.claude/skills/naba-*(adjust for your scope/surface).- All Gemini image models require a paid (billing-enabled) tier — none work on the free tier.
Install / upgrade
brew update && brew upgrade naba # existing Homebrew users
brew install dixson3/tap/naba # fresh
go install github.com/dixson3/naba/cmd/naba@v0.5.0
naba skills install # deploy the /naba Claude Code skill
naba doctor # verify your environmentKnown nuance
gemini-3.1-flash-imagedoes not support--resolution 512("not supported for this model"); use1K/2K/4K. Flash returns PNG, Pro returns JPEG — naba writes the correct extension either way.
Full changelog: v0.4.0...v0.5.0