convez.ai
PluginDevOps & InfraestruturaIntermediário
noambrand

Kivun Terminal WSL

noambrand/kivun-terminal-wsl

Terminal Claude Code com renderização correta de 11 idiomas RTL

Ver no GitHub
BomPluginScore · de 0 a 100

Terminal especializado para Claude Code que renderiza corretamente hebraico, árabe, persa e outros 8 idiomas RTL (direita-para-esquerda), com suporte a texto misto RTL+LTR. Funciona em Windows e Linux com instalador de um clique, barra de status ao vivo, seletor de pasta e perfis nomeados.

Instalação

$npx convez-ai noambrand/kivun-terminal-wsl

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
13
Forks
2
Acompanhando
1
Saúde
42%
Último commit
há 2 dias
Versão
v1.10.0
Issues abertas
0
Contribuidores
2

Casos de uso

  • Desenvolvimento em hebraico, árabe ou persa com Claude Code
  • Trabalho com texto bidirecional misto (RTL + LTR)
  • Automação de terminal para usuários de idiomas do Oriente Médio e Ásia do Sul

Veredito

Solução altamente especializada para um nicho crítico: desenvolvedores que trabalham com idiomas RTL precisam de renderização correta de terminal, que ferramentas genéricas não oferecem. Implementação sólida com suporte a múltiplos idiomas e Windows/Linux.

README

A tradução para o português deste README ainda está na fila.


English

💡 Working in English (LTR) only? Check out the sister project ClaudeCode Launchpad CLI - same launcher concept, faster startup (~2 s), no WSL needed. Kivun Terminal is the right pick when you need RTL/BiDi rendering for Hebrew, Arabic, Persian, etc.

Why Kivun Terminal?

Launchpad CLIKivun Terminal
Hebrew / Arabic / Persian text right-aligned❌ shows left-aligned✅ aligns to the right where it belongs
English/code mixed inside a Hebrew sentence❌ words pushed to the wrong edge✅ words land at the correct position in the sentence
Supported RTL languages011 (Hebrew, Arabic, Persian, Urdu, Pashto, Kurdish, Dari, Uyghur, Sindhi, Yiddish, Syriac)
Live status bar (model, context %, usage)✅✅
Light-blue Kivun theme✅ Windows Terminal✅ Konsole
Right-click "Open with…" on a folder✅ Windows Explorer✅ Windows Explorer + Linux file managers
Named profiles per project (folder + model + flags + env vars + startup slash-commands)✅ v2.6.0 - chip row at top of picker, click to switch; ANTHROPIC_API_KEY etc. masked in preview by default✅ 🆕 v1.4.0 - chip row at top of picker; per-profile ANTHROPIC_API_KEY/DEBUG/MCP_* propagated via WSLENV; masked in preview by default
Startup time~2 s~6 s
Install size on Windows~150 MB~2 GB (includes Ubuntu + Konsole)
macOS support✅❌ Deprecated as of v1.2.4 (no Mac terminal handles mixed Hebrew+English - see mac/README.md)
Linux support❌✅ apt / dnf / pacman / zypper

Technical details (BiDi wrapper, RLM injection, Konsole 23.x workarounds, etc.) live in the rest of this README and in docs/ for anyone who wants them.

