13 — Referencia

Configuración completa

Defaults, propiedades, ámbitos, aplicación y ejemplos válidos de configuración global y por proyecto.

v0.2.41Revisión de código · 2026-10-21

En esta página

Archivos y precedencia

La configuración global es un documento completo. El proyecto es un override parcial schemaVersion 3 y se fusiona recursivamente sobre global. Abre ambos desde la paleta y guarda con Ctrl+S para validar.

Ámbito	Ruta
Windows global	%APPDATA%\openeditorcode\config.json
Linux global	${XDG_CONFIG_HOME:-~/.config}/openeditorcode/config.json
Override de ubicación	OEC_CONFIG_DIR/config.json
Proyecto	<raíz>/.oec/config.json

Pantalla de ajustes

Abrir configuración muestra wrap, numeración, sintaxis, formato al guardar y perfil. ↑/↓ selecciona, ← global, → proyecto, Enter alterna/guarda, E abre JSON y Esc cierra. El JSON expone más opciones que esa pantalla.

Al guardar desde la pantalla en ámbito proyecto puede serializar casi toda la configuración efectiva, fijando valores antes heredados. Para un override mínimo edita el JSON.

Ejemplo mínimo de proyecto

Contenido completo de .oec/config.jsonjson

{
  "schemaVersion": 3,
  "editor": { "wrap": "word", "lineNumbers": true },
  "preview": { "markdownDefault": "source" }
}

Personalizar teclas

Edita keyboard.bindings dentro del documento global completo. La clave es el ID configurable del catálogo; cada array sustituye el fallback. [] desactiva la combinación. El parser acepta strings, pero no comprueba que un ID exista ni detecta colisiones.

Los modificadores se comparan exactamente. Usa nombres como ctrl, shift, alt y left. Enter/return se normalizan. F2, F10, los dos duplicados y H/D de historial tienen IDs configurables; Enter/Shift+Enter de los árboles siguen contextuales sin ID.

Fragmento: reemplaza keyboard en el JSON global completojson

"keyboard": {
  "profile": "default",
  "bindings": {
    "file.save": ["ctrl+s"],
    "editor.formatDocument": ["alt+shift+f"]
  }
}

Aplicación, migración y recuperación

Cambios guardados dentro de OEC actualizan preferencias reactivas; otros valores se capturan al construir capacidades y necesitan reiniciar. La referencia inferior distingue aplicación inmediata, reinicio e inicio. No hay watcher de configuración externa.

Global migra v1 → v2 → v3 en memoria. Un JSON incompatible puede generar config.bkp.json y defaults. El binario supervisa el primer frame y reintenta una vez ante determinados fallos tempranos. No recupera sesiones ni buffers.

Un global de más de 256 KiB falla antes de esa recuperación; un proyecto inválido al arrancar se ignora. El JSON Schema distribuido no sustituye al parser: esta referencia se contrasta con schema.ts y defaults.ts.

Referencia de propiedades

Todos los campos globales de fábrica, tokens de sintaxis y campos de formateadores externos. Los objetos dinámicos se describen por su estructura.

↓ Descargar JSON de fábrica

44 propiedades

`schemaVersion`

Validación

Versión obligatoria. Global admite migración desde 1/2; el override del proyecto exige 3.

De fábrica: 3
Admite: 3
Ámbito: Global y proyecto

`appearance.theme`

Al guardar en OEC

Único tema del chrome de la aplicación. Los tokens de sintaxis se personalizan por separado.

De fábrica: "oec-dark"
Admite: "oec-dark"
Ámbito: Global y proyecto

`appearance.language`

Al guardar en OEC

Idioma de la interfaz y mensajes; algunas etiquetas del Explorador siguen en español. La ayuda CLI y los mensajes del launcher usan detección automática.

De fábrica: "auto"
Admite: "auto" | "es" | "en"
Ámbito: Global y proyecto

`layout.explorerWidth`

Al guardar en OEC

Ancho del Explorador en columnas de terminal.

De fábrica: 40
Admite: 24–80
Ámbito: Global y proyecto

`layout.changesWidth`

Al guardar en OEC

Ancho del panel Git en columnas.

De fábrica: 44
Admite: 32–80
Ámbito: Global y proyecto

`layout.minEditorWidth`

Al guardar en OEC

Mínimo empleado al decidir si caben ambos laterales.

De fábrica: 60
Admite: 32–160
Ámbito: Global y proyecto

`layout.explorerStartup`

Al iniciar

Visibilidad inicial del Explorador.

De fábrica: "visible"
Admite: "visible" | "hidden"
Ámbito: Global y proyecto

`layout.changesStartup`

Al iniciar

Visibilidad inicial de Git; auto considera la disponibilidad y el ancho.

De fábrica: "auto"
Admite: "auto" | "visible" | "hidden"
Ámbito: Global y proyecto

`layout.narrowSidePanels`

Al guardar en OEC

En terminal estrecho mantiene un solo lateral.

De fábrica: "single"
Admite: "single"
Ámbito: Global y proyecto

`layout.findPanelMaxWidth`

Al guardar en OEC

Máximo de columnas del panel de búsqueda local.

De fábrica: 48
Admite: 24–80
Ámbito: Global y proyecto

`layout.diffOrientation`

Al guardar en OEC

Dos lados del diff en paralelo o apilados.

De fábrica: "auto"
Admite: "auto" | "horizontal" | "vertical"
Ámbito: Global y proyecto

`layout.diffStackBelow`

Al guardar en OEC

Auto apila por debajo de este ancho total del renderer, no del área central.

De fábrica: 120
Admite: 60–240
Ámbito: Global y proyecto

`editor.wrap`

Al guardar en OEC

Ajuste de línea persistente. Ctrl+L alterna el estado de sesión.

De fábrica: "none"
Admite: "none" | "word"
Ámbito: Global y proyecto

`editor.lineNumbers`

Al guardar en OEC

Muestra numeración lógica; las continuaciones envueltas no repiten número.

De fábrica: true
Admite: boolean
Ámbito: Global y proyecto

`editor.syntax.enabled`

Al guardar en OEC

Resaltado regex limitado a extensiones admitidas y 200.000 caracteres.

De fábrica: true
Admite: boolean
Ámbito: Global y proyecto