https://github.com/user-attachments/assets/f2e8722d-3aeb-47d3-a37e-c33b6a89676e
---
Antigravity RTL adds seamless Right-to-Left (RTL) support and typography controls to **Antigravity (Standalone App)** and **Antigravity IDE** (VS Code Edition). It adjusts text direction naturally as you type and read, while keeping code blocks, terminal, and editors left-to-right.
## Features
- **Supports Both Antigravity & Antigravity IDE**: Smart auto-detection or interactive selection for both standalone Antigravity and the VS Code-based Antigravity IDE.
- **Natural text direction:** Chat, input fields, and agent views adapt dynamically. Use **Force RTL** when you want everything right-aligned.
- **Code & Terminal stay LTR**: Code blocks, Monaco editor, and terminal remain left-to-right with customizable code fonts.
- **Typography your way:** Choose separate fonts for Persian/Arabic, English, and Code. Vazirmatn is embedded offline; font size and line height can be adjusted live.
- **Quick controls:** Title-bar menu in Standalone App and UI widget in IDE, toggleable via `⌥R` on macOS / `Alt+R` on Windows and Linux.
Settings are saved in `~/.antigravity-rtl.json` and restored when you reopen the app.
## Install
Follow the steps for your operating system. Node.js **22.12 or newer** is required; you don't need to clone this repository.
> **Before running the patch:** Close Antigravity / Antigravity IDE if open.
### macOS
1. Node.js must be installed (`brew install node` or from [nodejs.org](https://nodejs.org/)).
2. In Terminal, run:
```bash
npx antigravity-rtl
```
3. If you see *Permission Denied*, enable **App Management** for your terminal in **System Settings → Privacy & Security → App Management**, then run the command again.
### Linux
1. Node.js must be installed (`sudo apt install nodejs npm`).
2. In a terminal, run:
```bash
sudo npx antigravity-rtl
```
*(If your Antigravity IDE is in user directories like `~/Downloads`, `sudo` is not needed: `npx antigravity-rtl --ide`)*
### Windows
1. In PowerShell (Run as Administrator), run:
```powershell
npx antigravity-rtl
```
### CLI Options & Flags
| Command | Description |
| :--- | :--- |
| `npx antigravity-rtl` | **Auto-detect & patch**: patches both Antigravity & Antigravity IDE if found, or the installed one |
| `npx antigravity-rtl --ide` | Directly patch Antigravity IDE only |
| `npx antigravity-rtl --app` | Directly patch Antigravity Standalone App only |
| `npx antigravity-rtl --restore` | Revert changes and restore original backups for all detected apps |
| `npx antigravity-rtl --restore --ide` | Revert changes and restore Antigravity IDE only |
| `npx antigravity-rtl --restore --app` | Revert changes and restore Antigravity Standalone App only |
| `npx antigravity-rtl --path "/path/to/app"` | Specify a custom path: the IDE directory, or the Standalone App's `app.asar` file |
| `npx antigravity-rtl --browser` | Install the Remote Control extension folder (Chrome / Arc) |
Remote Control opens this UI in the browser, inside a cross-origin iframe. The desktop patch cannot reach it. `--browser` writes an unpacked Chrome/Arc extension that injects the same RTL engine into that iframe. Load the printed folder from the extensions page (Developer Mode → Load unpacked), then reload the remote tab.
## فارسی
**خواندن و نوشتن فارسی در Antigravity و Antigravity IDE، بدون به‌هم‌ریختن متن انگلیسی و کد.**
Antigravity RTL یک ابزار خط فرمان برای افزودن پشتیبانی راست‌به‌چپ و تنظیمات تایپوگرافی به هر دو نسخهٔ **Antigravity (اپلیکیشن مستقل)** و **Antigravity IDE (نسخه مبتنی بر VS Code)** است.
### امکانات
- **پشتیبانی دوگانه (Antigravity و Antigravity IDE)**: شناسایی خودکار یا منوی تعاملی برای انتخاب بین نسخه مستقل و IDE.
- **جهت‌دهی خودکار متن:** چیدمان پیام‌های چت، ورودی‌ها و پرامپت‌ها بر اساس زبان متن راست‌چین یا چپ‌چین می‌شود.
- **ایزولاسیون کد و ترمینال:** بلوک‌های کد، ادیتور Monaco و محیط ترمینال با پشتیبانی از انتخاب فونت کد کاملاً چپ‌چین (LTR) باقی می‌مانند.
- **تایپوگرافی دلخواه:** تعیین فونت مجزا برای متون فارسی/عربی، انگلیسی و کد به همراه فونت توکار **وزیرمتن (Vazirmatn Variable)** بدون وابستگی به اینترنت.
- **دسترسی سریع:** پنل تنظیمات در برنامه و کلید میانبر `⌥R` در مک یا `Alt+R` در ویندوز و لینوکس.
### گزینه‌ها و فلگ‌های خط فرمان
| دستور | توضیحات |
| :--- | :--- |
| `npx antigravity-rtl` | **تشخیص و پچ خودکار**: در صورت وجود هر دو برنامه، هر دو پچ می‌شوند؛ در غیر این صورت برنامهٔ موجود پچ می‌شود |
| `npx antigravity-rtl --ide` | فقط پچ مستقیم نسخهٔ Antigravity IDE |
| `npx antigravity-rtl --app` | فقط پچ مستقیم نسخهٔ مستقل Antigravity |
| `npx antigravity-rtl --restore` | بازگردانی به نسخه اصلی برای تمام برنامه‌های شناسایی‌شده |
| `npx antigravity-rtl --restore --ide` | فقط بازگردانی Antigravity IDE به نسخه اصلی |
| `npx antigravity-rtl --restore --app` | فقط بازگردانی نسخه مستقل Antigravity به نسخه اصلی |
| `npx antigravity-rtl --path "/path/to/app"` | مشخص کردن مسیر دلخواه: پوشهٔ IDE، یا فایل `app.asar` نسخهٔ مستقل |
| `npx antigravity-rtl --browser` | نصب پوشهٔ افزونهٔ Remote Control برای کروم و Arc |
Remote Control همان رابط را داخل یک iframe با دامنهٔ جدا در مرورگر باز می‌کند و پچ دسکتاپ به آن نمی‌رسد. `--browser` یک افزونهٔ unpacked می‌سازد؛ پوشهٔ چاپ‌شده را از صفحهٔ افزونه‌ها با Developer Mode بارگذاری کنید و تب ریموت را رفرش کنید.
### نصب
1. **مک (macOS):**
```bash
npx antigravity-rtl
```
*(در صورت خطای دسترسی، تیک App Management را در تنظیمات حریم خصوصی مک برای ترمینال فعال کنید)*
2. **لینوکس (Linux):**
```bash
sudo npx antigravity-rtl
```
3. **ویندوز (Windows):**
PowerShell را با دسترسی Administrator باز کرده و اجرا کنید:
```powershell
npx antigravity-rtl
```
### بازگردانی به حالت اولیه (Uninstall)
برنامه‌ها را ببندید و فلگ `--restore` (یا `-r`) را اجرا کنید:
```bash
npx antigravity-rtl --restore
```
*(یا برای بازگردانی فقط یک برنامهٔ خاص: `npx antigravity-rtl --restore --ide`)*
### پروژه‌های الهام‌گرفته از این پروژه
ابزارها و افزونه‌های متن‌بازی که از ایده، کد یا رابط کاربری Antigravity RTL الهام گرفته و اقتباس کرده‌اند:
- [**qoder-rtl**](https://github.com/Pezhm4n/qoder-rtl): ابزار راست‌چین‌سازی چت دسکتاپ Qoder با الهام از Antigravity RTL.
- [**MarkdownRTL**](https://github.com/mahdiasd/MarkdownRTL): افزونهٔ محیط‌های توسعه JetBrains برای پیش‌نمایش متون راست‌چین Markdown با اقتباس از کنترلر شناور و طراحی این پروژه.
برای گزارش مشکل یا پیشنهاد تغییر، [Issue ثبت کنید](https://github.com/mmnaderi/antigravity-rtl/issues) یا [Pull Request بفرستید](https://github.com/mmnaderi/antigravity-rtl/pulls).
