crag.nvim

Neovim integration for crag — make every AI agent obey your codebase.

Features

• :CragAnalyze, :CragCompile, :CragAudit, :CragDiff, :CragDoctor, :CragHookInstall
• Auto-compile on .claude/governance.md save
• Statusline summary based on crag audit --json
• Native vim.diagnostic integration
• Windows-friendly CLI execution via argv lists instead of shell strings
• :checkhealth crag support

Requirements

• Neovim 0.9+
• crag installed globally, or available via npx

Installation

lazy.nvim

{
  'WhitehatD/crag.nvim',
  config = function()
    require('crag').setup()
  end,
}

packer.nvim

use({
  'WhitehatD/crag.nvim',
  config = function()
    require('crag').setup()
  end,
})

Configuration

require('crag').setup({
  auto_compile = true,
  status_line = true,
  diagnostics = true,
  cli_path = nil,
})

Commands

• :CragAnalyze
• :CragCompile [target]
• :CragAudit
• :CragDiff
• :CragDoctor
• :CragHookInstall
• :CragRefresh

Statusline

require('lualine').setup({
  sections = {
    lualine_x = { function() return require('crag').status() end },
  },
})

---

The crag ecosystem

crag.sh · Docs · GitHub · npm · Dashboard · VS Code · Status