Cursor Persian — RTL و فونت فارسی برای چت Cursor AI

Persian (Farsi) RTL + Vazirmatn font for Cursor AI Chat, Composer, Agent, and Plan.

نصب‌کنندهٔ یک‌کلیکی برای:

• راست‌چین خودکار (RTL) پیام‌های فارسی در چت Cursor
• فونت فارسی Vazirmatn در Chat / Composer / Plan
• تنظیمات پیشنهادی بدون خراب کردن فونت ترمینال

Ideal for Iranian and Persian-speaking developers using Cursor.
مناسب برنامه‌نویسان فارسی‌زبان که با Cursor کار می‌کنند.

---

Keywords / جستجو

Cursor Persian · Cursor Farsi · Cursor RTL · Cursor فارسی · فونت فارسی Cursor · Vazirmatn Cursor · راستچین چت Cursor · Cursor AI Arabic Persian RTL

---

Why this exists?

Cursor’s AI chat is LTR by default. Persian (and Arabic/Hebrew) replies look left-aligned and mixed English+Persian lines scramble. Official RTL support is still missing; this kit wires the community Cursor RTL extension with a Persian font overlay and safe settings.

کرسر به‌صورت پیش‌فرض چت را LTR نشان می‌دهد. این کیت RTL رسمی جامعه را با فونت فارسی و settings امن ترکیب می‌کند.

---

Features

Feature	Description
One-click install	install.ps1 / install.sh
Auto RTL	Persian messages right-aligned; English stays LTR
Vazirmatn	Chat/Composer/Plan use Persian UI font
Terminal safe	Terminal keeps monospace (Consolas) — not Vazirmatn
Non-destructive	Backups rtl.js and settings.json before patching
Upstream-friendly	Not a full fork — patches official Cursor RTL VSIX

---

Installation

Windows (recommended)

git clone https://github.com/hbadri-dev/cursor-persian.git
cd cursor-persian
Set-ExecutionPolicy -Scope Process Bypass
.\install.ps1

One-liner (after this repo is public):

$env:CURSOR_PERSIAN_ZIP_URL = "https://github.com/hbadri-dev/cursor-persian/archive/refs/heads/main.zip"
irm https://raw.githubusercontent.com/hbadri-dev/cursor-persian/main/install.ps1 | iex

macOS / Linux

git clone https://github.com/hbadri-dev/cursor-persian.git
cd cursor-persian
chmod +x install.sh
./install.sh

Install Vazirmatn if needed:

# macOS
brew install font-vazirmatn

After install

1. If status bar is not RTL: ON:
   Ctrl+Shift+P → Cursor RTL: Enable RTL / Fix After Update
2. Ctrl+Shift+P → Developer: Reload Window

---

What the installer does

1. Downloads and installs the latest official Cursor RTL VSIX
2. Installs Vazirmatn (Windows user fonts; uses bundled TTFs when present)
3. Injects Persian chat CSS into rtl.js (Chat / Composer / Plan only)
4. Merges recommended settings.json keys (editor + markdown + terminal monospace)

---

Uninstall font overlay

.\uninstall.ps1
.\uninstall.ps1 -RestoreSettingsBackup   # optional

Does not remove Cursor RTL. To disable RTL: Cursor RTL: Disable RTL Support or:

cursor --uninstall-extension motcke.cursor-rtl

---

Troubleshooting

Problem	Fix
RTL gone after Cursor update	Cursor RTL: Enable RTL / Fix After Update
Font gone after RTL extension update	Re-run .\install.ps1 or .\scripts\apply-font-patch.ps1
cursor not found	Install Cursor; add CLI to PATH
Persian font missing in chat	Reload Window; confirm Vazirmatn is installed
Terminal looks broken / uneven	Ensure terminal.integrated.fontFamily is monospace (installer sets Consolas)

---

Project layout

install.ps1 / install.sh
uninstall.ps1
patches/persian-chat-fonts.css
patches/recommended-settings.json
scripts/apply-font-patch.ps1
scripts/apply-settings.ps1
scripts/install-vazirmatn.ps1
assets/vazirmatn/          # OFL fonts (optional offline)

---

Credits & licenses

Component	License	Source
This kit (scripts)	MIT	this repository
Cursor RTL extension	Apache-2.0	motcke/cursor-ext-rtl
Vazirmatn font	OFL-1.1	rastikerdar/vazirmatn

See NOTICE.md and LICENSE.

---

Contributing

Issues and PRs welcome — especially Windows/macOS/Linux install edge cases and Cursor version compatibility notes.

---

Star this repo

If Cursor Persian RTL helps your workflow, a ⭐ helps others find it in GitHub search (cursor persian, cursor farsi, cursor rtl).