chore(commands)!: remove legacy commands support

BREAKING CHANGE:  Legacy commands have been removed

You can you the `Opencode` which contains all commands

Author: sudo-tee

README.md

@@ -587,8 +587,6 @@ There's 3 main ways on how to change the snacks picker layout
 
 The plugin provides the following actions that can be triggered via keymaps, commands, slash commands (typed in the input window), or the Lua API:
 
-> **Note:** Commands have been restructured into a single `:Opencode` command with subcommands. Legacy `Opencode*` commands (e.g., `:OpencodeOpenInput`) are still available by default but will be removed in a future version. Update your scripts and workflows to use the new nested syntax.
-
 | Action                                                      | Default keymap                        | Command                                     | API Function                                                           |
 | ----------------------------------------------------------- | ------------------------------------- | ------------------------------------------- | ---------------------------------------------------------------------- |
 | Open opencode. Close if opened                              | `<leader>og`                          | `:Opencode`                                 | `require('opencode.api').toggle()`                                     |

lua/opencode/api.lua

@@ -1487,53 +1487,6 @@ M.slash_commands_map = {
   },
 }
 
-M.legacy_command_map = {
-  OpencodeSwapPosition = 'swap',
-  OpencodeToggleFocus = 'toggle_focus',
-  OpencodeOpenInput = 'open input',
-  OpencodeOpenInputNewSession = 'session new',
-  OpencodeOpenOutput = 'open output',
-  OpencodeCreateNewSession = 'session new',
-  OpencodeClose = 'close',
-  OpencodeStop = 'cancel',
-  OpencodeSelectSession = 'session select',
-  OpencodeSelectChildSession = 'session child',
-  OpencodeTogglePane = 'toggle_pane',
-  OpencodeConfigureProvider = 'models',
-  OpencodeConfigureVariant = 'variant',
-  OpencodeRun = 'run',
-  OpencodeRunNewSession = 'run_new',
-  OpencodeDiff = 'diff open',
-  OpencodeDiffNext = 'diff next',
-  OpencodeDiffPrev = 'diff prev',
-  OpencodeDiffClose = 'diff close',
-  OpencodeRevertAllLastPrompt = 'revert all prompt',
-  OpencodeRevertThisLastPrompt = 'revert this prompt',
-  OpencodeRevertAllSession = 'revert all session',
-  OpencodeRevertThisSession = 'revert this session',
-  OpencodeRevertAllToSnapshot = 'revert all',
-  OpencodeRevertThisToSnapshot = 'revert this',
-  OpencodeRestoreSnapshotFile = 'restore file',
-  OpencodeRestoreSnapshotAll = 'restore all',
-  OpencodeSetReviewBreakpoint = 'breakpoint',
-  OpencodeInit = 'session agents_init',
-  OpencodeHelp = 'help',
-  OpencodeMCP = 'mcp',
-  OpencodeAgentPlan = 'agent plan',
-  OpencodeAgentBuild = 'agent build',
-  OpencodeAgentSelect = 'agent select',
-  OpencodeRunUserCommand = 'command',
-  OpencodeCompactSession = 'session compact',
-  OpencodeShareSession = 'session share',
-  OpencodeUnshareSession = 'session unshare',
-  OpencodeUndo = 'undo',
-  OpencodeRedo = 'redo',
-  OpencodePermissionAccept = 'permission accept',
-  OpencodePermissionAcceptAll = 'permission accept_all',
-  OpencodePermissionDeny = 'permission deny',
-  OpencodePasteImage = 'paste_image',
-}
-
 function M.route_command(opts)
   local args = vim.split(opts.args or '', '%s+', { trimempty = true })
   ---@type OpencodeSelectionRange|nil
@@ -1599,25 +1552,6 @@ function M.complete_command(arg_lead, cmd_line, cursor_pos)
   return {}
 end
 
-function M.setup_legacy_commands()
-  if not config.legacy_commands then
-    return
-  end
-
-  for legacy_name, new_route in pairs(M.legacy_command_map) do
-    vim.api.nvim_create_user_command(legacy_name, function(opts)
-      vim.notify(
-        string.format(':%s is deprecated. Use `:Opencode %s` instead', legacy_name, new_route),
-        vim.log.levels.WARN
-      )
-      vim.cmd('Opencode ' .. new_route)
-    end, {
-      desc = 'deprecated',
-      nargs = '*',
-    })
-  end
-end
-
 M.get_slash_commands = Promise.async(function()
   local result = {}
   for slash_cmd, def in pairs(M.slash_commands_map) do
@@ -1653,8 +1587,6 @@ function M.setup()
     range = true, -- Enable range support
     complete = M.complete_command,
   })
-
-  M.setup_legacy_commands()
 end
 
 return M

lua/opencode/config.lua

@@ -11,7 +11,6 @@ M.defaults = {
   default_global_keymaps = true,
   default_mode = 'build',
   default_system_prompt = nil,
-  legacy_commands = true,
   keymap_prefix = '<leader>o',
   opencode_executable = 'opencode',
   server = {

lua/opencode/types.lua

@@ -230,7 +230,6 @@
 ---@field debug OpencodeDebugConfig
 ---@field prompt_guard? fun(mentioned_files: string[]): boolean
 ---@field hooks OpencodeHooks
----@field legacy_commands boolean
 ---@field quick_chat OpencodeQuickChatConfig
 
 ---@class MessagePartState

tests/unit/api_spec.lua

@@ -68,51 +68,12 @@ describe('opencode.api', function()
   end)
 
   describe('setup', function()
-    it('registers the main Opencode command and legacy commands', function()
+    it('registers the main Opencode command', function()
       api.setup()
 
-      local main_cmd_found = false
-      local legacy_cmd_count = 0
-
-      for i, cmd in ipairs(created_commands) do
-        if cmd.name == 'Opencode' then
-          main_cmd_found = true
-          assert.equal('Opencode.nvim main command with nested subcommands', cmd.opts.desc)
-        else
-          legacy_cmd_count = legacy_cmd_count + 1
-          assert.truthy(string.match(cmd.opts.desc, 'deprecated'), 'Legacy command should be marked as deprecated')
-        end
-      end
-
-      assert.truthy(main_cmd_found, 'Main Opencode command should be registered')
-      assert.truthy(legacy_cmd_count > 0, 'Legacy commands should be registered')
-    end)
-
-    it('sets up legacy command functions that route to main command', function()
-      local stored_fns = {}
-      local cmd_stub
-
-      vim.api.nvim_create_user_command = function(name, fn, _)
-        stored_fns[name] = fn
-      end
-
-      cmd_stub = stub(vim, 'cmd')
-
-      api.setup()
-
-      stored_fns['OpencodeOpenInput']()
-      assert.stub(cmd_stub).was_called()
-      assert.stub(cmd_stub).was_called_with('Opencode open input')
-
-      cmd_stub:clear()
-      stored_fns['OpencodeStop']()
-      assert.stub(cmd_stub).was_called_with('Opencode cancel')
-
-      cmd_stub:clear()
-      stored_fns['OpencodeClose']()
-      assert.stub(cmd_stub).was_called_with('Opencode close')
-
-      cmd_stub:revert()
+      assert.equal(1, #created_commands)
+      assert.equal('Opencode', created_commands[1].name)
+      assert.equal('Opencode.nvim main command with nested subcommands', created_commands[1].opts.desc)
     end)
   end)