Skip to content

French AZERTY @ key conflicts with Alt-@ sidebar shortcut in TUI composer #2863

@alaaghribi

Description

@alaaghribi

Description

On a French AZERTY keyboard, typing @ in the CodeWhale TUI composer does not insert the @ character. Instead, CodeWhale appears to interpret the key combination as the global Alt-@ shortcut and focuses/reopens the sidebar.

On French AZERTY keyboards, @ is typed with AltGr + 0. This works correctly in Windows Terminal, PowerShell, and other applications, but not inside the CodeWhale TUI prompt/composer.

Copy-pasting @ into the CodeWhale composer works correctly, so the issue seems specific to keyboard input handling for AltGr + 0.

Steps to reproduce

  1. Use Windows 11 with a French AZERTY keyboard layout.

  2. Start CodeWhale TUI from a project directory in Windows Terminal / PowerShell:

    codewhale --yolo --model auto
  3. Focus the prompt/composer input.

  4. Press:

    AltGr + 0
    
  5. Optional: set sidebar_focus = "hidden" in settings, restart CodeWhale, and repeat the same key press.

  6. Optional: start CodeWhale with:

    codewhale --yolo --model auto --no-alt-screen

    Then repeat the same key press.

Expected behavior

AltGr + 0 should insert the @ character in the composer and allow file mention completion, for example:

@apps/api/prisma/schema.prisma

Actual behavior

The @ character is not inserted. Instead, CodeWhale focuses or reopens the sidebar, apparently because AltGr + 0 is interpreted as the global Alt-@ sidebar shortcut.

Setting:

sidebar_focus = "hidden"

does not fix the issue. Pressing AltGr + 0 still reopens/focuses the sidebar.

Running with:

codewhale --yolo --model auto --no-alt-screen

does not fix the issue either.

Copy-pasting the @ character into the composer works correctly.

Impact

This happens every time when using a French AZERTY keyboard on Windows 11. It blocks normal usage of @file mentions in the TUI composer.

Workarounds exist, but they are inconvenient:

  • copy-paste the @ character;
  • write file paths manually without @;
  • use non-interactive codewhale exec;
  • temporarily switch keyboard layout.

This significantly impacts the TUI workflow for users on French AZERTY layouts.

Environment

  • OS: Windows 11
  • codewhale version: v0.8.53
  • Install method: npm
  • Model/provider: deepseek-v4-flash / DeepSeek
  • Terminal app: Windows Terminal
  • Shell: PowerShell
  • Keyboard layout: French AZERTY

Logs, screenshots, or recordings

Relevant settings tested:

sidebar_focus = "hidden"

The issue still happens with this setting.

Also tested:

codewhale --yolo --model auto --no-alt-screen

The issue still happens with --no-alt-screen.

Additional notes:

  • @ works correctly outside CodeWhale in the same Windows Terminal / PowerShell environment.
  • Copy-pasting @ into the CodeWhale composer works correctly.
  • The issue only happens when typing AltGr + 0 inside the CodeWhale TUI composer.
  • The behavior looks like an AZERTY-specific conflict where AltGr + 0 is interpreted as the global Alt-@ sidebar shortcut instead of text input.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Projects

    Status
    Done

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions