feat(history_picker): implement a history picker to select old prompts

Author: sudo-tee

README.md

@@ -169,6 +169,10 @@ require('opencode').setup({
       undo = { '<C-u>', mode = { 'i', 'n' } }, -- Undo to selected message in timeline picker
       fork = { '<C-f>', mode = { 'i', 'n' } }, -- Fork from selected message in timeline picker
     },
+    history_picker = {
+      delete_entry = { '<C-d>', mode = { 'i', 'n' } }, -- Delete selected entry in the history picker
+      clear_all = { '<C-X>', mode = { 'i', 'n' } }, -- Clear all entries in the history picker
+    }
   },
   ui = {
     position = 'right', -- 'right' (default) or 'left'. Position of the UI split

lua/opencode/api.lua

@@ -98,6 +98,10 @@ function M.select_child_session()
   core.select_session(state.active_session and state.active_session.id or nil)
 end
 
+function M.select_history()
+  require('opencode.ui.history_picker').pick()
+end
+
 function M.toggle_pane()
   if not state.windows then
     core.open({ new_session = false, focus = 'output' })
@@ -1174,6 +1178,11 @@ M.commands = {
     fn = M.help,
   },
 
+  history = {
+    desc = 'Select from prompt history',
+    fn = M.select_history,
+  },
+
   mcp = {
     desc = 'Show MCP server configuration',
     fn = M.mcp,
@@ -1224,6 +1233,7 @@ M.slash_commands_map = {
   ['/child-sessions'] = { fn = M.select_child_session, desc = 'Select child session' },
   ['/command-list'] = { fn = M.commands_list, desc = 'Show user-defined commands' },
   ['/compact'] = { fn = M.compact_session, desc = 'Compact current session' },
+  ['/history'] = { fn = M.select_history, desc = 'Select from history' },
   ['/mcp'] = { fn = M.mcp, desc = 'Show MCP server configuration' },
   ['/models'] = { fn = M.configure_provider, desc = 'Switch provider/model' },
   ['/new'] = { fn = M.open_input_new_session, desc = 'Create new session' },

lua/opencode/config.lua

@@ -17,6 +17,7 @@ M.defaults = {
       ['<leader>og'] = { 'toggle', desc = 'Toggle Opencode window' },
       ['<leader>oi'] = { 'open_input', desc = 'Open input window' },
       ['<leader>oI'] = { 'open_input_new_session', desc = 'Open input (new session)' },
+      ['<leader>oh'] = { 'select_history', desc = 'Select from history' },
       ['<leader>oo'] = { 'open_output', desc = 'Open output window' },
       ['<leader>ot'] = { 'toggle_focus', desc = 'Toggle focus' },
       ['<leader>oT'] = { 'timeline', desc = 'Session timeline' },
@@ -85,6 +86,10 @@ M.defaults = {
       undo = { '<C-u>', mode = { 'i', 'n' } },
       fork = { '<C-f>', mode = { 'i', 'n' } },
     },
+    history_picker = {
+      delete_entry = { '<C-d>', mode = { 'i', 'n' } },
+      clear_all = { '<C-X>', mode = { 'i', 'n' } },
+    },
   },
   ui = {
     position = 'right',
@@ -185,7 +190,7 @@ M.defaults = {
   debug = {
     enabled = false,
     capture_streamed_events = false,
-    show_ids = false,
+    show_ids = true,
   },
   prompt_guard = nil,
   hooks = {

lua/opencode/history.lua

@@ -97,4 +97,63 @@ M.next = function()
   return M.read()[M.index]
 end
 
+---Delete specific entries from history by their indices
+---@param indices number[] Array of 1-based indices to delete
+M.delete = function(indices)
+  if not indices or #indices == 0 then
+    return false
+  end
+
+  local history = M.read()
+  if #history == 0 then
+    return false
+  end
+
+  -- Sort indices in descending order to avoid index shifting issues
+  local sorted_indices = {}
+  for _, idx in ipairs(indices) do
+    if idx > 0 and idx <= #history then
+      table.insert(sorted_indices, idx)
+    end
+  end
+  table.sort(sorted_indices, function(a, b)
+    return a > b
+  end)
+
+  for _, idx in ipairs(sorted_indices) do
+    table.remove(history, idx)
+  end
+
+  return M._write_history(history)
+end
+
+---Clear all history entries
+M.clear = function()
+  return M._write_history({})
+end
+
+---Internal function to write history array to file
+---@param history_array table Array of history entries to write
+---@return boolean success Whether the write operation succeeded
+M._write_history = function(history_array)
+  local file = io.open(get_history_file().filename, 'w')
+  if not file then
+    return false
+  end
+
+  for i = #history_array, 1, -1 do
+    local entry = history_array[i]
+    if entry and entry ~= '' then
+      local escaped_entry = entry:gsub('\n', '\\n')
+      file:write(escaped_entry .. '\n')
+    end
+  end
+
+  file:close()
+
+  cached_history = nil
+
+  return true
+end
+
 return M

lua/opencode/types.lua

@@ -84,6 +84,7 @@
 ---@field permission OpencodeKeymapPermission
 ---@field session_picker OpencodeSessionPickerKeymap
 ---@field timeline_picker OpencodeTimelinePickerKeymap
+---@field history_picker OpencodeHistoryPickerKeymap
 
 ---@class OpencodeSessionPickerKeymap
 ---@field delete_session OpencodeKeymapEntry
@@ -94,6 +95,10 @@
 ---@field undo OpencodeKeymapEntry
 ---@field fork OpencodeKeymapEntry
 
+---@class OpencodeHistoryPickerKeymap
+---@field delete_entry OpencodeKeymapEntry
+---@field clear_all OpencodeKeymapEntry
+
 ---@class OpencodeCompletionFileSourcesConfig
 ---@field enabled boolean
 ---@field preferred_cli_tool 'server'|'fd'|'fdfind'|'rg'|'git'

lua/opencode/ui/base_picker.lua

@@ -459,8 +459,8 @@ function M.create_picker_item(text, time, debug_text, width)
   function item:to_formatted_text()
     return {
       { self.content },
-      self.time_text and { ' ' .. self.time_text, 'OpencodePickerTime' } or nil,
-      self.debug_text and { ' ' .. self.debug_text, 'OpencodeDebugText' } or nil,
+      self.time_text and { ' ' .. self.time_text, 'OpencodePickerTime' } or { '' },
+      self.debug_text and { ' ' .. self.debug_text, 'OpencodeDebugText' } or { '' },
     }
   end
 

lua/opencode/ui/history_picker.lua

@@ -0,0 +1,110 @@
+local M = {}
+local config = require('opencode.config')
+local base_picker = require('opencode.ui.base_picker')
+local util = require('opencode.util')
+local history = require('opencode.history')
+
+---Format history entries for history picker
+---@param item table History item with text content
+---@param width number Picker width
+---@return PickerItem
+local function format_history_item(item, width)
+  local entry = item.content or item.text or ''
+
+  return base_picker.create_picker_item(entry:gsub('\n', '↵'), nil, 'ID: ' .. item.id, width)
+end
+
+function M.pick(callback)
+  local history_entries = history.read()
+
+  if #history_entries == 0 then
+    vim.notify('No history entries found', vim.log.levels.INFO)
+    return false
+  end
+
+  local history_items = {}
+  for i, entry in ipairs(history_entries) do
+    table.insert(history_items, { id = i, text = entry, content = entry })
+  end
+
+  local actions = {
+    delete = {
+      key = config.keymap.history_picker.delete_entry,
+      label = 'delete',
+      multi_selection = true,
+      fn = function(selected, opts)
+        local entries_to_delete = type(selected) == 'table' and selected.id == nil and selected or { selected }
+
+        local indices_to_remove = {}
+        for _, entry_to_delete in ipairs(entries_to_delete) do
+          local idx = util.find_index_of(opts.items, function(item)
+            return item.id == entry_to_delete.id
+          end)
+          if idx > 0 then
+            table.insert(indices_to_remove, idx)
+          end
+        end
+
+        table.sort(indices_to_remove, function(a, b)
+          return a > b
+        end)
+
+        local success = history.delete(indices_to_remove)
+        if success then
+          for _, idx in ipairs(indices_to_remove) do
+            table.remove(opts.items, idx)
+          end
+          vim.notify('Deleted ' .. #entries_to_delete .. ' history entry(s)', vim.log.levels.INFO)
+        else
+          vim.notify('Failed to delete history entries', vim.log.levels.ERROR)
+        end
+
+        return opts.items
+      end,
+      reload = true,
+    },
+    clear_all = {
+      key = config.keymap.history_picker.clear_all,
+      label = 'clear all',
+      fn = function(_, opts)
+        local success = history.clear()
+        if success then
+          opts.items = {}
+          vim.notify('Cleared all history entries', vim.log.levels.INFO)
+        else
+          vim.notify('Failed to clear history entries', vim.log.levels.ERROR)
+        end
+
+        return opts.items
+      end,
+      reload = true,
+    },
+  }
+
+  return base_picker.pick({
+    items = history_items,
+    format_fn = format_history_item,
+    actions = actions,
+    callback = function(selected_item)
+      if selected_item and callback then
+        callback(selected_item.content or selected_item.text)
+      elseif selected_item then
+        local input_window = require('opencode.ui.input_window')
+        local state = require('opencode.state')
+        local windows = state.windows
+        if not input_window.mounted(windows) then
+          require('opencode.core').open({ focus_input = true })
+        end
+        ---@cast windows { input_win: integer, input_buf: integer }
+
+        input_window.set_content(selected_item.content or selected_item.text)
+        require('opencode.ui.mention').restore_mentions(windows.input_buf)
+        input_window.focus_input()
+      end
+    end,
+    title = 'Select History Entry',
+    width = config.ui.picker_width or 100,
+  })
+end
+
+return M

lua/opencode/ui/input_window.lua

@@ -23,6 +23,7 @@ function M.create_window(windows)
   windows.input_win = vim.api.nvim_open_win(windows.input_buf, true, M._build_input_win_config())
 end
 
+---@return_cast windows { input_win: integer, input_buf: integer }
 function M.mounted(windows)
   windows = windows or state.windows
   if