Claude Code in VS Code - RTL Support for Hebrew & Arabic (+ Cursor)

Fixes reversed text and alignment issues in the "Claude Code in VS Code" extension for Hebrew and Arabic users. Works in both VS Code and Cursor.

---

🌍 בחר שפה | اختر اللغة

🇮🇱 עברית	🇸🇦 العربية
לקרוא בעברית ↓	اقرأ بالعربية ↓

---

✨ Key Features

• Automatic RTL Detection - Automatically detects Hebrew and Arabic text and applies right-to-left formatting
• VS Code & Cursor Support - Works with the "Claude Code in VS Code" extension in both VS Code and Cursor
• Zero Configuration - Works out of the box with a simple toggle button (⇄) in the chat interface
• Smart Text Handling - Keeps code blocks and technical content in LTR for proper readability
• Backup & Restore - Automatically creates backups before modifications, easy rollback available

---

🤔 Why This is Needed

The "Claude Code in VS Code" extension doesn't natively support RTL text direction. This causes:

• ❌ Hebrew and Arabic text appearing reversed and misaligned
• ❌ Chat conversations becoming hard to read for RTL language users
• ❌ Inconsistent text direction mixing with code blocks

This tool solves these issues by injecting CSS and JavaScript that intelligently handles RTL text while preserving code block formatting and maintaining compatibility with all versions of Claude Code.

---

🎯 Key Solutions

• Fixes Text Reversal - Ensures Hebrew and Arabic characters appear in the correct order and alignment
• Terminal Alignment - Automatically adjusts text direction in the Claude Code chat panel
• Claude Code Integration - Specifically tailored for the "Claude Code in VS Code" extension (works in Cursor too)
• Non-Invasive - Works by extending the existing UI without modifying core functionality

---

🇮🇱 עברית

תיאור

כלי Python שמוסיף תמיכה ב-RTL (Right-to-Left) לתוסף "Claude Code in VS Code", מאפשר עבודה נוחה עם שפות עברית וערבית בצ'אט של Claude. עובד גם ב-VS Code וגם ב-Cursor.

מה הכלי עושה?

הסקריפט מבצע את הפעולות הבאות:

1. מאתר אוטומטית את תיקיות ההתקנה של Claude Code (תומך ב-VS Code ו-Cursor על Windows, macOS ו-Linux)
2. מזריק CSS - מוסיף כללי עיצוב שהופכים את הטקסט לכיווניות RTL
3. מוסיף כפתור Toggle - יוצר כפתור (⇄) בממשק להפעלה/כיבוי של מצב RTL
4. שומר גיבויים - יוצר עותקי גיבוי של הקבצים המקוריים לפני כל שינוי
5. מאפשר הסרה - אפשרות לשחזר את המצב המקורי בקלות

דרישות מערכת

• Python 3.6+
• "Claude Code in VS Code" - התוסף חייב להיות מותקן (ב-VS Code או ב-Cursor)
• הרשאות לכתיבה לתיקיית ההרחבות (במקרה של Windows עשוי להידרש הרצה כמנהל)

התקנה ושימוש

שלב 1: הורדה

git clone https://github.com/yechielby/claude-code-rtl.git
cd claude-code-rtl

שלב 2: הרצת הסקריפט

Windows

python claude_code_rtl.py

macOS/Linux

python3 claude_code_rtl.py

שלב 3: תפריט אינטראקטיבי

לאחר הרצת הסקריפט יופיע תפריט:

=========================================================
  Claude Code in VS Code - RTL Text Support (+ Cursor)
=========================================================
  1. Add RTL support (all versions)
  2. Remove RTL support (all versions)
  3. Check status
  4. Exit
=========================================================

1. הוספת תמיכה ב-RTL - בחר אפשרות 1
2. הסרת תמיכה ב-RTL - בחר אפשרות 2
3. בדיקת סטטוס - בחר אפשרות 3 לראות האם RTL מותקן

שלב 4: אתחול VS Code / Cursor

לאחר ביצוע השינויים:

• סגור וטען מחדש את חלון VS Code / Cursor (או לחץ Ctrl+Shift+P → Developer: Reload Window)
• הכפתור ⇄ יופיע בממשק הצ'אט של Claude

איך להשתמש?

