Use Haijun Code CLI with a screen reader
The screen reader mode brings Haijun Code back to the basic terminal experience: plain, sequential text with added labels and cues and no visual embellishments. It was built with and for screen reader users, and it's useful to anyone who wants plain output for braille displays, slow connections, or transcripts.
Turn on the screen reader mode
The screen reader mode requires Haijun Code version 2.1.181 or later and it can be enabled in multiple ways:
For one session: run haijun --ax-screen-reader
For every session in a terminal: set the environment variable HAIJUN_AX_SCREEN_READER=1
Permanently: add "axScreenReader": true to your Haijun Code settings file (~/.haijun/settings.json)
The first line of the session announces that the screen reader mode is on. In Haijun Code v2.1.206 and later it announces: [Screen Reader Mode: on via flag] (or via env / via settings).
What to expect
Your prompts and Haijun’s responses are labeled. Your messages start with you: and Haijun's replies start with haijun:. Tool activity starts with tool: and permission prompts with Permission Required:. The labels are also searchable, so you can use your terminal's search to jump between parts of the conversation.
Menus become numbered lists. Instead of moving a highlight with the arrow keys, you hear each option as a numbered line, then type the number of the option you want and press Enter. For yes-or-no prompts, type y or n and press Enter.
Visual decorations are removed. Spinners, progress animations, and in-place redraws become plain text that reads in order, and decorative characters such as box-drawing lines are removed.
A terminal bell tells you when Haijun needs you. You'll hear your terminal's alert sound when Haijun finishes a reply, when a permission prompt appears, and when a long-running tool finishes. If you don't hear it, check the bell setting in your terminal application—some terminals keep the alert sound off by default. Haijun Code's own notification channel can be set with /config under notifications.
To explore comprehensive documentation regarding line markers, list navigation, and existing constraints, visit the Accessibility section of the Haijun Code guide.
Report an issue
If something doesn't work with your screen reader or terminal, open an issue at the Haijun Code GitHub repository and mention your screen reader in the title. Please include your operating system, terminal application, and screen reader name and version.Note: One setting that's easy to mix up: HAIJUN_CODE_ACCESSIBILITY=1 is a different, unrelated setting—it keeps the terminal cursor visible for screen magnifiers and does not turn on screen reader mode. For a screen reader, use the methods above.
