Mapea el proyecto
Explora un árbol virtualizado y ordena textos por cantidad de líneas, excluyendo rutas ignoradas por .gitignore de raíz y anidados.
OOOO EEEEEE CCCCC O O EE CC O O EEEE CC O O EE CC OOOO EEEEEE CCCCC
OpenEditorCode
OpenEditorCode es un editor centrado en el teclado para explorar, editar, buscar y revisar cambios Git sin salir de la terminal.
UN ESPACIO, CUATRO RITMOS
Todo el proyecto, siempre al alcance.
OEC mantiene juntas las operaciones que dan forma a una sesión de código, mientras el proyecto permanece local.
Trabaja el documento
Edita en pestañas, formatea fuentes, lee Markdown enriquecido y alterna preview SVG/XML con F4.
Encuentra el camino
Mantén un filtro jerárquico por nombre/contenido en el Explorador o usa búsqueda avanzada, respetando .gitignore.
Lee el cambio
Selecciona repositorios Git anidados, prepara, confirma, sincroniza e inspecciona diffs e historial.
HECHO PARA LA RAÍZ DEL PROYECTO
Límites útiles. Menos sorpresas.
Local por diseño
Edita localmente sin OpenCode ni servidor. Los remotos Git y las actualizaciones usan red cuando se solicitan o están habilitados.
Archivos protegidos
Los helpers de documentos validan rutas y rechazan binarios, UTF-8 inválido y textos demasiado grandes. La referencia explica su alcance.
Tu configuración
La configuración global vive fuera de los proyectos. Cada proyecto puede sobrescribir preferencias en .oec/config.json.
Teclado completo
Explorador, editor, búsqueda, diálogos y cambios Git se pueden usar sin ratón.
OEC en acciónOEC 0.2.43
Grabación real con atajos visibles: editar y guardar, revisar el diff Git, alternar Markdown con F4 y ordenar archivos masivos por líneas. Excluye rutas ignoradas por .gitignore de raíz y anidados.
Versión en texto
- Abrir src/greeting.ts desde el explorador.
- Cambiar Hello por Hello, OEC! y guardar con Ctrl+S.
- Revisar las versiones anterior y nueva en el diff Git.
- Abrir README.md y alternar preview/código con F4.
- Ctrl+P → archivos masivos: catalog.ts (420 líneas) antes de report.ts (180). Abrir el primero.
- node_modules y samples/cache quedan fuera por .gitignore de raíz y anidado. No se mide complejidad.
OEC 0.2.43 autónomoAmpliar captura ↗
OEC 0.2.43 / Archivos masivosAmpliar captura ↗
INTEGRACIÓN OPCIONAL / PAQUETE NPM PÚBLICO · v0.3.7
Sigue la conversación. Trabaja el archivo.
Explora, edita y revisa tu proyecto dentro de OpenCode 2. Mantén abierta la conversación y salta a tus pestañas de documentos sin perder ediciones, cursor ni scroll.
El plugin en acciónPlugin 0.3.7 · OpenCode 2.1.1
Grabación real con atajos visibles en una sesión vacía de ejemplo: Files → editor → Ctrl+S → Diff por repositorio/rama → conversación/editor con F6. No se ejecutan consultas a modelos.
Versión en texto
- Abrir src/greeting.ts desde Files.
- Editar el saludo y guardar sin salir de OpenCode.
- Abrir el diff y comparar Hello con Hello, OEC!.
- Volver a la conversación con F6 y pulsar F6 de nuevo para recuperar las pestañas.
01 / Plugin 0.3.7 junto a la sesiónAmpliar captura ↗
Ver detalle legible de Files y Diff
Recorte de la nueva captura de sesión; no se altera el contenido de los paneles.
01 / OPENCODEConversaciónF7 · explorador derecho
F602 / OECEditor + archivos a la derechaCtrl+S · guardar / Tab · foco
02 / Editor del plugin 0.3.7Ampliar captura ↗
- Files: filtro por nombre/ruta o contenido literal con Ctrl+F; renombrado F2
- Files/Diff comparten altura restante; modos expanded/compact y scroll independiente
- Git local con colores: sumas verdes, bajas rojas e indicador staged azul
- F4: del diff al archivo actual, o alternar preview y fuente Markdown/SVG
- SVG estático local, imágenes raster, Markdown enriquecido y comandos contextuales Ctrl+P
Una carpeta, varios repositoriosPlugin 0.3.7 · OpenCode 2.1.1
Tres repositorios Git independientes dentro de una carpeta sin .git propio. Diff separa rama, contador y archivos de cada repositorio; muestra también el repositorio limpio. Los dos src/config.ts abren sus propios diffs y F4 nunca mezcla sus rutas. Sin el cartel Getting started.
Versión en texto
- Abrir la carpeta padre: apps/api, apps/web y packages/shared tienen Git e historial propios.
- Diff (2) suma dos archivos modificados: uno en API, rama feature/auth, y otro en web, rama feature/header.
- Abrir el diff de apps/api/src/config.ts: API v1 → API v2; F4 abre su versión actual.
- Abrir apps/web/src/config.ts: Web v1 → Web v2; aunque el nombre relativo coincide, el repositorio es distinto.
- packages/shared, rama main, permanece visible con No changes. Círculo blanco: con cambios; azul: limpio.
- Volver con F6 y usar Collapse: se ocultan los archivos, no los repositorios ni sus ramas. F7 oculta Files para dar espacio a Diff.
No hace falta convertirlos en un solo repositorio.
Abre en OpenCode la carpeta que contiene tus proyectos y autoriza ese directorio local. Cada repositorio conserva su rama, historial y archivos. Diff agrupa sus cambios por repositorio; no es una única rama compartida ni un monorepo Git.
workspace/
├── apps/api/ # .git · feature/auth · 1 archivo modificado
├── apps/web/ # .git · feature/header · 1 archivo modificado
└── packages/shared/ # .git · main · sin cambiosEl total Diff (2) cuenta archivos únicos por repositorio: dos archivos llamados src/config.ts cuentan como dos, porque pertenecen a repositorios diferentes. Un mismo archivo con cambios staged y sin staged cuenta una sola vez en su repositorio; sus áreas se pueden revisar por separado. F4 resuelve siempre el archivo del repositorio elegido. El plugin solo lee Git: no combina historiales, hace commits ni descarta cambios.
Cómo funciona la detección y cuáles son sus límites →El archivo no siempre es código.
Lee Markdown con formato y pulsa F4 para editar. Abre PNG, JPEG, GIF o WebP desde Files: aparecen en su propia pestaña, sin salir de la terminal.
Cómo ver imágenes y configurar la terminal →Del cambio a su contexto.
Revisa staged y cambios del disco en el árbol Diff. Enter abre el diff del archivo; F4 abre su versión actual editable sin cerrar la comparación. El plugin no hace commits ni descarta trabajo.
Entender Diff y sus pestañas →Añádelo a OpenCode. No a tu instalación de OEC.
Localiza tu configuración con opencode debug paths config y agrega esta entrada a plugins en cli.json global, conservando los ajustes existentes. Reinicia y confirma el acceso local al proyecto.
{
"$schema": "https://opencode.ai/v2/cli.json",
"plugins": [
{
"package": "@2jmalvarez/opencode-editor@0.3.7",
"options": {
"toggleBinding": "f6",
"filesBinding": "f7",
"diffBinding": "f8",
"explorerWidth": 30
}
}
]
}Disponibles: OEC 0.2.43 y plugin 0.3.7, publicados y verificados. Incluyen .gitignore anidados, barras de scroll arrastrables, interfaz del plugin en español/inglés y controles Diff adaptables por repositorio y rama.
Defaults · F6 conversación/editor · F7 Files · F8 Diff. OEC autónomo sigue siendo independiente. El plugin no incluye todas sus capacidades.
- Ctrl+P
- Paleta de comandos
- F7
- Alternar explorador
- Ctrl+Alt+F
- Buscar en el proyecto
- Alt+Shift+F
- Formatear documento
EL MANUAL DE CAMPO
Una tecla es solo el principio.
Cada acción, su contexto y sus límites. Del primer archivo a la arquitectura del editor, en español e inglés.
100 acciones44 propiedades21 capítulos
Explorar documentación →INSTALACIÓN / OEC v0.2.43
Tu terminal. Tu forma de instalar.
Elige un método para el editor independiente, o intégralo en OpenCode como plugin.
Un comando. Tu editor listo.
Instala el editor independiente con npm. Requiere Node.js 18 o posterior y npm.
npm install -g openeditorcodeAbre un proyecto con oec . o openeditorcode .
Requisitos y guía completa →Directo a Linux. Sin Node.js.
Descarga el binario con el instalador oficial. Requiere Bash, curl y sha256sum; no necesita npm ni Bun.
curl -fsSL https://raw.githubusercontent.com/2jmalvarez/openeditorcode/main/install.sh | bashInstala en ~/.local/bin y verifica SHA-256. Reabre la terminal y ejecuta oec .
Puedes descargar e inspeccionar el script antes de ejecutarlo. Elige un solo método para evitar instalaciones en conflicto.
Requisitos y guía completa →Nativo en Windows. Sin administrador.
Instala el binario con PowerShell 5.1 o posterior. Sin Node.js, npm ni Bun; sin cambiar la política de ejecución.
& ([scriptblock]::Create((Invoke-WebRequest -UseBasicParsing 'https://raw.githubusercontent.com/2jmalvarez/openeditorcode/main/install.ps1').Content))Verifica SHA-256 y actualiza el PATH del usuario y de la sesión. Después ejecuta oec .
Puedes descargar e inspeccionar el script antes de ejecutarlo. Elige un solo método para evitar instalaciones en conflicto.
Requisitos y guía completa →Tu editor dentro de OpenCode.
No instala el editor independiente. Localiza tu configuración con opencode debug paths config y agrega esta entrada a plugins en cli.json global, sin borrar tus otros ajustes.
{
"$schema": "https://opencode.ai/v2/cli.json",
"plugins": [
{
"package": "@2jmalvarez/opencode-editor@0.3.7",
"options": {
"toggleBinding": "f6",
"filesBinding": "f7",
"diffBinding": "f8",
"explorerWidth": 30
}
}
]
}Reinicia OpenCode, abre OEC: opencode-editor desde Ctrl+P y confirma el acceso local. F6 alterna conversación y editor.
Instalación por nombre verificada con OpenCode 2.1.1. La guía detalla la matriz Windows/Linux y sus límites; para OpenCode 2.1.x no uses versiones del plugin anteriores a 0.3.1. Ver estado ↗
Requisitos y guía completa →CÓDIGO ABIERTO CON APOYO DE LA COMUNIDAD
Apoyar en GitHub ↗Ayuda a que OEC siga creciendo.
Apoya el desarrollo y mantenimiento de OpenEditorCode y su plugin de OpenCode con un aporte único o mensual a través de GitHub Sponsors.
Los aportes van a la cuenta personal del mantenedor, @2jmalvarez. El pago se realiza en GitHub, no en esta web. Apoyar el proyecto es opcional: OEC sigue siendo de código abierto.