feat(neovim): add opencode.nvim for AI assistant integration

home-manager/programs/neovim/lua/ai.lua

@@ -1,3 +1,70 @@
--- Integrates an AI workspace with chat, prompts, and actions inside Neovim.
+-- AI integration for Neovim
+-- Includes sidekick.nvim and opencode.nvim (opencode AI assistant integration)
+
+-- ====================================================================================
+-- SIDEKICK (AI workspace with chat, prompts, and actions)
 -- From: https://github.com/folke/sidekick.nvim
+-- ====================================================================================
 require("sidekick").setup({})
+
+-- ====================================================================================
+-- SNACKS (Required for opencode.nvim)
+-- From: https://github.com/folke/snacks.nvim
+-- ====================================================================================
+require("snacks").setup({
+	input = {},
+	picker = {},
+	terminal = {},
+})
+
+-- ====================================================================================
+-- OPENCODE.NVIM (opencode AI assistant integration)
+-- From: https://github.com/NickvanDyke/opencode.nvim
+-- ====================================================================================
+
+-- Configuration options
+---@type opencode.Opts
+vim.g.opencode_opts = {
+	-- Use default configuration
+}
+
+-- Required for opts.events.reload
+vim.o.autoread = true
+
+-- Keymaps for opencode
+-- <C-a> - Ask opencode about current context
+vim.keymap.set({ "n", "x" }, "<C-a>", function()
+	require("opencode").ask("@this: ", { submit = true })
+end, { desc = "Ask opencode" })
+
+-- <C-x> - Execute opencode action from selection menu
+vim.keymap.set({ "n", "x" }, "<C-x>", function()
+	require("opencode").select()
+end, { desc = "Execute opencode action…" })
+
+-- <C-.> - Toggle opencode terminal
+vim.keymap.set({ "n", "t" }, "<C-.>", function()
+	require("opencode").toggle()
+end, { desc = "Toggle opencode" })
+
+-- Operator mode: add range to opencode prompt
+vim.keymap.set({ "n", "x" }, "go", function()
+	return require("opencode").operator("@this ")
+end, { expr = true, desc = "Add range to opencode" })
+
+vim.keymap.set("n", "goo", function()
+	return require("opencode").operator("@this ") .. "_"
+end, { expr = true, desc = "Add line to opencode" })
+
+-- Scroll keymaps for opencode session
+vim.keymap.set("n", "<S-C-u>", function()
+	require("opencode").command("session.half.page.up")
+end, { desc = "opencode half page up" })
+
+vim.keymap.set("n", "<S-C-d>", function()
+	require("opencode").command("session.half.page.down")
+end, { desc = "opencode half page down" })
+
+-- Remap increment/decrement since we use <C-a> and <C-x> for opencode
+vim.keymap.set("n", "+", "<C-a>", { desc = "Increment", noremap = true })
+vim.keymap.set("n", "-", "<C-x>", { desc = "Decrement", noremap = true })

home-manager/programs/neovim/lua/plugins.lua

