Kivun Terminal WSL
noambrand/kivun-terminal-wsl
Terminal Claude Code com renderização correta de 11 idiomas RTL
Ver no GitHubTerminal 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-wsl1 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
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 CLI | Kivun 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 languages | 0 | 11 (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, customMCP_*, …) are propagated throughWSLENVon Windows /exporton Linux so they reach the Claude Code session. Values are masked in the resolved-command preview by default for screenshot safety; click👁 show valuesto 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 (
#C8E6FFbackground) - easy on the eyes, on by default. Disable viaTERMINAL_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
- Download
Kivun_Terminal_Setup.exefrom the latest release. - Run it - follow the wizard. No admin rights required.
- 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.cmdfrom the latest release (or open "Kivun Diagnostics" from the Start menu if it installed) and double-click it. It savesKivun-Report.txtto 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
| Field | What it shows |
|---|---|
| Model | Active Claude model (color-coded: green = Opus, yellow = Sonnet/Haiku) |
| Context | % of context window consumed (green/yellow/red) |
| Tokens | Combined input + output tokens this session |
| Session / Weekly | Usage 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:
| Platform | What gets configured | File |
|---|---|---|
| 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.
| Fix | What it does | Solves | Default |
|---|---|---|---|
| RLE/PDF bracketing of Hebrew runs in LTR paragraphs | Wraps every Hebrew run in U+202B / U+202C only when the surrounding paragraph is LTR | Hebrew embedded in English needs an explicit direction marker; otherwise BiDi sees Hebrew chars as just another part of the LTR flow | on |
| Line-start RLM injection | Inserts U+200F at the start of any line whose first strong char is RTL | Fixes 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 Hebrew | Konsole 23.x classifies ● as a direction-anchoring neutral; without strip, lines stay LTR even with line-start RLM | on |
| 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/RLM | Stops upstream-emitted bidi controls from compounding with wrapper-injected RLM and producing nondeterministic positioning | auto |
| 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 run | Konsole's BiDi only runs within continuous-attribute regions; color changes split the BiDi run and Qt mispositions the resulting fragments | on |
| 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 line | Per-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 fix | off |
| 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 boundary | Claude 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 splitters | on (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=offto 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
| Component | Technology | Purpose |
|---|---|---|
| Windows installer | NSIS | Per-user install with WSL/Ubuntu/Konsole bootstrap |
| Linux installer | Bash + apt/dnf/pacman/zypper | Distro-aware package install + user-home deploy |
| BiDi wrapper | Node.js + node-pty | Pipes Claude output through Unicode RLE/PDF/RLM state machine |
| Konsole profile | KDE Konsole .profile + .colorscheme | Light-blue Kivun theme + BidiEnabled=true |
| Language map | Shared payload/languages.sh | 23-language --append-system-prompt map sourced by all launchers |
| CI/CD | GitHub Actions | Automated Windows .exe + Linux .tar.gz builds on tag |
Configuration
Per-platform config files (same schema across all three):
| Platform | Path |
|---|---|
| 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:
| Flag | What it does |
|---|---|
--model opus | force Claude Opus for this session (instead of the default) |
--model sonnet | force Claude Sonnet |
--continue | resume the most recent conversation in this folder |
--resume | open the conversation picker and pick which past chat to resume |
--dangerously-skip-permissions | skip 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 -
setxkbmapis 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.shwelcome. - 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.share 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
| Surface | Tested by CI | Workflow |
|---|---|---|
| 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-bidiNode 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 - seemac/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.
🧰 ערכת הכלים
| רכיב | טכנולוגיה | מטרה |
|---|---|---|
| התקנה ל-Windows | NSIS | התקנה למשתמש בלבד עם בוטסטראפ של WSL/Ubuntu/Konsole |
| התקנה ל-Linux | Bash + apt/dnf/pacman/zypper | התקנת חבילות מודעת-distro + פריסה לבית המשתמש |
| BiDi wrapper | Node.js + node-pty | מעביר פלט Claude דרך מכונת מצבים של Unicode RLE/PDF/RLM |
| פרופיל Konsole | KDE Konsole .profile + .colorscheme | ערכת Kivun בתכלת + BidiEnabled=true |
| מפת שפות | payload/languages.sh משותף | מפת --append-system-prompt ל-23 שפות, נטענת על ידי כל המשגרים |
| CI/CD | GitHub 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.