taigrr/glaze.nvim

github

dependency-management

11

0

0

0

CREATED

2026-02-18

UPDATED

2026-02-19

---

Go + Lazy = Glaze — A centralized manager for Go binaries in Neovim.

The Problem

Every Go-based Neovim plugin reinvents the wheel:

• freeze.nvim needs freeze → ships its own installer
• glow.nvim needs glow → ships its own installer
• mods.nvim needs mods → ships its own installer

Each plugin implements go install, update checking, and version management from scratch. Users run different update commands for each plugin. Plugin authors duplicate code.

The Solution

Glaze provides a single source of truth for Go binaries:

-- Plugin authors: two lines
local ok, glaze = pcall(require, "glaze")
if ok then glaze.register("freeze", "github.com/charmbracelet/freeze") end

-- Users: one command
:Glaze

✨ Features

• 📦 Centralized management — Register binaries from any plugin, manage from one UI
• 🚀 Parallel installations — Configurable concurrency for fast updates
• 🎯 Cursor-aware keybinds — u updates binary under cursor, U updates all
• 🔄 Auto-update checking — Daily/weekly checks with non-intrusive notifications
• 📍 Smart binary detection — Finds binaries in PATH, GOBIN, and GOPATH
• 🎨 Sugary-sweet aesthetic — Pink/magenta theme reminding you of doughnuts...
• 🔔 Callback support — Get notified when your binary is updated
• ⚡ Zero config for plugins — Register and go

📦 Installation

lazy.nvim

{
  "taigrr/glaze.nvim",
  config = function()
    require("glaze").setup()
  end,
}

packer.nvim

use {
  "taigrr/glaze.nvim",
  config = function()
    require("glaze").setup()
  end,
}

⚡ Requirements

• Neovim >= 0.9.0
• Go >= 1.18 (for go install support)
• Optional: goenv (auto-detected)

🚀 Quick Start

local glaze = require("glaze")

-- Setup
glaze.setup()

-- Register binaries
glaze.register("freeze", "github.com/charmbracelet/freeze")
glaze.register("glow", "github.com/charmbracelet/glow")
glaze.register("gum", "github.com/charmbracelet/gum")

-- Open the UI
vim.cmd("Glaze")

📖 Commands

⌨️ Keybinds

🔌 For Plugin Authors

Make your plugin a Glaze consumer with two lines:

-- In your plugin's setup:
local ok, glaze = pcall(require, "glaze")
if ok then
  glaze.register("mytool", "github.com/me/mytool", {
    plugin = "myplugin.nvim",  -- Shows in UI
    callback = function(success)
      if success then vim.notify("mytool updated!") end
    end,
  })
end

Example Consumers

These plugins use Glaze to manage their Go binaries:

• neocrush.nvim — AI-powered coding assistant
• freeze.nvim — Screenshot code with freeze
• blast.nvim — Code activity tracking

⚙️ Configuration

require("glaze").setup({
  -- UI settings
  ui = {
    border = "rounded",  -- "none", "single", "double", "rounded", "solid", "shadow"
    size = { width = 0.7, height = 0.8 },
    icons = {
      pending = "○",
      running = "◐",
      done = "●",
      error = "✗",
      binary = "󰆍",
    },
    use_system_theming = false,  -- Use nvim theme instead of doughnut colors
  },

  -- Parallel installations
  concurrency = 4,

  -- Go command (auto-detects goenv)
  go_cmd = { "go" },

  -- Auto-install missing binaries on register
  auto_install = {
    enabled = true,
    silent = false,
  },

  -- Auto-check for updates
  auto_check = {
    enabled = true,
    frequency = "daily",  -- "daily", "weekly", or hours as number
  },

  -- Auto-update when newer versions found
  auto_update = {
    enabled = false,  -- Requires auto_check
  },
})

📋 API

local glaze = require("glaze")

-- Registration
glaze.register(name, url, opts?)  -- Register a binary
glaze.unregister(name)            -- Remove a binary
glaze.binaries()                  -- Get all registered binaries

-- Status
glaze.is_installed(name)          -- Check if binary exists
glaze.bin_path(name)              -- Get full path to binary
glaze.status(name)                -- "installed", "missing", or "unknown"

-- Runner
local runner = require("glaze.runner")
runner.update({ "freeze" })       -- Update specific binaries
runner.update_all()               -- Update all
runner.install_missing()          -- Install all missing
runner.abort()                    -- Stop all tasks

-- Checker
local checker = require("glaze.checker")
checker.check()                   -- Check for updates
checker.get_update_info()         -- Get cached update info

🎨 Highlight Groups

🩺 Health Check

:checkhealth glaze

Verifies Go installation, GOBIN configuration, and registered binary status.

🤝 Related Projects

Glaze is inspired by:

• lazy.nvim — UI patterns and aesthetics
• mason.nvim — Centralized tool management concept

📄 License

0BSD © Tai Groot