Skip to content

About

Parche e instalador de compatibilidad GLIBC 2.27 (Ubuntu 18.04 / Peppermint 10) para Cursor IDE y Cursor Agent en Linux x86_64

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

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).


El Problema

En sistemas con glibc 2.27, la instalación y ejecución de Cursor falla por dos motivos:

  1. Bloqueo del paquete .deb en dpkg/apt: El archivo DEBIAN/control declara Depends: libc6 (>= 2.28), impidiendo la instalación estándar aunque el ejecutable principal de Electron sí sea compatible con glibc 2.27.

  2. Módulos nativos y binarios auxiliares enlazados contra GLIBC_2.28: Varios binarios ELF incluidos en Cursor IDE y en cursor-agent fallan 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.28 proviene únicamente de dos símbolos:

    • fcntl64@GLIBC_2.28 (en pty.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ébil STB_WEAK en binarios compilados con Rust como cursor-tunnel, code-tunnel, tree-chunk-napi.linux-x64-gnu.node, file_service.linux-x64-gnu.node y merkle-tree-napi.linux-x64-gnu.node): aunque la librería estándar de Rust (std::fs) define statx como símbolo débil con fallback automático cuando no existe, la entrada de versión GLIBC_2.28 en .gnu.version_r hace que el enlazador dinámico (ld.so) aborte antes de iniciar.

¿Qué hace este script?

fix_glibc_cursor.py resuelve tanto la instalación como el parcheo binario:

  1. 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 .deb oficial en ~/.local/share/cursor, crea el enlace simbólico ~/.local/bin/cursor y registra el lanzador de escritorio en ~/.local/share/applications/cursor.desktop.
  2. Reemplazo de fcntl64@GLIBC_2.28 → fcntl@GLIBC_2.2.5: En arquitecturas de 64 bits (x86_64), fcntl64 y fcntl son equivalentes a nivel de ABI. El script renombra fcntl64\0 a fcntl\0\0\0 en .dynstr y reasigna su índice en .gnu.version a GLIBC_2.2.5.
  3. Desvinculación de versión en el símbolo débil statx: En los binarios Rust que declaran w statx@GLIBC_2.28, cambia su índice en .gnu.version a 1 (VER_NDX_GLOBAL, símbolo débil sin versión) para que ld.so lo resuelva a NULL sin error y el runtime de Rust utilice su fallback nativo.
  4. Limpieza de .gnu.version_r (verneed): Desvincula el nodo GLIBC_2.28 de la lista enlazada Vernaux de libc.so.6 y decrementa vn_cnt.
  5. Soporte automático para cursor-agent: Si detecta ~/.local/share/cursor-agent, aplica el mismo parche a su binario node, cursor-agent-sea y módulos .node.
  6. Verificación con ldd -r: Comprueba cada binario parcheado para confirmar que no queden referencias a GLIBC_2.28 ni bibliotecas faltantes.

Nota: El script es idempotente (puedes ejecutarlo múltiples veces de forma segura; detecta si los archivos ya fueron parcheados).


Requisitos

  • SO / Arquitectura: Linux x86_64 con glibc 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)

Uso

1. Clonar el repositorio

git clone https://github.com/xaviware/cursor-glibc-patch.git
cd cursor-glibc-patch

2. Instalar desde un paquete .deb y aplicar el parche

Si descargaste cursor_*_amd64.deb en ~/Descargas (o ~/Downloads), ejecuta simplemente:

python3 fix_glibc_cursor.py

O especificando la ruta al archivo .deb:

python3 fix_glibc_cursor.py --deb ~/Descargas/cursor_3.30.8_amd64.deb

3. Re-aplicar el parche tras una actualización

Si Cursor IDE o cursor-agent se actualizan y sobrescriben sus binarios:

python3 fix_glibc_cursor.py

Licencia

Distribuido bajo la licencia MIT.

About

Parche e instalador de compatibilidad GLIBC 2.27 (Ubuntu 18.04 / Peppermint 10) para Cursor IDE y Cursor Agent en Linux x86_64

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages