terminal-code
terminal-code.com- Category
- Other
- Rank
- No. 976Tools index
- Type
- APP
- Use case
- Coding
- Interfaces
- CLI
- Builder
- @RobKnight__
- GitHub
- 2.3k stars
- Latest release
- v0.4.3
- Date
About
Runs VS Code inside the terminal by combining code-server with a terminal-based browser. Works over SSH, opens files at a line and column, compares files, splits panes, and imports settings, keybindings, snippets, and extensions from VS Code compatible editors.
What it does
A command called tode that puts the full Microsoft editor experience in a terminal window, pixels and all. It starts a headless editor server on the local loopback address, puts a small proxy in front that restyles each page to match the terminal palette and font, then has a background browser process paint that page into the terminal through the kitty graphics protocol. Command line behaviour mirrors the usual code command, so muscle memory and scripts that call it mostly carry over.
Why it's ranked here
The engineering is careful where it matters. The installer checks a SHA256 hash before unpacking and swaps the new tree in with an atomic rename, so a failed upgrade never leaves half an install. The remote mode keeps the interface local and ships only the backend over SSH, which is the right split for latency. The license is MIT. Against that, it is early: the package is marked private, there is no official Windows build, and the source still carries author notes questioning its own pieces.
What's good
The proxy holds requests for up to twenty seconds while the editor server boots instead of failing, so the window can launch in parallel with the backend. Upgraded websocket connections are torn down on either half closing, which stops leaked connections on every reload. The background window process exits after fifteen idle seconds and restarts itself when it detects a newer build. Linux installs list any missing Chromium system libraries up front rather than failing later with a loader error.
Tradeoffs
The editor server runs with authentication turned off, bound to the loopback address only, so any process on the same machine can reach it. It needs a terminal that speaks the kitty graphics protocol; others get an unsupported message and exit. Several standard editor flags are silently ignored, and disabling extensions per window is not supported because extensions are shared across one server. The install path is a piped shell script, and the bundled Electron runtime adds weight compared with a native terminal editor.
How to use it well
Best for developers who live in a graphics-capable terminal such as kitty or Ghostty and want the familiar editor without switching windows. Run the shortcut wizard on first use, since the terminal will otherwise swallow key presses. For remote machines, run the SSH mode from your laptop rather than launching it on the server, so frames stay local. It does not replace a native editor on Windows; there the documented route is the Linux build inside WSL.
Technical notes+
Entry is src/main.ts, which parses VS Code style flags, drops a list of ignored ones, and either forwards an open request to a running window over IPC or boots a new pane. src/codeserver/server.ts spawns code-server with --auth none on 127.0.0.1 at a free port, points EXTENSIONS_GALLERY at the Visual Studio Marketplace, and starts an injector process; src/codeserver/inject.ts proxies HTTP and websocket upgrades, rewrites origin and referer headers, and splices a style tag before the closing head. src/app/daemon.ts is an Electron process from @zenbu-labs/pixel serving a Unix socket, with IDLE_EXIT_MS of 15000 and a stale-build check. src/launch.ts handles pane splits via the detected terminal. scripts/install.sh verifies sha256 and swaps directories atomically.
Observed
- License
- MIT
- Language
- TypeScript on Node.js
- Interface
- CLI (tode)
- Install
- curl piped to bash installer with SHA256 verification
- Platforms
- macOS arm64 and x64, Linux x64 and arm64; Windows only via WSL
- Terminal requirement
- kitty graphics protocol support
- Runtime
- Bundled code-server plus Electron window process
- Local server auth
- Disabled, bound to 127.0.0.1
- npm package
- Marked private, not published
Read from README.md, package.json, src/main.ts, src/launch.ts, src/codeserver/server.ts, src/codeserver/inject.ts, src/app/daemon.ts, scripts/install.sh, LICENSE.
Intel on terminal-code
Tech Stack
Media
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.