Instalación y actualización

Editor autónomo o plugin #

Los comandos de este capítulo instalan solamente OEC autónomo. El plugin para OpenCode 2 se instala aparte con @2jmalvarez/[email protected] dentro de un objeto package + options en cli.json global. Su guía explica la carpeta automática, localRoot opcional, F6/F7/F8, imágenes y la alternativa local.

OEC autónomo / Sin OpenCode ni servidorAmpliar captura ↗

Instalar con npm #

Requiere Node.js 18 o posterior y npm. El paquete raíz instala el launcher; una dependencia opcional de la plataforma aporta el binario. No necesitas Bun para usarlo.

• Los aliases oec y openeditorcode ejecutan el mismo launcher.
• El postinstall no descarga el binario: en Linux intenta restaurar el permiso ejecutable de la dependencia opcional. No omitas las dependencias de plataforma.

npm install -g openeditorcode
oec --version
oec

Instalación directa en Linux #

La vía documentada desde 0.2.24 necesita Bash, curl, sha256sum y utilidades estándar, pero no Node, npm ni Bun. Instala en ~/.local/bin y configura PATH para Bash, Zsh o Fish cuando corresponde.

• Comprueba SHA-256 y la versión reportada por el binario antes de instalar. No sustituye comandos ajenos y usa lock y rollback para reemplazos fallidos.
• Sin --version elige la última release estable de GitHub. --no-modify-path evita editar archivos de inicio, no evita instalar. --help o -h muestra ayuda.
• Reabre el shell. En Bash/Zsh puedes usar export PATH="$HOME/.local/bin:$PATH" para la sesión actual.

curl -fsSL https://raw.githubusercontent.com/2jmalvarez/openeditorcode/main/install.sh | bash

# Pin a published version and manage PATH yourself
curl -fsSL https://raw.githubusercontent.com/2jmalvarez/openeditorcode/main/install.sh | bash -s -- --version 0.2.33 --no-modify-path

Actualizar según el canal #

Con launcher npm y updates.checkOnStartup activo, OEC consulta el registro tras un segundo. Una versión nueva habilita Actualizar OEC en paleta. Gestiona cambios pendientes y termina con código 42. El launcher resuelve una versión exacta del registro público y copia el binario anterior antes de actualizar el mismo prefijo desde el que se ejecutó. Conserva el ámbito global o local, incluso con prefijos personalizados; en local usa --global=false, --no-save y --package-lock=false. Fuerza el registro público para OEC y @2jmalvarez sin editar .npmrc.

Verifica la versión del manifiesto principal, paquete de plataforma y ejecutable. Ante fallo de instalación o verificación relanza la copia anterior; luego limpia el temporal. Si no puede resolver la versión pública o crear la copia, reabre el binario anterior sin instalar. No restaura pestañas ni buffers. La instalación directa no usa este flujo: cierra OEC y repite el instalador.

Un launcher antiguo que falla con 404 en un registro privado no puede obtener su propia corrección mediante esa actualización fallida. Identifica primero el ejecutable y su prefijo con type -a oec npm y readlink -f en Bash; usa la reparación del manual fuente para actualizar únicamente ese prefijo. No ejecutes un npm install -g sin prefijo si podría afectar otra instalación.

Instalación directa en Windows / PowerShell #

PowerShell 5.1 o posterior, Windows x64; sin Node.js, npm, Bun ni administrador. Puedes descargar e inspeccionar el script antes de ejecutarlo. Elige un solo método de instalación para evitar comandos en conflicto.

• Descarga la última release estable y valida SHA-256 y la versión del ejecutable. Instala en %LOCALAPPDATA%\Programs\OpenEditorCode\bin, agrega esa carpeta al PATH del usuario sin duplicados y actualiza la sesión actual. No modifica PATH del sistema ni la política de ejecución.
• Instala oec, no el alias openeditorcode. -NoModifyPath evita cambiar PATH; permite ejecutar por ruta absoluta. Cierra OEC y repite el instalador para actualizar la misma instalación.
• Protege ejecutables ajenos o modificados mediante un marcador de propiedad. Si falla descarga o validación conserva la instalación anterior; no ejecuta npm.

& ([scriptblock]::Create((Invoke-WebRequest -UseBasicParsing 'https://raw.githubusercontent.com/2jmalvarez/openeditorcode/main/install.ps1').Content))
oec .

# Pin version without changing PATH
& ([scriptblock]::Create((Invoke-WebRequest -UseBasicParsing 'https://raw.githubusercontent.com/2jmalvarez/openeditorcode/main/install.ps1').Content)) -Version 0.2.41 -NoModifyPath
& "$env:LOCALAPPDATA\Programs\OpenEditorCode\bin\oec.exe" .

0.2.40: actualizar solo a releases completas #

Antes de ofrecer una actualización, OEC comprueba los metadatos y las URLs públicas exactas de descarga del launcher y del paquete de tu plataforma, con un presupuesto de 15 segundos. El launcher repite el control antes de instalar. Si falta una parte, conserva la instalación actual y permite reintentar más tarde; no alcanza con que latest anuncie una versión.

El workflow espera disponibilidad de ambos paquetes de plataforma antes de publicar el launcher y después verifica el conjunto completo. Las instalaciones directas siguen actualizándose repitiendo su instalador.

Desinstalar #

Se conserva la configuración del usuario. En Linux directo, elimina la entrada PATH del shell solo si ya no la necesitas. En Windows directo elimina únicamente oec.exe y .oec-install-ps1.sha256 de su carpeta de instalación y quita solo esa entrada del PATH del usuario desde Variables de entorno. No borres proyectos ni configuración.

# npm installation
npm uninstall -g openeditorcode

# Direct Linux installation only
rm -f "$HOME/.local/bin/oec" "$HOME/.local/bin/openeditorcode" "$HOME/.local/bin/.oec-install-sh.sha256"