codex-rtl 1.0.0 → 1.0.1

package/README.md

@@ -17,12 +17,19 @@ This CLI tool automatically injects a sophisticated RTL engine into Codex, addin
 
 You don't need to download any files. Just run the following command in your terminal:
 
-### macOS / Linux
-Because the tool needs to modify the Codex application files, you must run it with `sudo`:
+### macOS
+Simply run:
+```bash
+npx codex-rtl
+```
+> **First time?** If you get a "Permission Denied" error, the tool will **automatically open** the App Management settings page for you. Just enable the toggle for your terminal app, then run the command again. No `sudo` needed!
+>
+> You can also grant permission manually: `System Settings > Privacy & Security > App Management`.
+
+### Linux
 ```bash
 sudo npx codex-rtl
 ```
-> **macOS Users:** If you get a "Permission Denied" error even with sudo, ensure your terminal (e.g. Terminal, iTerm2, VS Code) has **App Management** permissions enabled in `System Settings > Privacy & Security > App Management`.
 
 ### Windows
 Open **PowerShell** or **Command Prompt** as **Administrator** (Right-click -> Run as Administrator), then run:
@@ -40,9 +47,9 @@ npx codex-rtl
 If you ever want to revert Codex back to its original state (before the patch), simply run the command with the `--restore` flag:
 
 ```bash
-sudo npx codex-rtl --restore
+npx codex-rtl --restore
 ```
-*(On Windows, run without `sudo` in an Administrator terminal)*
+*(On Linux, run with `sudo`. On Windows, run in an Administrator terminal)*
 
 ## How it works
 
@@ -81,12 +88,19 @@ Feel free to open issues or submit pull requests. Let's make Codex accessible an
 
 بدون نیاز به دانلود هیچ فایلی، فقط کافیست دستور زیر را در ترمینال سیستم خود اجرا کنید:
 
-### در مک (macOS) و لینوکس
-از آنجایی که این ابزار قرار است فایل‌های سیستمی Codex را ویرایش کند، باید حتماً دسترسی `sudo` داشته باشد:
+### در مک (macOS)
+کافیست دستور زیر را اجرا کنید:
+```bash
+npx codex-rtl
+```
+> **اولین بار؟** اگر خطای Permission Denied دریافت کردید، ابزار به صورت **خودکار** صفحهٔ تنظیمات App Management را برای شما باز می‌کند. فقط سوئیچ ترمینال خود (مثلاً Terminal، iTerm2 یا VS Code) را فعال کنید و دوباره دستور را اجرا کنید. نیازی به `sudo` نیست!
+>
+> همچنین می‌توانید به صورت دستی به مسیر `System Settings > Privacy & Security > App Management` بروید.
+
+### در لینوکس
 ```bash
 sudo npx codex-rtl
 ```
-> **کاربران مک (macOS):** اگر با وجود استفاده از sudo باز هم خطای Permission Denied دریافت کردید، باید به ترمینال خود (مثل Terminal، iTerm2 یا VS Code) دسترسی **App Management** بدهید. برای این کار به مسیر `System Settings > Privacy & Security > App Management` بروید و دسترسی ترمینال خود را فعال کنید.
 
 ### در ویندوز
 برنامهٔ **PowerShell** یا **Command Prompt** را در حالت **Administrator** (راست‌کلیک -> Run as Administrator) باز کنید و دستور زیر را بنویسید:
@@ -104,9 +118,9 @@ npx codex-rtl
 اگر زمانی خواستید Codex را به حالتِ اولیه (قبل از نصب این پچ) برگردانید، فقط کافیست دستور بالا را با فلگ `--restore` اجرا کنید:
 
 ```bash
-sudo npx codex-rtl --restore
+npx codex-rtl --restore
 ```
-*(کاربران ویندوز این دستور را بدون `sudo` و در یک ترمینال ادمین اجرا کنند)*
+*(در لینوکس با `sudo` اجرا کنید. کاربران ویندوز این دستور را در یک ترمینال ادمین اجرا کنند)*
 
 ## این ابزار چگونه کار می‌کند؟
 

package/bin/index.js

@@ -7,6 +7,7 @@ import picocolors from 'picocolors';
 import ora from 'ora';
 import prompts from 'prompts';
 import * as asar from '@electron/asar';
+import { execSync } from 'child_process';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -16,6 +17,21 @@ const pkgPath = path.join(__dirname, '..', 'package.json');
 const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
 console.log(bold(cyan(`\n✨ Codex Smart RTL Patcher v${pkg.version}\n`)));
 
+function handleMacPermissionError(err) {
+    if (os.platform() === 'darwin') {
+        console.error(yellow('\nOn macOS, you can either:'));
+        console.error(yellow('  1. Grant your terminal "App Management" permission to run without sudo.'));
+        console.error(yellow('  2. Or, run this command with sudo (e.g. sudo npx codex-rtl)'));
+        console.log(blue('\nOpening System Settings directly to App Management for you...'));
+        try {
+            execSync('open "x-apple.systempreferences:com.apple.settings.PrivacySecurity.extension?Privacy_AppBundles"');
+            console.log(green('✔ Settings opened! Please enable the toggle for your terminal, then try again.\n'));
+        } catch (e) {
+            console.error(yellow('To open manually, go to: System Settings > Privacy & Security > App Management\n'));
+        }
+    }
+}
+
 function getDefaultPath() {
     if (os.platform() === 'darwin') {
         return '/Applications/Codex.app/Contents/Resources/app.asar';
@@ -68,6 +84,7 @@ async function main() {
         } catch (e) {
             spinner.fail('Failed to restore.');
             console.error(red(e.message));
+            handleMacPermissionError(e);
             process.exit(1);
         }
     }
@@ -84,10 +101,7 @@ async function main() {
         if (os.platform() === 'win32') {
             console.error(yellow('\nPlease run your terminal (PowerShell/CMD) as Administrator and try again.\n'));
         } else if (os.platform() === 'darwin') {
-            console.error(yellow('\nPlease ensure you run this command with sudo (if required).'));
-            console.error(yellow('On macOS, you might also need to give your terminal "App Management" permission.'));
-            console.error(yellow('Go to: System Settings > Privacy & Security > App Management'));
-            console.error(yellow('And enable the toggle for your terminal, then try again.\n'));
+            handleMacPermissionError(e);
         } else {
             console.error(yellow('\nPlease run this command with sudo.\n'));
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-rtl",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "A smart RTL (Right-to-Left) patcher with UI settings for the Codex application.",
   "main": "./bin/index.js",
   "bin": {