🌐 Agent RTL Fix

Universal BiDi (RTL/LTR) Formatting Standard & Typography for AI Coding Agents
Zero-token bloat, native Markdown preservation, and isolated LTR code blocks for Persian, Arabic, Urdu, and Hebrew.

⚡ Key Highlights

• Native BiDi Alignment: Completely eliminates inverted parentheses (), messed brackets [], and reversed paths (/ and \) when mixing English code with RTL languages.
• Zero Token Overhead: Pure wrapper syntax that doesn't waste LLM output tokens on redundant inline CSS styling.
• Non-Destructive: Doesn't overwrite your custom workspace configurations or force unwanted color themes.
• Multi-Agent Ready: Drop-in rules formatted for every leading AI coding environment.

💬 1-Prompt In-Chat Activation (No Terminal Needed)

You can activate this directly in your AI assistant's chat (Antigravity, Cursor, Windsurf, Claude Code, Copilot) without touching a terminal. Just copy and paste either prompt:

English Prompt:

Please read the universal BiDi formatting standard from:
https://raw.githubusercontent.com/dalroot/agent-rtl-fix/main/rules/AGENTS.md
and save it as an always-on rule in this workspace/environment.

لطفاً استاندارد راست‌چین‌سازی و فرمت‌بندی دوطرفه (BiDi/RTL) را از نشانی زیر بخوان و به عنوان قانون دائم (Always-on Rule) در این محیط/پروژه اعمال کن:
https://raw.githubusercontent.com/dalroot/agent-rtl-fix/main/rules/AGENTS.md

🚀 Quick Install via Terminal (1-Liner)

Running the installer script automatically installs Vazirmatn fonts, enables BiDi highlighting in your editor settings, and registers the global machine-wide rule for Antigravity (and project rules if run inside a repo):

Windows (PowerShell)

irm https://raw.githubusercontent.com/dalroot/agent-rtl-fix/main/install.ps1 | iex

Linux & macOS (Bash)

curl -fsSL https://raw.githubusercontent.com/dalroot/agent-rtl-fix/main/install.sh | bash

Offline / 1-Click

1. Download the latest agent-rtl-fix-v2.0.0.zip from Releases.
2. Extract and run install.bat (Windows) or bash install.sh (Linux/macOS).

🤖 Supported AI Agents Matrix

📁 Repository Structure

agent-rtl-fix/
├── .github/
│   └── workflows/
│       └── release.yml          # Automated release and zip packager
├── rules/                       # Modular rules for every agent
│   ├── antigravity.md           # Antigravity always_on global rule
│   ├── cursor.mdc               # Cursor IDE rule
│   ├── windsurf.rules           # Windsurf rules
│   ├── copilot-instructions.md  # GitHub Copilot instructions
│   ├── claude.md                # Claude Code instructions
│   ├── cline.md                 # Cline / Roo Code rules
│   └── AGENTS.md                # Universal AI Agent specification
├── fonts/                       # Core Vazirmatn typography (~500 KB)
│   └── Vazirmatn/
│       ├── Vazirmatn-Regular.ttf
│       ├── Vazirmatn-Medium.ttf
│       ├── Vazirmatn-SemiBold.ttf
│       └── Vazirmatn-Bold.ttf
├── scripts/
│   ├── install.ps1              # Modular Windows installer
│   ├── install.sh               # Modular Linux/macOS installer
│   ├── uninstall.ps1            # Windows cleanup script
│   └── uninstall.sh             # Linux/macOS cleanup script
├── install.bat                  # 1-Click Windows launcher
├── install.ps1                  # Root PowerShell installer
├── install.sh                   # Root Bash installer
├── LICENSE                      # MIT License
└── README.md

⚙️ The Core Formatting Rule

The standard universal instruction enforced across all agents:

- Whenever responding in RTL languages (Persian, Arabic, Urdu, Hebrew):
  1. Wrap the complete response inside <div dir="rtl">...</div>.
  2. Keep standard Markdown syntax for headings, bullet points, and tables.
  3. Keep all code blocks, logs, terminal outputs, and file paths strictly LTR.
  4. Never produce uncontained or left-aligned RTL text.

📜 License

This project is licensed under the MIT License. Free for open-source and commercial use.