  OOOO    EEEEEE   CCCCC
 O    O   EE       CC
 O    O   EEEE     CC
 O    O   EE       CC
  OOOO    EEEEEE   CCCCC

OpenEditorCode

OpenEditorCode is a keyboard-first editor for exploring, editing, searching, and reviewing Git changes without leaving your terminal.

Install OEC Documentation →View source ->

ONE WORKSPACE, FOUR RHYTHMS

Keep the whole project within reach.

OEC keeps the operations that shape a coding session close together, while your project stays local.

Map the project

Browse a virtualized tree, rank files by line count, and create or rename entries.

Work the document

Edit across tabs, format source, read richer Markdown and toggle SVG preview/XML with F4.

Find the path

Keep a hierarchical name/content filter in Explorer, or use advanced project search, respecting .gitignore.

Read the change

Select nested Git repositories, stage and commit, sync, and inspect aligned diffs and history.

BUILT FOR THE PROJECT ROOT

Useful boundaries. Fewer surprises.

Local by design

Edit locally without OpenCode or a server. Git remotes and installation updates use the network when requested or enabled.

Guarded files

Project document helpers validate paths and reject binary, invalid UTF-8, and oversized text. The reference explains scope and limits.

Your configuration

Global settings live outside projects. A project may override preferences in .oec/config.json.

Keyboard complete

Explorer, editor, search, dialogs, and Git changes remain operable without a mouse.

Standalone OEC 0.2.40 welcome screen, with the left explorer, central keyboard guide and right Git pane. — This is the standalone application, not the plugin. Install it with npm or the direct Windows/Linux installers; it has its own shortcuts and Git capabilities.

OPTIONAL INTEGRATION / PUBLIC NPM PACKAGE · v0.3.4

Stay in the conversation. Work the file.

Explore, edit and review your project inside OpenCode 2. Keep the conversation open, then jump into your own document tabs without losing edits, cursor or scroll.

Install the OpenCode plugin →Complete guide ↗All shortcuts ↗

OpenCode conversation on the left, with Files, Fuzzy search and the Diff tree on the right. — Files and Diff live alongside the chat. Search a path, inspect project changes and open a file without sending a prompt. F7 and F8 control each section separately.

Enlarged detail of Files with Fuzzy search and Diff with folders and modified files. — Files and Diff live alongside the chat. Search a path, inspect project changes and open a file without sending a prompt. F7 and F8 control each section separately.

01 / OPENCODEConversationF7 · right-side explorer

F6

02 / OECEditor + right-side filesCtrl+S · save / Tab · focus

OEC editor inside OpenCode with README in source view, its own document tab, Files explorer and Diff tree. — The integrated editor has its own tabs, line numbers and highlighting. Ctrl+S saves, Ctrl+F finds, Ctrl+L wraps lines and Tab changes focus. F6 returns to the conversation while retaining edits and panels.

Files: name/path or literal content filtering with Ctrl+F; F2 rename
Files/Diff share remaining height; expanded/compact modes and independent scrolling
Local Git colors: green additions, red deletions and blue staged indicators
F4: edit the current diff file or toggle Markdown/SVG preview and source
Static local SVG, raster images, richer Markdown and contextual Ctrl+P commands

03 / MARKDOWN + IMAGES

Not every file is code.

Read formatted Markdown and press F4 to edit. Open PNG, JPEG, GIF or WebP from Files: each appears in its own tab without leaving the terminal.

View images and configure your terminal →

04 / LOCAL GIT

From change to context.

Inspect staged and disk changes in the Diff tree. Enter opens the file diff; F4 opens its current editable version without closing the comparison. The plugin does not commit or discard work.

Understand Diff and its tabs →

Add it to OpenCode. Not to your OEC installation.

Locate configuration with opencode debug paths config and merge this entry into plugins in global cli.json, preserving existing settings. Restart and confirm local project access.

Windows and Linux · global cli.jsonjson

{
  "$schema": "https://opencode.ai/v2/cli.json",
  "plugins": [
    {
      "package": "@2jmalvarez/[email protected]",
      "options": {
        "toggleBinding": "f6",
        "filesBinding": "f7",
        "diffBinding": "f8",
        "explorerWidth": 30
      }
    }
  ]
}

Available now: OEC 0.2.41 and plugin 0.3.4, published and verified independently. SVG preview, content filtering and the new editor capabilities are included in these releases.

Installation, usage and configuration →npm ↗Local alternative ↗

Defaults · F6 conversation/editor · F7 Files · F8 Diff. Standalone OEC remains independent. This plugin does not include all standalone capabilities.

START WITHOUT A TOUR

The essential keys are already nearby.

View all commands →

Ctrl+P: Command palette
Ctrl+B: Toggle Explorer
Ctrl+Alt+F: Search the project
Alt+Shift+F: Format document

THE FIELD MANUAL

A key is only the beginning.

Every action, its context and its limits. From your first file to the editor’s architecture, in Spanish and English.

100 actions44 properties21 chapters

All commands ↗Complete configuration ↗Git history and branches ↗Architecture and development ↗

Explore documentation →

INSTALLATION / OEC v0.2.41

Your terminal. Your way to install.

Choose one method for the standalone editor, or integrate it into OpenCode as a plugin.

Windows x64 / Linux x64 (glibc)STANDALONE

One command. Your editor is ready.

Install the standalone editor with npm. Requires Node.js 18 or later and npm.

Run in your terminalshell

npm install -g openeditorcode

Open a project with oec . or openeditorcode .

Requirements and full guide →

Linux x64 (glibc) / BashSTANDALONE

Straight to Linux. No Node.js.

Download the binary with the official installer. Requires Bash, curl and sha256sum; no npm or Bun needed.

Official installer · Bashbash

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

Installs into ~/.local/bin and verifies SHA-256. Reopen your terminal and run oec .

You can download and inspect the script before running it. Choose one method to avoid conflicting installations.

Requirements and full guide →

Windows x64STANDALONE

Native on Windows. No admin needed.

Install the binary with PowerShell 5.1 or later. No Node.js, npm or Bun; no execution policy changes.

Official installer · PowerShellpowershell

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

Verifies SHA-256 and updates user and session PATH. Then run oec .

You can download and inspect the script before running it. Choose one method to avoid conflicting installations.

Requirements and full guide →

OpenCode 2 / Windows / LinuxPLUGIN v0.3.4

Your editor inside OpenCode.

Does not install the standalone editor. Locate your configuration with opencode debug paths config and merge this plugins entry into global cli.json, preserving your other settings.

Global cli.json · merge, do not replacejson

{
  "$schema": "https://opencode.ai/v2/cli.json",
  "plugins": [
    {
      "package": "@2jmalvarez/[email protected]",
      "options": {
        "toggleBinding": "f6",
        "filesBinding": "f7",
        "diffBinding": "f8",
        "explorerWidth": 30
      }
    }
  ]
}

Restart OpenCode, open OEC: opencode-editor from Ctrl+P and confirm local access. F6 switches between conversation and editor.

Installation by name verified with OpenCode 2.1.1. The guide details the Windows/Linux matrix and its limits; do not use plugin versions before 0.3.1 with OpenCode 2.1.x. View status ↗

Requirements and full guide →