What's included out of the box

  • 🆕 Named profiles (v1.4.0+) - save folder + model + flags + startup slash-commands + environment variables per project. The chip row at the top of the picker lets you switch between profiles in one click; the active profile is highlighted blue. Per-profile env vars (ANTHROPIC_API_KEY, DEBUG, custom MCP_*, …) are propagated through WSLENV on Windows / export on Linux so they reach the Claude Code session. Values are masked in the resolved-command preview by default for screenshot safety; click 👁 show values to reveal.
  • Folder picker dialog on the desktop shortcut (screenshot above) - browse the folder tree or type/paste a Windows path, plus inline radio-button model selection (Opus / Sonnet / Haiku), one-click flag chips (Respond in Hebrew, High effort, Auto-accept file edits, Read-only, etc.), and a textarea for startup slash commands like /voicemode:converse.
  • Right-click "Open with Kivun Terminal" on any folder in File Explorer - launches straight into that folder, skipping the picker.
  • Live two-line statusline at the bottom of every Claude Code session - model, context %, total tokens, session duration, and 5-hour / 7-day usage with countdown to reset.
  • Light-blue Kivun theme for Konsole (#C8E6FF background) - easy on the eyes, on by default. Disable via TERMINAL_COLOR=default.
  • BiDi wrapper that fixes Hebrew/Arabic/Persian rendering bugs in Claude Code's TUI (see BiDi Wrapper below for the seven specific fixes).
  • Auto-installs everything - WSL2 + Ubuntu + Konsole + Node.js + Claude Code itself, on a clean Windows machine. The installer asks once and handles the rest.

Quick Start

Windows

  1. Download Kivun_Terminal_Setup.exe from the latest release.
  2. Run it - follow the wizard. No admin rights required.
  3. Double-click the Kivun Terminal desktop shortcut → pick a folder (browse the tree or paste a Windows path), or right-click any folder in File Explorer → Open with Kivun Terminal.

First launch can take 5–10 minutes - the installer pulls Ubuntu (WSL2), Konsole, and Claude Code on its own.

  • WSL2 missing. If the wizard says "WSL is not installed", open Terminal (Admin), run wsl --install, reboot, and re-run the installer. You only do this once per machine.
  • SmartScreen warning ("Windows protected your PC"): click More info → Run anyway. The installer is unsigned; the warning fades once Microsoft's reputation signal accumulates from real downloads.
  • Smart App Control on Windows 11 (the harder block - "Smart App Control blocked an app that may be unsafe" with only an Ok button): SAC refuses unsigned apps entirely. Open Start → search Smart App Control → set it to Off. SAC cannot be re-enabled without reinstalling Windows, so leave it off only if you're comfortable running other unsigned apps.
  • Still stuck? Send a 1-click report. Download kivun-diagnostics.cmd from the latest release (or open "Kivun Diagnostics" from the Start menu if it installed) and double-click it. It saves Kivun-Report.txt to your Desktop - email it to noambbb@gmail.com. No admin, nothing sent automatically.

Linux

git clone https://github.com/noambrand/kivun-terminal-wsl.git
cd kivun-terminal-wsl
./linux/install.sh

Supports apt (Debian/Ubuntu), dnf (Fedora/RHEL), pacman (Arch/Manjaro), zypper (openSUSE). Installs Konsole, Node.js, Git, Claude Code, the BiDi wrapper, and right-click integrations for Nautilus + Dolphin.

macOS

Not supported as of v1.2.4. No native macOS terminal renders mixed Hebrew + English correctly today (Apple Terminal lacks a BiDi engine, iTerm2 3.6.x mirrors Hebrew, WezTerm's bidi_enabled is half-broken in mixed scripts). For Hebrew work on Mac, use a Windows or Linux machine. Full context, evidence, and uninstall instructions in mac/README.md. Existing v1.2.x Mac users can still download the deprecated .pkg from the v1.2.3 release for rollback purposes.

First run on Windows or Linux requires a Claude Pro/Max subscription or an Anthropic API key.

Status Bar

A two-line live status bar at the bottom of every Claude Code session - the same statusline.mjs ships in all three installers and registers into ~/.claude/settings.json automatically:

MyProject | 🟢 Sonnet 4.6 | Context 🟩🟩🟩🟩🟩⬜⬜⬜⬜⬜ 51% | tokens: 284K | 24:13

Session 🟨🟨🟨🟨🟨🟨🟨🟨⬜⬜ 77% resets in 4h15m  |  Weekly 🟩🟩⬜⬜⬜⬜⬜⬜⬜⬜ 16% resets in 6d18h

FieldWhat it shows
ModelActive Claude model (color-coded: green = Opus, yellow = Sonnet/Haiku)
Context% of context window consumed (green/yellow/red)
TokensCombined input + output tokens this session
Session / WeeklyUsage limit % with countdown to reset

Terminal Theme

A custom light-blue Kivun color scheme (#C8E6FF background, dark text, blue cursor) ships with every installer and is enabled by default:

PlatformWhat gets configuredFile
Windows (WSL+Konsole)KivunTerminal.profile + ColorSchemeNoam.colorscheme~/.local/share/konsole/ (WSL)
Linux (Konsole)Same profile + color scheme~/.local/share/konsole/

Disable via TERMINAL_COLOR=default in your config to fall back to the terminal emulator's defaults.

BiDi Wrapper

v1.1.0 ships a kivun-claude-bidi Node.js wrapper that pipes Claude Code's output through a state machine doing seven complementary fixes for known Konsole BiDi limitations. Every fix here was added in response to a specific user-visible Hebrew rendering bug; cumulatively they make Hebrew/English mixed terminal output behave the way <bdi> makes it behave in HTML.

FixWhat it doesSolvesDefault
RLE/PDF bracketing of Hebrew runs in LTR paragraphsWraps every Hebrew run in U+202B / U+202C only when the surrounding paragraph is LTRHebrew embedded in English needs an explicit direction marker; otherwise BiDi sees Hebrew chars as just another part of the LTR flowon
Line-start RLM injectionInserts U+200F at the start of any line whose first strong char is RTLFixes Claude's ● שלום first-line LTR bug (anthropics/claude-code#39881)on
Bullet-strip (v1.1.8)Removes the leading ● from Hebrew bullet lines so the line's first visible char is HebrewKonsole 23.x classifies ● as a direction-anchoring neutral; without strip, lines stay LTR even with line-start RLMon
Strip-incoming bidi controls (v1.1.9)Strips embedding (U+202A–U+202E) and isolate (U+2066–U+2069) marks from Claude's stream; preserves LRM/RLMStops upstream-emitted bidi controls from compounding with wrapper-injected RLM and producing nondeterministic positioningauto
Flatten colors on RTL lines (v1.1.10)Strips ANSI SGR (CSI...m) sequences from any line whose first strong char is Hebrew so the line is one attribute runKonsole's BiDi only runs within continuous-attribute regions; color changes split the BiDi run and Qt mispositions the resulting fragmentson
No per-run RLE/PDF on RTL lines (v1.1.11)When the line is already RTL via line-start RLM, skip per-Hebrew-run RLE/PDF brackets - let UAX #9 handle direction across the whole single-attribute linePer-run brackets themselves act as attribute-region boundaries; on lines with multiple Hebrew runs separated by LTR runs, they recreated the same misposition v1.1.10 was supposed to fixoff
Cursor-forward → space replacement on RTL lines (v1.1.16, user-confirmed working April 2026)Replaces each \x1b[NC cursor-forward CSI with N literal space characters on RTL lines. Visually identical (cursor moves over presumed-blank cells; spaces write to those same cells) but no attribute-region boundaryClaude Code's TUI uses cursor-forward escapes instead of literal spaces between every word - confirmed via KIVUN_BIDI_DUMP_RAW=on capture showing 306 cursor-forward CSIs in one short Hebrew session. Each one was splitting Konsole's BiDi run the same way SGR colors did, just invisibly. v1.1.10 caught the visible color splitters; v1.1.16 catches the invisible cursor-forward splitterson (gated on the same KIVUN_BIDI_FLATTEN_COLORS_RTL flag)

Why this isn't fixable upstream: Konsole has no real BiDi engine - it hands continuous-attribute regions to Qt's text layout, and Qt has no idea where a colored, bracketed, or cursor-positioned fragment logically belongs in the surrounding RTL paragraph. This is documented at terminal-wg.pages.freedesktop.org and was empirically confirmed via April 2026 A/B tests on Konsole 23.08.5. KDE has shown no signs of changing it; the wrapper's job is to give Konsole exactly what it can render correctly: a single attribute run per RTL line.

Trade-offs:

  • v1.1.10 flatten loses syntax color on Hebrew lines. Set KIVUN_BIDI_FLATTEN_COLORS_RTL=off to keep colors at the cost of broken positioning. (v1.1.16 cursor-forward replacement is gated on the same flag, so opting out of color-flatten also opts out of cursor-forward replacement.)
  • v1.1.11 no-bracket is the cleaner path; if you preferred the legacy v1.1.0–v1.1.10 behavior set KIVUN_BIDI_BRACKET_RTL_RUNS=on.

The "look for invisible CSI splitters" debugging pattern (v1.1.16 lesson learned, also captured in docs/TROUBLESHOOTING.md): when a wrapper-rendered terminal output looks wrong even though all visible escapes (colors, RLE/PDF) are stripped, look for invisible CSI sequences acting as attribute-region boundaries. Cursor-forward (...C), cursor-back (...D), set/reset mode (...h/...l) all qualify. Turn on KIVUN_BIDI_DUMP_RAW=on and inspect ~/.local/state/kivun-terminal/bidi-raw-dump.bin - anything that looks like text in the dump but is actually an escape sequence is a candidate splitter.

Toggle the wrapper itself via KIVUN_BIDI_WRAPPER=on|off in your config. Each individual fix has its own toggle (KIVUN_BIDI_STRIP_BULLET, KIVUN_BIDI_STRIP_INCOMING, KIVUN_BIDI_FLATTEN_COLORS_RTL, KIVUN_BIDI_BRACKET_RTL_RUNS). Test coverage as of v1.1.16: 87 injector unit fixtures + end-to-end smoke against a fake-claude stand-in via node-pty.

Tech Stack

ComponentTechnologyPurpose
Windows installerNSISPer-user install with WSL/Ubuntu/Konsole bootstrap
Linux installerBash + apt/dnf/pacman/zypperDistro-aware package install + user-home deploy
BiDi wrapperNode.js + node-ptyPipes Claude output through Unicode RLE/PDF/RLM state machine
Konsole profileKDE Konsole .profile + .colorschemeLight-blue Kivun theme + BidiEnabled=true
Language mapShared payload/languages.sh23-language --append-system-prompt map sourced by all launchers
CI/CDGitHub ActionsAutomated Windows .exe + Linux .tar.gz builds on tag

Configuration

Per-platform config files (same schema across all three):

PlatformPath
Windows%LOCALAPPDATA%\Kivun-WSL\config.txt
Linux~/.config/kivun-terminal/config.txt
RESPONSE_LANGUAGE=hebrew         # 23+ languages supported
TEXT_DIRECTION=rtl               # rtl or ltr
KIVUN_BIDI_WRAPPER=on            # on (default) or off
FOLDER_PICKER=true               # show the picker dialog from the desktop shortcut
CLAUDE_FLAGS=                    # default Claude flags applied to every launch

Default Claude flags

CLAUDE_FLAGS is appended to every claude invocation Kivun starts - so you can pin model selection, conversation continuation, etc. without typing flags every time. Example:

CLAUDE_FLAGS=--model opus --continue

The full reference of supported flags (sourced from claude --help, ~25 options) lives at the bottom of config.txt itself for easy lookup. Common ones:

FlagWhat it does
--model opusforce Claude Opus for this session (instead of the default)
--model sonnetforce Claude Sonnet
--continueresume the most recent conversation in this folder
--resumeopen the conversation picker and pick which past chat to resume
--dangerously-skip-permissionsskip the per-tool permission prompts (use with care)
--append-system-prompt "..."add custom instructions to the system prompt

You can also edit CLAUDE_FLAGS from inside the folder picker dialog - click Edit Default Flags to open config.txt in Notepad, edit, save, then launch.

See docs/CHANGELOG.md for the full list of supported languages and config keys.

Contributing

Contributions welcome. Areas where help is especially useful:

  • Wayland keyboard toggle - setxkbmap is X11-only; Wayland needs DE-specific layout switching (KWin: qdbus org.kde.keyboard, GNOME: gsettings input-sources, Sway: per-config). No CI for Wayland; needs a contributor with the hardware.
  • More RTL language coverage - N'Ko, Adlam, Mandaic, Samaritan, and a few others currently fall back to Hebrew xkb layouts. PRs adding entries to payload/languages.sh welcome.
  • Konsole 25.x bring-up - the BiDi wrapper's RLE/PDF/RLM workarounds were tuned against Konsole 23.08 and re-validated on 24.x. If you're on a 25.x preview and see Hebrew misrendering, file an issue with KONSOLE_VERSION + a paste of the broken line.
  • Pacman / zypper installer paths - Arch / openSUSE branches in linux/install.sh are written but only manually tested. CI covers apt (Ubuntu 24.04) and dnf (Fedora 40) automatically; pacman/zypper are field-tested only.

What CI already covers

SurfaceTested by CIWorkflow
apt installer + Konsole 24.x + node-pty (glibc 2.39)✅build-linux.yml (ubuntu-latest container)
dnf installer + Konsole 24.x + node-pty (Fedora gcc)✅build-linux.yml (fedora:40 container, added v1.4.8+)
Windows + WSL2 Ubuntu launcher path✅validate-launcher-windows.yml
BiDi wrapper unit suite (36 fixtures, capability detection, smoke vs fake-claude)✅both above
Wayland / multi-DE / Konsole 25.x / pacman / zypper❌needs manual contributor testing

Fork the repo, make your changes, and open a PR.

🤝 Related projects in the RTL-for-AI-tools community

Six independent developers each built userland RTL fixes for the AI-tooling stack. The fact that all of us had to ship our own fix is itself a comment on how overdue the upstream BiDi work is:

  • Adaptive-RTL-Extension by Lidor Mashiach - generic browser extension with click-to-select RTL for any website, including LLM chat UIs (Claude.ai, ChatGPT, Gemini, etc.).
  • Claude.ai RTL Support (Chrome extension) - Chrome extension purpose-built for Claude.ai specifically. Lighter than the generic adaptive one if you only need RTL on Claude's web UI.
  • rtl-for-vs-code-agents by Guy Ronnen - VS Code extension covering Claude Code, Cursor, Antigravity, and Gemini Code Assist in the VS Code webview layer.
  • Claude Code RTL Support by Yechiel Bar-Yehuda - VS Code / Cursor / Antigravity extension purpose-built for the official Claude Code IDE plugin. 6,700+ installs (4.6K+ Open VSX / 2.1K+ VS Marketplace). Complementary to Guy Ronnen's broader webview fix above - pick this one if you specifically live inside the Claude Code IDE panel.
  • Claude-for-word-RTL-fix by Asaf Aizone - Hebrew/Arabic RTL fix for the Claude for Word (Desktop) add-in.
  • kivun-terminal-wsl (this repo) - terminal-layer fix: a kivun-claude-bidi Node wrapper for Claude Code's TUI output, plus a one-click installer for WSL2+Konsole on Windows or Konsole on Linux. (macOS deprecated as of v1.2.4 - see mac/README.md.)

The surfaces (generic browser DOM, Claude.ai web UI, VS Code / IDE webview, Microsoft Word, terminal) are largely disjoint - pick the one that matches where you're hitting the BiDi problem.

עברית

💡 עובדים רק באנגלית (LTR)? הציצו בפרויקט האח ClaudeCode Launchpad CLI - אותו קונספט שיגור, אתחול מהיר יותר (~2 שניות), בלי WSL. כיוון טרמינל מתאים כשצריך תמיכת RTL/BiDi בעברית, ערבית, פרסית וכד'.

🎯 מה זה?

כיוון טרמינל היא חבילת התקנה ושיגור עבור Claude Code עם תמיכה מלאה ב-RTL. רץ על Windows (דרך WSL2 + Konsole) ו-Linux. הוא פותר את בעיית הצגת עברית/ערבית/פרסית/אורדו ועוד 7 שפות RTL ב-CLI של Claude Code, שלא נתמכות כראוי כברירת מחדל בטרמינלים מודרניים.

⚠️ תמיכת macOS הוסרה ב-v1.2.4. אין כיום אמולטור טרמינל ב-macOS שמציג עברית+אנגלית מעורבת בצורה תקינה (Apple Terminal חסר מנוע BiDi, iTerm2 3.6.x מהפך עברית, BiDi של WezTerm חצי-שבור). למשתמשי Mac שצריכים עברית - השתמשו ב-Windows או Linux. פרטים והוראות הסרה ב-mac/README.md.

כיוון מתקין את Claude Code, מקנפג את הטרמינל לפרופיל המתאים, ומעביר את הפלט של Claude דרך wrapper ייעודי (kivun-claude-bidi) שמטפל בבעיות הכיוון של עברית - כולל הבאג המעצבן שגרם לשורה הראשונה בכל תגובה להופיע מיושרת לשמאל.

✨ במה זה שונה?

  • לעומת Claude Code ב-Windows Terminal: ל-Windows Terminal אין מנוע BiDi כלל; כל פלט עברי מוצג LTR וקרוס. כיוון מריץ את הפלט דרך WSL2 + Konsole, שכן יש לה מנוע BiDi מלא.
  • לעומת Claude Code ב-VS Code: כיוון הוא לטרמינל, לא ל-IDE. אם אתם עובדים בעיקר משורת פקודה - זה מה שאתם רוצים. למי שעובד מ-IDE יש פתרון נפרד של גיא רונן (ראו פרויקטים קשורים למטה).
  • לעומת Claude Desktop: Desktop הוא בעיקר ממשק צ'אט - לא עובד בפועל על הקבצים בפרויקט שלכם. בחרו ב-Desktop לשאלות מהירות וצ'אט. בחרו בכיוון כשאתם רוצים ש-Claude יעבוד אמת בפרויקט (יפתח קבצים, יערוך, יריץ פקודות) - ובמיוחד אם התוכן כולל עברית או RTL.
  • לעומת אפליקציות הצ'אט של Claude (Claude.ai בדפדפן ואפליקציית המובייל לאייפון/אנדרואיד): ממשקי הצ'אט הם שיחה בלבד - לא יכולים לקרוא קבצים מהמחשב שלכם, להריץ פקודות, או לערוך קוד בפועל. בחרו בצ'אט לשאלה מהירה ובודדת; בחרו ב-Claude Code (ובכיוון, לעבודה בעברית/RTL) כשרוצים assistant שעובד אמת בפרויקט שלכם - קורא קבצים, מריץ tests, ועושה commits.

🚀 פיצ'רים

  • ✅ הצגה תקינה של עברית/ערבית/פרסית/אורדו ועוד 7 שפות RTL בפלט של Claude Code
  • ✅ תיקון לבאג של השורה הראשונה (● שלום היה מופיע משמאל לימין; עכשיו מימין לשמאל)
  • ✅ פרופיל Konsole בצבעי Kivun (תכלת בהיר, נעים לעין)
  • ✅ סטטוסליין חי בתחתית המסך (מודל פעיל, אחוז קונטקסט, מגבלות שימוש)
  • ✅ קיצור דרך לשולחן העבודה + תפריט קליק ימני על תיקיות
  • ✅ Folder picker - דיאלוג אחד: עיון בעץ התיקיות או הקלדה/הדבקה של נתיב באותו חלון
  • 🆕 פרופילים בעלי שם לפי פרויקט (v1.4.0) - שמירת תיקייה + מודל + flags + פקודות slash + משתני סביבה לכל פרויקט. שורת הצ'יפים בראש החלון מאפשרת מעבר בין פרופילים בקליק אחד; הפרופיל הפעיל מודגש בכחול. משתני הסביבה לכל פרופיל (כמו ANTHROPIC_API_KEY) עוברים דרך WSLENV ל-WSL ומגיעים ל-Claude Code. ערכים מוסתרים בתצוגה כברירת מחדל - בטוח לצילום מסך.
  • ✅ Alt+Shift להחלפה בין עברית לאנגלית בתוך הטרמינל
  • ✅ נתמך על Windows ו-Linux (apt/dnf/pacman/zypper). תמיכת macOS הוסרה ב-v1.2.4 - ראו mac/README.md

📥 התקנה

הוראות ההתקנה מפורטות באנגלית בקטעי Quick Start למעלה. הפקודות (npm install, נתיבים וכד') זהות בכל השפות ולא תורגמו. בקצרה:

📊 סטטוסליין

סטטוסליין חי בשתי שורות בתחתית כל סשן Claude Code - אותו statusline.mjs מותקן בכל ההתקנות (Windows / Linux) ונרשם אוטומטית ב-~/.claude/settings.json:

MyProject | 🟢 Sonnet 4.6 | Context 🟩🟩🟩🟩🟩⬜⬜⬜⬜⬜ 51% | tokens: 284K | 24:13

Session 🟨🟨🟨🟨🟨🟨🟨🟨⬜⬜ 77% resets in 4h15m  |  Weekly 🟩🟩⬜⬜⬜⬜⬜⬜⬜⬜ 16% resets in 6d18h

שדהמה זה מציג
מודלהמודל הפעיל של Claude (צבעים: ירוק = Opus, צהוב = Sonnet/Haiku)
קונטקסטאחוז חלון הקונטקסט שנוצל (ירוק/צהוב/אדום)
טוקניםסכום קלט + פלט בסשן הזה
Session / Weeklyאחוז מגבלת השימוש עם ספירה לאיפוס

🎨 ערכת נושא לטרמינל

ערכת צבעים בתכלת בהיר של Kivun (#C8E6FF ברקע, טקסט כהה, סמן כחול) מותקנת אוטומטית ומופעלת כברירת מחדל:

פלטפורמהמה מותקןקובץ
Windows (WSL+Konsole)KivunTerminal.profile + ColorSchemeNoam.colorscheme~/.local/share/konsole/ (בתוך WSL)
Linux (Konsole)אותו פרופיל וערכת צבעים~/.local/share/konsole/

לחזור לברירת המחדל של הטרמינל: להגדיר TERMINAL_COLOR=default בקובץ ה-config.

🧠 על תמיכת ה-RTL

ה-wrapper kivun-claude-bidi הוא מודול Node שמלפף סביב Claude Code. הוא מזהה רצפי טקסט בעברית בפלט ועוטף אותם בסימני BiDi של Unicode (RLE/PDF), כך שהם מוצגים בכיוון הנכון גם בטרמינלים שתמיכת ה-BiDi שלהם חלקית. בנוסף, הוא מחדיר RLM (U+200F) בתחילת כל שורה שהאות החזקה הראשונה שלה היא RTL - מה שמתקן את הבאג ב-Claude Code שבו ● שלום היה מופיע משמאל לימין במקום מימין לשמאל.

אופציונלי - עוקף לבעיית ה-bullet ב-Konsole 23.x: אם אתם על Konsole 23.x (ברירת המחדל ב-Ubuntu 24.04) ושורות bullet בעברית עדיין מופיעות LTR גם אחרי תיקון ה-RLM, ניתן להפעיל KIVUN_BIDI_STRIP_BULLET=on ב-config.txt (ברירת מחדל off). זה מסיר את ה-● מתחילת שורות עבריות, כך שהתו הראשון הוא עברית וה-BiDi מתהפך אוטומטית. המחיר: הסימן ● נעלם מ-bullet-lines בעברית (רק ההזחה נשארת). Konsole 24.04+ אמור לפתור את זה ב-upstream.

לפירוט מלא של האלגוריתם, ראו docs/specs/BIDI_ALGORITHM.md. למעקב אחרי הבאג ב-upstream של Anthropic, ראו anthropics/claude-code#39881. אם אתם רוצים לתרום תיעוד עברי לריפו הזה, יש מדריך מעשי ב-docs/HEBREW_RTL_GITHUB.md על איך לכתוב עברית שתעבוד נכון ב-GitHub.

🧰 ערכת הכלים

רכיבטכנולוגיהמטרה
התקנה ל-WindowsNSISהתקנה למשתמש בלבד עם בוטסטראפ של WSL/Ubuntu/Konsole
התקנה ל-LinuxBash + apt/dnf/pacman/zypperהתקנת חבילות מודעת-distro + פריסה לבית המשתמש
BiDi wrapperNode.js + node-ptyמעביר פלט Claude דרך מכונת מצבים של Unicode RLE/PDF/RLM
פרופיל KonsoleKDE Konsole .profile + .colorschemeערכת Kivun בתכלת + BidiEnabled=true
מפת שפותpayload/languages.sh משותףמפת --append-system-prompt ל-23 שפות, נטענת על ידי כל המשגרים
CI/CDGitHub Actionsבנייה אוטומטית של .exe ל-Windows + .tar.gz ל-Linux בכל tag

⚙️ קונפיגורציה

קובצי קונפיג לפי פלטפורמה (אותה סכמה ב-2):

פלטפורמהנתיב
Windows%LOCALAPPDATA%\Kivun-WSL\config.txt
Linux~/.config/Kivun-Terminal/config.txt
RESPONSE_LANGUAGE=hebrew         # 23+ שפות נתמכות
TEXT_DIRECTION=rtl               # rtl או ltr
KIVUN_BIDI_WRAPPER=on            # on (ברירת מחדל) או off
AUTO_INSTALL_CLAUDE=yes          # yes (ברירת מחדל) / ask / no
CLAUDE_FLAGS=                    # למשל --continue

ראו docs/CHANGELOG.md לרשימה המלאה של השפות הנתמכות וכל מפתחות ה-config.

🤝 לתרום לפרויקט

מוזמנים לעזור. תחומים שעזרה בהם תהיה שימושית במיוחד:

  • מתג מקלדת ל-Wayland - setxkbmap עובד רק ב-X11; Wayland דורש החלפת layout ספציפית לסביבת השולחן (KWin: qdbus org.kde.keyboard, GNOME: gsettings input-sources, Sway: ב-config). אין CI ל-Wayland; דרוש contributor עם החומרה.
  • כיסוי שפות RTL נוספות - N'Ko, Adlam, Mandaic, Samaritan ועוד מספר שפות נופלות כרגע ל-fallback של מפת ה-xkb של עברית. PRs שמוסיפים ערכים ל-payload/languages.sh מתקבלים בברכה.
  • התאמה ל-Konsole 25.x - workarounds של ה-BiDi wrapper (RLE/PDF/RLM) כויילו מול Konsole 23.08 ואומתו מחדש על 24.x. אם אתם על preview של 25.x ורואים תקלות בהצגת עברית, פתחו issue עם KONSOLE_VERSION ושורת דוגמה.
  • התקנה דרך pacman / zypper - ענפי Arch / openSUSE ב-linux/install.sh כתובים אבל נבדקו רק ידנית. ה-CI מכסה apt (Ubuntu 24.04) ו-dnf (Fedora 40) אוטומטית; pacman ו-zypper נבדקים רק בשטח.

מה ה-CI כבר מכסה

עשו fork לריפו, בצעו את השינויים, ופתחו PR.

🤝 פרויקטים קשורים בקהילת RTL-for-AI-tools

שישה מפתחים עצמאיים בנו פתרונות RTL לסביבות השונות של ה-AI tooling. העובדה שכולנו נאלצנו לכתוב פתרון userland נפרד מעידה לבדה על כמה זמן זה כבר נדחה ב-upstream:

הסביבות (DOM של דפדפן גנרי, ממשק הווב של Claude.ai, webview של VS Code / IDE, Microsoft Word, טרמינל) נפרדות זו מזו ברובן - בחרו את הפתרון שמתאים למקום שבו אתם נתקלים בבעיית ה-BiDi.

License

MIT


Ver o original no GitHub

Bom para

Relacionados