claude-code - 💡(How to fix) Fix Read tool: suggest alternatives when rejecting binary files

Minor UX improvement. Users hit this when they forget the tool's limitations and have to figure out the alternative path themselves. One extra sentence in the error saves a round-trip.

TL;DR

Modify the error message to include guidance on alternative tools or methods for reading binary files based on their type.

Guidance

• Identify the file type and append the corresponding guidance to the error message, such as suggesting the use of openpyxl or pandas for .xlsx files.
• Consider adding a generic message for unsupported binary file types, directing users to find an appropriate CLI tool or Python script.
• Review the list of supported file types to ensure accuracy and completeness of the guidance provided.
• Test the updated error messages with various binary file types to verify the guidance is helpful and accurate.

Example

error_messages = {
    '.xlsx': 'Use a Python script with openpyxl or pandas to read Excel files',
    '.docx': 'Use a Python script with python-docx to read Word files',
    # Add more file types as needed
}

def get_error_message(file_type):
    return error_messages.get(file_type, 'Use a Python script or appropriate CLI tool to process this file')

Notes

The solution assumes that the file type can be accurately determined and that the suggested tools or methods are available and suitable for the user's environment.

Recommendation

Apply workaround: Modify the error message to include guidance on alternative tools or methods, as this provides a better user experience and helps users find an alternative solution without requiring significant changes to the existing tool.