⭐ Claude RTL Best fix

The best Hebrew & Arabic RTL fix for Claude Code. Works instantly after install — no setup, no commands to remember. Free forever.

Tired of Hebrew or Arabic text breaking in Claude Code? Punctuation in the wrong place, parentheses flipped, numbers scrambled mid-sentence?

This extension fixes it the moment you install it. The mirror panel opens automatically next to your Claude Code chat, showing the exact same conversation with correct right-to-left rendering. Zero configuration. No commands to learn. No second window.

Built by the team behind PasteFix — the same engine that powers their Hebrew/Arabic Word/Google-Docs fixer powers this extension's BiDi rendering. Battle-tested on real Hebrew academic theses and Arabic technical documents.

Why "Best fix"?

• ✅ Instant: panel auto-opens on install
• ✅ Zero setup: no settings, no API keys, no accounts
• ✅ Free forever: open-source, MIT-licensed
• ✅ Both languages: Hebrew AND Arabic, equally well
• ✅ No risk: read-only — never edits Claude Code or your files
• ✅ Privacy-first: runs 100% locally, no data leaves your machine

⚡ Install

From VS Code Marketplace (recommended)

1. In VS Code, press Ctrl+Shift+X to open Extensions.
2. Search for "Claude RTL Best fix".
3. Click Install. Done.

Or install from the Marketplace page.

From a .vsix file

If your VS Code fork doesn't reach the Marketplace (Cursor, VSCodium with no Open VSX, etc.), download the .vsix directly:

Windows (PowerShell):

iwr https://raw.githubusercontent.com/tzvivivi/pastefix/master/release/install.ps1 | iex

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/tzvivivi/pastefix/master/release/install.sh | bash

The script downloads the latest .vsix, installs it via VS Code's CLI, and prints next steps. About 5 seconds total.

After install

Click the RTL button at the bottom-right of VS Code (status bar). The mirror panel opens. Click again to hide. That's it — no F5, no second window, no commands to remember.

How it works

Claude Code persists every chat to a .jsonl file at ~/.claude/projects/<workspace>/<session>.jsonl. The extension:

• Picks the most-recently-modified .jsonl (across all projects if no workspace folder is open).
• Polls the file every second; on growth, parses new user/assistant messages.
• Renders each paragraph with corrected RTL/BiDi rendering using PasteFix's BiDi engine (RLM marks after Latin runs, arrow flipping, etc.). The result is a side-by-side mirror that never touches Claude Code's own panel.

Settings (optional)

Open Settings → Extensions → Claude RTL Best fix:

Commands

Ctrl+Shift+P then type "Claude RTL":

• Claude RTL Best fix: Toggle Panel — same as clicking the status-bar button.
• Claude RTL Best fix: Open Panel — opens (no-op if already open).
• Claude RTL Best fix: Refresh — re-scan the latest session.

Build from source

# from repo root
pnpm install
pnpm --filter claude-rtl-best-fix build
cd packages/vscode-bidi
pnpm exec vsce package --no-dependencies

That generates a fresh .vsix next to package.json.

Limitations

• Doesn't fix Claude Code's own panel — Claude Code is a sealed webview that can't be patched. You read the corrected text in this panel beside it.
• Text content only — tool calls and image responses appear only in the original panel.
• ~1s lag — polls the file every second (push notifications would be nicer but Claude Code rewrites JSONL atomically, which Node's fs.watch handles inconsistently across platforms).

About PasteFix

This extension is built and maintained by the team behind PasteFix — a tool for correcting Hebrew and Arabic text pasted from AI assistants into Word, Google Docs, and other rich-text editors. PasteFix uses the same bidirectional-text engine that powers this extension's panel.

If you also need clean Hebrew/Arabic when copying out of Claude Code into Word, give PasteFix a try.

License

MIT — see LICENSE.