1. פתח את פאנל הצ'אט של Claude Code ב-VS Code / Cursor
2. לחץ על הכפתור ⇄ בראש הצ'אט
3. הממשק יעבור למצב RTL - טקסט יישר לימין
4. לחץ שוב על הכפתור כדי לחזור למצב LTR

מה משתנה במצב RTL?

מה הופך ל-RTL:

• ✅ הודעות המשתמש
• ✅ תשובות של Claude (טקסט רגיל)
• ✅ רשימות ופסקאות
• ✅ שאלות ותשובות בממשק

מה נשאר LTR:

• ✅ קוד (code blocks)
• ✅ כלים (tools) ותוצאותיהם
• ✅ בלוק Thinking
• ✅ פקודות slash
• ✅ כפתורים וממשק

הסרת התמיכה ב-RTL

אם ברצונך להסיר את השינויים:

1. הרץ את הסקריפט שוב
2. בחר אפשרות 2 מהתפריט
3. הסקריפט ישחזר את הקבצים המקוריים מהגיבוי
4. אתחל את VS Code / Cursor

מבנה הפרויקט

claude-code-rtl/
├── claude_code_rtl.py    # הסקריפט הראשי
└── README.md             # מדריך זה

פתרון בעיות

הסקריפט לא מוצא את הפלאגין

• וודא שהפלאגין מותקן: Extensions → חפש "Claude Code"
• נסה הרצה כמנהל (Windows): לחץ ימני → Run as Administrator

השינויים לא נראים

• אתחל את VS Code / Cursor: סגור לחלוטין ופתח מחדש
• או טען חלון מחדש: Ctrl+Shift+P → Developer: Reload Window

שגיאת הרשאות (Permission Denied)

• Windows: הרץ את CMD/PowerShell כמנהל
• macOS/Linux: השתמש ב-sudo python3 claude_code_rtl.py

RTL לא עובד טוב

• נקה מטמון: Ctrl+Shift+P → Developer: Reload Window
• בדוק גרסה: הסקריפט תומך בגרסאות עדכניות של Claude Code

טכנולוגיות

• Python 3 - שפת הסקריפט
• CSS - כללי עיצוב RTL
• JavaScript - לוגיקת כפתור ההחלפה
• VS Code / Cursor Extensions - אינטגרציה עם התוסף

תרומה לפרויקט

נשמח לתרומות! אפשר:

• 🐛 לדווח על באגים - פתח Issue
• ✨ להציע פיצ'רים - פתח Issue עם הצעה
• 🔧 לשלוח Pull Request - שפר את הקוד

רישיון

פרויקט זה מופץ תחת רישיון MIT - ראה קובץ LICENSE לפרטים.

יוצר

נוצר כדי לאפשר למשתמשי עברית וערבית לעבוד בצורה נוחה עם התוסף "Claude Code in VS Code" (ב-VS Code וב-Cursor).

קישורים

• Claude Code for VS Code
• VS Code
• Cursor

---

אם הכלי עזר לך, תן ⭐ לפרויקט!

---

🇸🇦 عربية

الوصف

أداة Python تضيف دعم RTL (من اليمين إلى اليسار) لإضافة "Claude Code in VS Code"، مما يتيح العمل بسهولة مع اللغات العربية والعبرية في محادثة Claude. تعمل في VS Code و Cursor.

ماذا تفعل الأداة؟

يقوم البرنامج بتنفيذ العمليات التالية:

1. يحدد تلقائيًا مجلدات تثبيت Claude Code (يدعم VS Code و Cursor على Windows و macOS و Linux)
2. يحقن CSS - يضيف قواعد تصميم تحول النص إلى اتجاه RTL
3. يضيف زر Toggle - ينشئ زرًا (⇄) في الواجهة لتفعيل/إيقاف وضع RTL
4. يحفظ نسخًا احتياطية - ينشئ نسخًا احتياطية من الملفات الأصلية قبل أي تعديل
5. يسمح بالإزالة - خيار لاستعادة الحالة الأصلية بسهولة

متطلبات النظام

• Python 3.6+
• "Claude Code in VS Code" - يجب أن يكون مثبتًا (في VS Code أو Cursor)
• صلاحيات الكتابة لمجلد الإضافات (في حالة Windows قد يتطلب التشغيل كمسؤول)

التثبيت والاستخدام

الخطوة 1: التنزيل

git clone https://github.com/yechielby/claude-code-rtl.git
cd claude-code-rtl

