JamalMohafil/claude-skills

Claude Arabic Terminal

La terminal de VS Code (xterm.js) no puede renderizar scripts de derecha a izquierda: el árabe aparece con letras desconectadas y orden de palabras invertido, y ninguna configuración lo soluciona. Esta habilidad instala una pequeña extensión de VS Code que ejecuta Claude Code en un pseudo-terminal, mantiene la pantalla en un emulador de terminal sin interfaz gráfica y lo renderiza como HTML dentro de VS Code — así el motor del navegador se encarga del moldeado del árabe y la bidireccionalidad, exactamente como en claude.ai.

Repositorio: https://github.com/JamalMohafil/claude-arabic-terminal

Tu trabajo

Ejecuta el instalador para el sistema operativo del usuario, verifica que funcionó, y termina diciéndole el único comando que necesitará de ahora en adelante: arabic claude.

Pasos

1. Verifica los prerrequisitos (detente e informa al usuario si falta alguno)

• git, node (18+), npm — git --version, node -v, npm -v
• Claude Code CLI — claude --version
• VS Code con el comando code — code --version (si falta code en macOS: VS Code → Cmd+Shift+P → "Shell Command: Install 'code' command in PATH")

2. Ejecuta el instalador

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/JamalMohafil/claude-arabic-terminal/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/JamalMohafil/claude-arabic-terminal/main/install.ps1 | iex

El instalador clona el repositorio en ~/.claude-arabic-terminal, ejecuta npm install, vincula la extensión en ~/.vscode/extensions/ y coloca el lanzador arabic en ~/.local/bin (agregado a PATH si es necesario). Volver a ejecutarlo actualiza una instalación existente.

Si curl/irm está bloqueado, clona el repositorio manualmente y ejecuta ./install.sh o .\install.ps1 desde su interior.

3. Verifica

• ls ~/.vscode/extensions | grep claude-arabic (Windows: dir $env:USERPROFILE\.vscode\extensions) muestra jamal.claude-arabic-terminal-<version>
• command -v arabic (Windows: Get-Command arabic) se resuelve — si no, el usuario debe abrir una nueva terminal para que PATH se actualice
• ls ~/.claude-arabic-terminal/node_modules/node-pty/prebuilds lista darwin-* / win32-*

4. Dile al usuario exactamente esto

1. Recarga VS Code: Cmd/Ctrl+Shift+P → "Developer: Reload Window"

2. De ahora en adelante, en cualquier terminal de VS Code, ejecuta:

   arabic claude
   

   Todas las banderas de Claude Code se pasan sin cambios: arabic claude --dangerously-skip-permissions, arabic claude --resume, arabic claude --model opus

3. En el primer lanzamiento aparece "¿Permitir que 'Claude Arabic Terminal' abra esta URI?" — marca "No volver a preguntarme para esta extensión" y haz clic en Abrir.

Claude Code se abre como un panel compatible con árabe dentro del área de terminal de VS Code, ejecutándose en la carpeta desde la que se lanzó el comando.

Solución de problemas

Síntoma	Solución
arabic: command not found	Abre una terminal nueva (PATH se acaba de actualizar), o ejecuta ~/.local/bin/arabic claude
Aparece el diálogo de URI pero no se abre nada	VS Code no se ha recargado desde la instalación — Developer: Reload Window
"claude exited with code 1" inmediatamente	Ejecuta claude en una terminal normal primero para completar el inicio de sesión / confiar en la carpeta
La extensión no carga en macOS (posix_spawnp failed)	chmod +x ~/.claude-arabic-terminal/node_modules/node-pty/prebuilds/*/spawn-helper
¿Quieres que sea una pestaña de editor en lugar del área de terminal?	Paleta de comandos → "Claude Arabic Terminal: Open in Editor Tab"

Desinstalar

rm -rf ~/.claude-arabic-terminal ~/.vscode/extensions/jamal.claude-arabic-terminal-* ~/.local/bin/arabic