Cursor IDE & Cursor Agent — Parche e Instalador de Compatibilidad GLIBC 2.27 (Ubuntu 18.04 / Peppermint 10)
Script en Python (sin dependencias externas) para instalar y ejecutar Cursor IDE (y Cursor Agent CLI) en distribuciones Linux con GLIBC 2.27 (como Ubuntu 18.04 LTS, Peppermint OS 10, Linux Mint 19.x o Debian Buster/Stretch).
En sistemas con glibc 2.27, la instalación y ejecución de Cursor falla por dos motivos:
-
Bloqueo del paquete
.debendpkg/apt: El archivoDEBIAN/controldeclaraDepends: libc6 (>= 2.28), impidiendo la instalación estándar aunque el ejecutable principal de Electron sí sea compatible conglibc 2.27. -
Módulos nativos y binarios auxiliares enlazados contra
GLIBC_2.28: Varios binarios ELF incluidos en Cursor IDE y encursor-agentfallan al cargar con:version `GLIBC_2.28' not found (required by .../pty.node) version `GLIBC_2.28' not found (required by .../vscode-sqlite3.node) version `GLIBC_2.28' not found (required by .../better_sqlite3.node) version `GLIBC_2.28' not found (required by .../resources/helpers/node) version `GLIBC_2.28' not found (required by .../tree-chunk-napi.linux-x64-gnu.node) version `GLIBC_2.28' not found (required by .../bin/cursor-tunnel)Específicamente, la dependencia de
GLIBC_2.28proviene únicamente de dos símbolos:fcntl64@GLIBC_2.28(enpty.node,vscode-sqlite3.node,better_sqlite3.node,node_sqlite3.node,helpers/node,cursor-agent-sea): afecta la terminal integrada, la base de datos SQLite de estado del IDE y el runtime auxiliar de Node.js.statx@GLIBC_2.28(símbolo débilSTB_WEAKen binarios compilados con Rust comocursor-tunnel,code-tunnel,tree-chunk-napi.linux-x64-gnu.node,file_service.linux-x64-gnu.nodeymerkle-tree-napi.linux-x64-gnu.node): aunque la librería estándar de Rust (std::fs) definestatxcomo símbolo débil con fallback automático cuando no existe, la entrada de versiónGLIBC_2.28en.gnu.version_rhace que el enlazador dinámico (ld.so) aborte antes de iniciar.
fix_glibc_cursor.py resuelve tanto la instalación como el parcheo binario:
- Instalación en espacio de usuario (
~/.local/share/cursor): Si Cursor aún no está instalado (o si se pasa--deb /ruta/a/cursor_amd64.deb), extrae automáticamente el paquete.deboficial en~/.local/share/cursor, crea el enlace simbólico~/.local/bin/cursory registra el lanzador de escritorio en~/.local/share/applications/cursor.desktop. - Reemplazo de
fcntl64@GLIBC_2.28→fcntl@GLIBC_2.2.5: En arquitecturas de 64 bits (x86_64),fcntl64yfcntlson equivalentes a nivel de ABI. El script renombrafcntl64\0afcntl\0\0\0en.dynstry reasigna su índice en.gnu.versionaGLIBC_2.2.5. - Desvinculación de versión en el símbolo débil
statx: En los binarios Rust que declaranw statx@GLIBC_2.28, cambia su índice en.gnu.versiona1(VER_NDX_GLOBAL, símbolo débil sin versión) para queld.solo resuelva aNULLsin error y el runtime de Rust utilice su fallback nativo. - Limpieza de
.gnu.version_r(verneed): Desvincula el nodoGLIBC_2.28de la lista enlazadaVernauxdelibc.so.6y decrementavn_cnt. - Soporte automático para
cursor-agent: Si detecta~/.local/share/cursor-agent, aplica el mismo parche a su binarionode,cursor-agent-seay módulos.node. - Verificación con
ldd -r: Comprueba cada binario parcheado para confirmar que no queden referencias aGLIBC_2.28ni bibliotecas faltantes.
Nota: El script es idempotente (puedes ejecutarlo múltiples veces de forma segura; detecta si los archivos ya fueron parcheados).
- SO / Arquitectura: Linux
x86_64conglibc 2.27 - Python: Python 3.6+ (solo utiliza librería estándar)
- Ruta por defecto del IDE:
~/.local/share/cursor(también soporta/usr/share/cursor)
git clone https://github.com/xaviware/cursor-glibc-patch.git
cd cursor-glibc-patchSi descargaste cursor_*_amd64.deb en ~/Descargas (o ~/Downloads), ejecuta simplemente:
python3 fix_glibc_cursor.pyO especificando la ruta al archivo .deb:
python3 fix_glibc_cursor.py --deb ~/Descargas/cursor_3.30.8_amd64.debSi Cursor IDE o cursor-agent se actualizan y sobrescriben sus binarios:
python3 fix_glibc_cursor.pyDistribuido bajo la licencia MIT.