feat(logging): add configurable logging support to opencode

Author: sudo-tee

README.md

@@ -297,6 +297,11 @@ require('opencode').setup({
       enabled = false,
     },
   },
+  logging = {
+    enabled = false,
+    level = 'warn', -- debug, info, warn, error
+    outfile = nil,
+  },
   debug = {
     enabled = false, -- Enable debug messages in the output window
     capture_streamed_events = false,

lua/opencode/config.lua

@@ -216,6 +216,11 @@ M.defaults = {
       enabled = false,
     },
   },
+  logging = {
+    enabled = false,
+    level = 'info', -- debug, info, warn, error
+    outfile = nil,
+  },
   debug = {
     enabled = false,
     capture_streamed_events = false,

lua/opencode/log.lua

@@ -0,0 +1,54 @@
+local M = {}
+
+local config = require('opencode.config')
+local log_path = config.logging and config.logging.outfile or vim.fn.stdpath('log') .. '/opencode.log'
+local level = config.logging and config.logging.level or 'warn'
+
+local logger = require('plenary.log').new({
+  plugin = 'opencode',
+  level = level:lower(),
+  use_console = false,
+  outfile = log_path,
+})
+
+local function get_logger()
+  return logger
+end
+
+function M.debug(msg, ...)
+  if not config.logging.enabled then
+    return
+  end
+  get_logger().debug(string.format(msg, ...))
+end
+
+function M.info(msg, ...)
+  if not config.logging.enabled then
+    return
+  end
+  get_logger().info(string.format(msg, ...))
+end
+
+function M.warn(msg, ...)
+  if not config.logging.enabled then
+    return
+  end
+  get_logger().warn(string.format(msg, ...))
+end
+
+function M.error(msg, ...)
+  if not config.logging.enabled then
+    return
+  end
+  get_logger().error(string.format(msg, ...))
+end
+
+--- @return string
+function M.get_path()
+  if not config.logging.enabled then
+    return
+  end
+  return log_path
+end
+
+return M

lua/opencode/types.lua

@@ -189,6 +189,11 @@
 ---@field default_agent? string -- Use current mode if nil
 ---@field instructions? string[] -- Custom instructions for quick chat
 
+---@class OpencodeLoggingConfig
+---@field enabled boolean
+---@field level 'debug' | 'info' | 'warn' | 'error'
+---@field outfile string|nil
+
 ---@class OpencodeConfig
 ---@field preferred_picker 'telescope' | 'fzf' | 'mini.pick' | 'snacks' | 'select' | nil
 ---@field preferred_completion 'blink' | 'nvim-cmp' | 'vim_complete' | nil -- Preferred completion strategy for mentons and commands
@@ -200,6 +205,7 @@
 ---@field keymap OpencodeKeymap
 ---@field ui OpencodeUIConfig
 ---@field context OpencodeContextConfig
+---@field logging OpencodeLoggingConfig
 ---@field debug OpencodeDebugConfig
 ---@field prompt_guard? fun(mentioned_files: string[]): boolean
 ---@field hooks OpencodeHooks