Skip to content

v0.5.0 — Gemini 3.x models + naba skills/doctor

Choose a tag to compare

@github-actions github-actions released this 14 Jun 19:20
369afe3

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 prior gemini-2.0-flash-exp-image-generation was retired upstream and broke fresh installs). gemini-3-pro-image is available as a higher-quality tier.
  • Quality & imageConfig flags. --quality {fast,high} (model alias) and --aspect / --resolution (Gemini imageConfig) on all generative commands. Resolution precedence: --model > --quality > config model > config quality > 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 so status can report up-to-date / complete / unmodified. upgrade prunes 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 -o extension is corrected on disk (with a warning), and JSON output reports requested_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. Existing model: config values keep working via precedence; only the empty/dead default changes.
  • install.sh / install.py removed, superseded by naba skills install. Uninstall is now naba 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 environment

Known nuance

  • gemini-3.1-flash-image does not support --resolution 512 ("not supported for this model"); use 1K/2K/4K. Flash returns PNG, Pro returns JPEG — naba writes the correct extension either way.

Full changelog: v0.4.0...v0.5.0