الخطوة 2: تشغيل البرنامج

Windows

python claude_code_rtl.py

macOS/Linux

python3 claude_code_rtl.py

الخطوة 3: القائمة التفاعلية

بعد تشغيل البرنامج ستظهر قائمة:

=========================================================
  Claude Code in VS Code - RTL Text Support (+ Cursor)
=========================================================
  1. Add RTL support (all versions)
  2. Remove RTL support (all versions)
  3. Check status
  4. Exit
=========================================================

1. إضافة دعم RTL - اختر الخيار 1
2. إزالة دعم RTL - اختر الخيار 2
3. فحص الحالة - اختر الخيار 3 لمعرفة ما إذا كان RTL مثبتًا

الخطوة 4: إعادة تشغيل VS Code / Cursor

بعد إجراء التغييرات:

• أغلق وأعد تحميل نافذة VS Code / Cursor (أو اضغط Ctrl+Shift+P → Developer: Reload Window)
• سيظهر الزر ⇄ في واجهة محادثة Claude

كيفية الاستخدام?

1. افتح لوحة محادثة Claude Code في VS Code / Cursor
2. اضغط على الزر ⇄ في أعلى المحادثة
3. ستتحول الواجهة إلى وضع RTL - سيتم محاذاة النص إلى اليمين
4. اضغط على الزر مرة أخرى للعودة إلى وضع LTR

ماذا يتغير في وضع RTL؟

ما يتحول إلى RTL:

• ✅ رسائل المستخدم
• ✅ إجابات Claude (نص عادي)
• ✅ القوائم والفقرات
• ✅ الأسئلة والأجوبة في الواجهة

ما يبقى LTR:

• ✅ الكود (code blocks)
• ✅ الأدوات (tools) ونتائجها
• ✅ كتلة Thinking
• ✅ أوامر slash
• ✅ الأزرار والواجهة

إزالة دعم RTL

إذا كنت ترغب في إزالة التغييرات:

1. شغّل البرنامج مرة أخرى
2. اختر الخيار 2 من القائمة
3. سيستعيد البرنامج الملفات الأصلية من النسخة الاحتياطية
4. أعد تشغيل VS Code / Cursor

هيكل المشروع

claude-code-rtl/
├── claude_code_rtl.py    # البرنامج الرئيسي
└── README.md             # هذا الدليل

حل المشاكل

البرنامج لا يجد الإضافة

• تأكد من تثبيت الإضافة: Extensions → ابحث عن "Claude Code"
• جرب التشغيل كمسؤول (Windows): انقر بزر الماوس الأيمن → Run as Administrator

التغييرات لا تظهر

• أعد تشغيل VS Code / Cursor: أغلق تمامًا وافتح من جديد
• أو أعد تحميل النافذة: Ctrl+Shift+P → Developer: Reload Window

خطأ في الصلاحيات (Permission Denied)

• Windows: شغّل CMD/PowerShell كمسؤول
• macOS/Linux: استخدم sudo python3 claude_code_rtl.py

RTL لا يعمل بشكل جيد

• امسح الذاكرة المؤقتة: Ctrl+Shift+P → Developer: Reload Window
• تحقق من الإصدار: يدعم البرنامج الإصدارات الحديثة من Claude Code

التقنيات

• Python 3 - لغة البرنامج
• CSS - قواعد تصميم RTL
• JavaScript - منطق زر التبديل
• VS Code / Cursor Extensions - التكامل مع الإضافة

المساهمة في المشروع

نرحب بالمساهمات! يمكنك:

• 🐛 الإبلاغ عن الأخطاء - افتح Issue
• ✨ اقتراح ميزات - افتح Issue مع الاقتراح
• 🔧 إرسال Pull Request - حسّن الكود

الترخيص

يتم توزيع هذا المشروع تحت ترخيص MIT - انظر ملف LICENSE للتفاصيل.

المؤلف

تم إنشاؤه لتمكين مستخدمي العربية والعبرية من العمل بشكل مريح مع إضافة "Claude Code in VS Code" (في VS Code و Cursor).

الروابط

• Claude Code for VS Code
• VS Code
• Cursor

---

إذا ساعدتك الأداة، امنح المشروع ⭐!

---

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing & Support: Contributions, bug reports, and feature requests are welcome! Please open an Issue or Pull Request on GitHub.