deivid-rodriguez/byebug · error · Byebug::CommandNotFound

Unknown command '#{name}'. Try '#{help}'

Error message

Unknown command '#{name}'. Try '#{help}'

What it means

Error "Unknown command '#{name}'. Try '#{help}'" thrown in deivid-rodriguez/byebug.

Source

Thrown at lib/byebug/processors/script_processor.rb:21

require_relative "command_processor"

module Byebug
  #
  # Processes commands from a file
  #
  class ScriptProcessor < CommandProcessor
    #
    # Available commands
    #
    def commands
      super.select(&:allow_in_control)
    end

    def repl
      while (input = interface.read_command(prompt))
        safely do
          command = command_list.match(input)
          raise CommandNotFound.new(input) unless command

          command.new(self, input).execute
        end
      end
    end

    def after_repl
      super

      interface.close
    end

    #
    # Prompt shown before reading a command.
    #
    def prompt
      "(byebug:ctrl) "
    end

View on GitHub (pinned to 25476b18d9)

Solutions

1. Correct the command name in the script file; only commands allowed in control mode work there.
2. Run 'help' in interactive byebug to see valid commands and fix the script accordingly.

Example fix

# in the byebug script file replace the invalid line with a valid command, e.g. 'continue' instead of 'contnue'

When it happens

Trigger: Thrown at lib/byebug/processors/script_processor.rb:21 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of deivid-rodriguez/byebug@25476b18d9 (2026-08-23). Data as JSON: /api/errors/1cfa36343d84fea6. Report an issue: GitHub.