@@ -84,7 +84,9 @@ vim.pack.add({
 	{ src = "https://github.com/yioneko/nvim-vtsls" },
 
 	-- AI
+	{ src = "https://github.com/folke/snacks.nvim" }, -- Required for opencode.nvim
 	{ src = "https://github.com/folke/sidekick.nvim" },
+	{ src = "https://github.com/NickvanDyke/opencode.nvim" },
 
 	-- TERMINAL
 	{ src = "https://github.com/akinsho/toggleterm.nvim" },

home-manager/programs/neovim/tests/ai_spec.lua

@@ -1,5 +1,5 @@
 -- Tests for lua/ai.lua
--- Tests AI/sidekick integration (plugin not loaded in minimal test env)
+-- Tests AI integrations: sidekick and opencode.nvim
 
 describe("ai", function()
 	describe("sidekick API", function()
@@ -10,6 +10,67 @@ describe("ai", function()
 		end)
 	end)
 
+	describe("snacks API", function()
+		it("should have expected snacks components structure", function()
+			-- snacks.nvim provides input, picker, and terminal
+			local expected_components = { "input", "picker", "terminal" }
+			for _, component in ipairs(expected_components) do
+				assert.is_string(component)
+			end
+		end)
+	end)
+
+	describe("opencode.nvim API", function()
+		it("should support opencode_opts global variable", function()
+			-- opencode.nvim uses vim.g.opencode_opts for configuration
+			vim.g.opencode_opts = {}
+			assert.is_table(vim.g.opencode_opts)
+			vim.g.opencode_opts = nil
+		end)
+
+		it("should support autoread option for reload events", function()
+			-- Required for opencode reload functionality
+			vim.o.autoread = true
+			assert.equals(true, vim.o.autoread)
+		end)
+
+		it("should support context placeholders pattern", function()
+			-- opencode.nvim uses context placeholders like @this, @buffer, etc.
+			local placeholders = {
+				"@this",
+				"@buffer",
+				"@buffers",
+				"@visible",
+				"@diagnostics",
+				"@quickfix",
+				"@diff",
+				"@marks",
+			}
+			for _, placeholder in ipairs(placeholders) do
+				assert.is_string(placeholder)
+				assert.is_true(placeholder:sub(1, 1) == "@")
+			end
+		end)
+
+		it("should support prompt library pattern", function()
+			-- opencode.nvim includes built-in prompts
+			local prompts = {
+				"diagnostics",
+				"diff",
+				"document",
+				"explain",
+				"fix",
+				"implement",
+				"optimize",
+				"review",
+				"test",
+			}
+			for _, prompt in ipairs(prompts) do
+				assert.is_string(prompt)
+			end
+		end)
+	end)
+
 	describe("AI keymaps expected", function()
 		it("should support leader-based AI keymaps pattern", function()
 			-- Verify keymap API works for AI-style mappings
@@ -18,5 +79,75 @@ describe("ai", function()
 			assert.is_true(keymap ~= "")
 			vim.keymap.del("n", "<leader>ai_test")
 		end)
+
+		it("should support opencode ask keymap pattern", function()
+			-- Test <C-a> style keymap for ask
+			vim.keymap.set({ "n", "x" }, "<C-a>", function() end, { desc = "Ask opencode" })
+			local keymap_n = vim.fn.maparg("<C-a>", "n")
+			local keymap_x = vim.fn.maparg("<C-a>", "x")
+			assert.is_true(keymap_n ~= "")
+			assert.is_true(keymap_x ~= "")
+			vim.keymap.del("n", "<C-a>")
+			vim.keymap.del("x", "<C-a>")
+		end)
+
+		it("should support opencode select keymap pattern", function()
+			-- Test <C-x> style keymap for select
+			vim.keymap.set({ "n", "x" }, "<C-x>", function() end, { desc = "Execute opencode action" })
+			local keymap_n = vim.fn.maparg("<C-x>", "n")
+			local keymap_x = vim.fn.maparg("<C-x>", "x")
+			assert.is_true(keymap_n ~= "")
+			assert.is_true(keymap_x ~= "")
+			vim.keymap.del("n", "<C-x>")
+			vim.keymap.del("x", "<C-x>")
+		end)
+
+		it("should support opencode toggle keymap pattern", function()
+			-- Test <C-.> style keymap for toggle
+			vim.keymap.set({ "n", "t" }, "<C-.>", function() end, { desc = "Toggle opencode" })
+			local keymap_n = vim.fn.maparg("<C-.>", "n")
+			local keymap_t = vim.fn.maparg("<C-.>", "t")
+			assert.is_true(keymap_n ~= "")
+			assert.is_true(keymap_t ~= "")
+			vim.keymap.del("n", "<C-.>")
+			vim.keymap.del("t", "<C-.>")
+		end)
+
+		it("should support operator mode keymaps", function()
+			-- Test operator mode keymaps (go, goo)
+			vim.keymap.set({ "n", "x" }, "go", function()
+				return ""
+			end, { expr = true, desc = "Add range to opencode" })
+			local keymap = vim.fn.maparg("go", "n")
+			assert.is_true(keymap ~= "")
+			vim.keymap.del("n", "go")
+			vim.keymap.del("x", "go")
+		end)
+
+		it("should support remapped increment/decrement", function()
+			-- When <C-a> and <C-x> are used for opencode, + and - replace them
+			vim.keymap.set("n", "+", "<C-a>", { desc = "Increment", noremap = true })
+			vim.keymap.set("n", "-", "<C-x>", { desc = "Decrement", noremap = true })
+			local keymap_plus = vim.fn.maparg("+", "n")
+			local keymap_minus = vim.fn.maparg("-", "n")
+			assert.is_true(keymap_plus ~= "")
+			assert.is_true(keymap_minus ~= "")
+			vim.keymap.del("n", "+")
+			vim.keymap.del("n", "-")
+		end)
+	end)
+
+	describe("opencode command pattern", function()
+		it("should support session scroll commands", function()
+			-- opencode supports command() for session control
+			local scroll_commands = {
+				"session.half.page.up",
+				"session.half.page.down",
+			}
+			for _, cmd in ipairs(scroll_commands) do
+				assert.is_string(cmd)
+				assert.is_true(cmd:find("^session%.") ~= nil)
+			end
+		end)
 	end)
 end)