TermIDE

English | 中文 | Русский

An all-in-one terminal workspace for your workstation and your servers: code editor with LSP, dual-pane file manager with SFTP/FTP, terminal, git, database viewer and a coding agent — one zero-config static binary written in Rust.

Website | Documentation | Releases | Screenshots

Terminal editors cover the code; everything around it — files on remote hosts, databases, git, long-running shells, a coding agent — usually takes plugins or separate tools. TermIDE ships all of it in one binary that works out of the box on a laptop, a server, or a phone:

TermIDE = Editor + File Manager + Terminal + Git + Agent in one TUI application.

• Terminal-based IDE - Syntax highlighting for 22 languages, word navigation (Ctrl+Left/Right), paragraph/symbol navigation (Ctrl+Up/Down), toggle comment (Ctrl+/), auto-indentation, auto-close brackets
• LSP Support - Code completion, Find References (Shift+F12), Rename Symbol (F4), Go to Definition (Ctrl+Click), diagnostics
• Coding Agent - A panel (Alt+A) where a language model reads, edits and runs commands in your project through any OpenAI- or Anthropic-compatible endpoint (local llama.cpp / Ollama / vLLM / omlx or hosted), asking permission per tool call, with /undo and checkpoints to take its edits back; skills, prompt templates, MCP servers, command hooks, and external agents over ACP (Claude Code, Codex, Gemini CLI) in the same panel
• Smart File Manager - Tree view with expandable directories, nested git status, batch operations, file/content search (glob/regex), in-tree incremental search; zip, tar and ISO archives open like read-only directories (also on a server or inside another archive), and P packs the selection into zip or tar
• Remote Filesystems - Browse and edit files on remote servers from the file manager over SFTP / FTP / FTPS, copying between local and remote panels — pure Rust (russh + rustls), no native libraries, works on static musl (smb:// / nfs:// via the OS mount)
• Background File Operations - Copy, move, upload, download, delete and batch transfers run in the background with a per-operation progress bar, byte/elapsed readout, and pause / resume / cancel (Operations panel)
• Integrated Terminal - Full PTY support, VT100 escape sequences, mouse tracking
• Git Integration - Status panel, commit log with a coloured Unicode commit graph (ASCII fallback), staging/unstaging, branches with their worktrees, branch switching, stash management, inline blame
• Database Viewer - Read-only browser for SQLite / PostgreSQL / MySQL opened from a bookmark URL: table grid with a 2D cell cursor, server-side single-column sort and type-aware per-column filtering, sliding-window pagination, and a row-detail dialog that copies as TSV / JSON / INSERT
• Multi-panel Layout - Vertically split panel groups with adjustable per-panel heights and a one-key fullscreen toggle (Alt+F11); smart auto-stacking when the terminal narrows; new panels open after the currently active one
• Image Viewer - Native graphics in Kitty, WezTerm, iTerm2, Ghostty, foot terminals
• Hex / Binary Viewer & Editor - Hex/ASCII view (adaptive 16-byte sections) for binary files, with a byte cursor shown in both zones, drag/shift selection and clipboard copy, ASCII + hex-byte search, and a hex↔text toggle (Ctrl+L); F4 opens it for overwrite editing with a .bak backup on save
• Markdown Preview - Rendered read-only view for .md / .markdown (headings, lists, tables, syntax-highlighted code blocks, clickable links and image pictograms) with cursor navigation, selection and clipboard copy; Ctrl+E toggles to the editable source; embedded mermaid blocks render as diagrams
• Mermaid Diagram Viewer - Render .mmd / .mermaid files as text pseudographics — flowchart, sequence, state, class, ER, gantt, pie, journey, mindmap, timeline, gitGraph, quadrant; 2D scroll, copy to clipboard, and Ctrl+E to edit the source
• External Apps - Open files with system default applications (Shift+Enter)
• 38 Built-in Themes - Dark, light, retro, and cinematic themes (Dracula, Nord, Monokai, Solarized, Matrix, Pip-Boy, Norton Commander, Windows 95, etc.)
• Custom Themes - Create your own themes in TOML format
• 15 UI Languages - Bengali, Chinese, English, French, German, Hindi, Indonesian, Japanese, Korean, Portuguese, Russian, Spanish, Thai, Turkish, Vietnamese (missing keys transparently fall back to English)
• Project Management - Auto-save and restore panel layouts per project
• Detached Instances - termide --detached keeps the whole instance — editors, shells, LSP servers, running jobs — alive after the terminal closes; termide --attach picks it up again from any terminal, at any size (Unix only)
• System Monitor - Real-time CPU, RAM, network I/O in menu bar and disk usage in status bar; click any indicator to open a detail modal (top processes by CPU/RAM, top processes by network connections with listening ports); repeated click on the same indicator closes the modal (toggle)
• Search & Replace - Live preview, match counter, regex support
• Custom Commands - Shell commands from commands.toml, global and per project, in the Commands menu: hotkeys, groups, parameter forms, and terminal / background / report modes
• Settings Modal - Full-screen configuration (Alt+P) with sidebar layout, grouped fields (Appearance / Input / Layout / Performance / …), and in-place keybinding capture for all 9 keybinding scopes
• Cross-platform - Linux (x86_64, ARM64), macOS (Intel, Apple Silicon), Windows (native via ConPTY, WSL)
• Full Mouse Support - Click navigation, scroll, double-click actions
• Keyboard Layouts - Cyrillic support with automatic hotkey translation
• Vim Mode - Optional Vim-style editing with Cyrillic keyboard support
• Directory Switcher - Quick directory switching with Ctrl+\
• Bookmarks - Save and organize frequently used locations
• Command Palette - Quick access to all commands with fuzzy matching (Ctrl+P)
• Open Prompt - Open a file, directory or URL with path suggestions (Ctrl+G)

Quick Start: Download pre-built binaries from GitHub Releases or install via your package manager.

Supported Platforms: Linux (x86_64, ARM64), macOS (Intel, Apple Silicon), Windows (x86_64)

# Linux x86_64 (also works in WSL)
wget https://github.com/termide/termide/releases/latest/download/termide-0.37.0-x86_64-unknown-linux-gnu.tar.gz
tar xzf termide-0.37.0-x86_64-unknown-linux-gnu.tar.gz
./termide

# Linux x86_64 (static musl — Alpine, distroless containers, any glibc-free system)
wget https://github.com/termide/termide/releases/latest/download/termide-0.37.0-x86_64-unknown-linux-musl.tar.gz
tar xzf termide-0.37.0-x86_64-unknown-linux-musl.tar.gz
./termide

# macOS Intel (x86_64)
curl -LO https://github.com/termide/termide/releases/latest/download/termide-0.37.0-x86_64-apple-darwin.tar.gz
tar xzf termide-0.37.0-x86_64-apple-darwin.tar.gz
./termide

# macOS Apple Silicon (ARM64)
curl -LO https://github.com/termide/termide/releases/latest/download/termide-0.37.0-aarch64-apple-darwin.tar.gz
tar xzf termide-0.37.0-aarch64-apple-darwin.tar.gz
./termide

# Linux ARM64 (Raspberry Pi, ARM servers)
wget https://github.com/termide/termide/releases/latest/download/termide-0.37.0-aarch64-unknown-linux-gnu.tar.gz
tar xzf termide-0.37.0-aarch64-unknown-linux-gnu.tar.gz
./termide

# Linux ARM64 (static musl — Android/Termux, Alpine ARM, any glibc-free ARM64)
wget https://github.com/termide/termide/releases/latest/download/termide-0.37.0-aarch64-unknown-linux-musl.tar.gz
tar xzf termide-0.37.0-aarch64-unknown-linux-musl.tar.gz
./termide

# Windows x86_64 (download .zip from Releases, extract, run in Windows Terminal)
# https://github.com/termide/termide/releases/latest/download/termide-0.37.0-x86_64-pc-windows-msvc.zip

# x86_64 only (ARM64 use tar.gz above)
wget https://github.com/termide/termide/releases/latest/download/termide_0.37.0-1_amd64.deb
sudo dpkg -i termide_0.37.0-1_amd64.deb

# x86_64 only (ARM64 use tar.gz above)
wget https://github.com/termide/termide/releases/latest/download/termide-0.37.0-1.x86_64.rpm
sudo rpm -i termide-0.37.0-1.x86_64.rpm

# Build from source
yay -S termide

# Or install pre-built binary
yay -S termide-bin

git clone https://aur.archlinux.org/termide.git
cd termide
makepkg -si

brew tap termide/termide
brew install termide

# Run without installing
nix run github:termide/termide

# Install to user profile
nix profile install github:termide/termide

# Or add to NixOS configuration.nix
{
  nixpkgs.overlays = [
    (import (builtins.fetchTarball "https://github.com/termide/termide/archive/main.tar.gz")).overlays.default
  ];
  environment.systemPackages = [ pkgs.termide ];
}

pkg install git openssh   # tools termide shells out to (plus any LSP servers)
wget https://github.com/termide/termide/releases/latest/download/termide-0.37.0-aarch64-unknown-linux-musl.tar.gz
tar xzf termide-0.37.0-aarch64-unknown-linux-musl.tar.gz
./termide

# Clone the repository
git clone https://github.com/termide/termide.git
cd termide

# Build and run
cargo run --release

# Clone the repository
git clone https://github.com/termide/termide.git
cd termide

# Enter development environment (includes Rust toolchain and all dependencies)
nix develop

# Build the project
cargo build --release

# Run
./target/release/termide

wget https://github.com/termide/termide/releases/latest/download/termide-0.37.0-x86_64-unknown-linux-musl.tar.gz
tar xzf termide-0.37.0-x86_64-unknown-linux-musl.tar.gz
./termide

# Verify it's fully static — no shared libraries
ldd ./termide   # → "not a dynamic executable"

nix build github:termide/termide#termide-static
./result/bin/termide

• For pre-built binaries: No additional requirements
• For building from source:
  • Rust 1.70+ (stable)
  • For Nix users: Nix with flakes enabled

termide [OPTIONS] [FILE]...

Arguments:
  [FILE]...            File(s) or directories to open. With a path, TermIDE
                       starts in a clean view (no project layout restored or
                       saved). Text opens in the editor, so it works as
                       $EDITOR for git, crontab, visudo, etc.; images, SQLite
                       files, other binaries and directories open in their
                       viewer, the hex editor or a file manager.

Options:
  --log-level <LEVEL>  Set log level (trace, debug, info, warn, error)
  --no-lsp             Disable LSP language servers
  --config <PATH>      Use custom config file path
  --diagnostics        Run pre-flight diagnostics and exit (no UI)
  --detached           Start a detached instance that survives the terminal
                       closing, and print its id (Unix only)
  --attach [<ID>]      Attach to a detached instance, most recent if omitted
  -f, --force          With --attach: take the instance over from a client
                       already attached to it, detaching that client
  --kill <ID>          End a detached instance with every shell and job in it
                       and exit; unsaved changes in it are lost
  --list-instances     List detached instances and exit
  --completions <SHELL>
                       Print a completion script (bash, zsh, fish) and exit
  --install-completions [<SHELL>]
                       Install the completion script for $SHELL, or the named one
  --prompt <PROMPT>    Run one agent task without the UI, print the answer to
                       stdout and exit; `-` reads the prompt from stdin
  --agent <NAME>       With --prompt: the agent definition to use
  --output <FORMAT>    With --prompt: text (default), json or stream-json
  -h, --help           Print help
  -V, --version        Print version

Use as your editor:

export EDITOR=termide   # git commit, crontab -e, visudo, ...

After launching TermIDE, you'll see a width-adaptive layout:

• Wide terminals (>= 160 cols): Sidebar (Git Status stacked with Operations) + two File Manager panels
• Normal terminals (< 160 cols): Sidebar (Git Status, File Manager and Operations stacked) + File Manager panel
• Menu bar at the top, status bar at the bottom

Stacked panels share a column with adjustable per-panel heights. Alt+F11 toggles a "fullscreen current panel" preset (one panel takes the full column height, the rest collapse to their title row); Ctrl+Alt+= / Ctrl+Alt+- grow / shrink the focused panel by 3 lines.

Use Alt+←/→ to switch between panel groups, Alt+↑/↓ to navigate within a group, Alt+M to open the menu.

For detailed documentation, see:

• English: doc/en/README.md
• Russian: doc/ru/README.md
• Chinese: doc/zh/README.md

All shortcuts are customizable in config.toml (see Configuration). The essentials:

• Navigate: Alt+M menu · Alt+H help · Alt+Q quit · Ctrl+P command palette
• Panels: Alt+←/→ and Alt+↑/↓ move between/within groups · Alt+1-9 jump to a panel · Alt+K panel action menu
• Open: Alt+F Files · Alt+T Terminal · Alt+E Editor · Alt+G Git · Alt+P Settings
• Files & viewers: F3 preview (markdown / diagram / hex / image) · Ctrl+E toggle preview ↔ source · Ctrl+F find · Ctrl+R reload from disk · Ctrl+S save

📖 Full per-panel reference (file manager, editor, git, viewers): doc/en/keybindings.md.

TermIDE follows the XDG Base Directory Specification for file organization.

Configuration file location:

• Linux/BSD: ~/.config/termide/config.toml (or $XDG_CONFIG_HOME/termide/config.toml)
• macOS: ~/Library/Application Support/termide/config.toml
• Windows: %APPDATA%\termide\config.toml

A project can override any of it in <project>/.termide/config.toml. A setting with a wrong type or value is ignored on its own and reported in the Journal; the rest of the file still applies. Since the next save from Settings rewrites the file without the ignored setting, the file as it was is first copied to config.toml.bak next to it. termide --diagnostics lists the same problems.

Project data location:

• Linux/BSD: ~/.local/share/termide/projects/ (or $XDG_DATA_HOME/termide/projects/)
• macOS: ~/Library/Application Support/termide/projects/
• Windows: %APPDATA%\termide\projects\

Log file location: each run writes its own session-<date>-<time>.log into the project's directory under the project data location above; logs older than 24 hours are removed. logging.file_path replaces this with one fixed file.

Bookmarks location:

• Linux/BSD: ~/.config/termide/bookmarks.toml (or $XDG_CONFIG_HOME/termide/bookmarks.toml)
• macOS: ~/Library/Application Support/termide/bookmarks.toml
• Windows: %APPDATA%\termide\bookmarks.toml

[general]
theme = "windows-xp"
language = "auto"  # auto, bn, de, en, es, fr, hi, id, ja, ko, pt, ru, th, tr, vi, zh
vim_mode = false
project_retention_days = 30
bell_on_operation_complete = true
icon_mode = "auto"  # auto, emoji, unicode
always_detachable = false  # keep the instance alive across terminal closes (Unix)
resource_monitor_interval = 1000

[editor]
tab_size = 4
show_git_diff = true
word_wrap = true
auto_indent = true
auto_close_brackets = true

[file_manager]
extended_view_width = 50

[lsp]
enabled = true
auto_completion = true

[logging]
min_level = "info"

Dark Themes:

• windows-xp - Default theme (Windows XP style)
• dracula - Popular Dracula theme
• monokai - Classic Monokai theme
• nord - Nord theme with blue tones
• onedark - Atom One Dark theme
• solarized-dark - Dark Solarized theme
• midnight - Midnight Commander inspired
• macos-dark - macOS dark style
• ayu-dark - Ayu Dark theme
• billiard - Billiard table green tones
• catppuccin-macchiato - Catppuccin Macchiato theme
• everforest - Everforest dark theme
• github-dark - GitHub Dark theme
• gruvbox - Gruvbox dark theme
• kanagawa - Kanagawa theme
• material-ocean - Material Ocean theme
• rosepine - Rosé Pine theme
• tokyonight - Tokyo Night theme

Light Themes:

• atom-one-light - Atom One Light theme
• ayu-light - Ayu Light theme
• github-light - GitHub Light theme
• manuscript - Medieval manuscript with aged parchment tones
• material-lighter - Material Lighter theme
• solarized-light - Light Solarized theme
• macos-light - macOS light style
• blue-sky - Blue Sky theme
• green-backs - Green dollar bills theme
• pinky-pie - Pinky Pie theme

Retro Themes:

• far-manager - FAR Manager style
• norton-commander - Norton Commander style
• dos-navigator - DOS Navigator style
• volkov-commander - Volkov Commander style
• windows-95 - Windows 95 style
• windows-98 - Windows 98 style

Cinematic Themes:

• matrix - The Matrix digital rain (green on black)
• pip-boy - Fallout Pip-Boy 3000 phosphor CRT
• terminator - Skynet HUD / Mars red aesthetics

Other Themes:

• terminal - Classic terminal style (inherits terminal colors)

Theme Examples:

Windows XP (default)	Dracula	Ayu Light
Monokai	Nord	Material Lighter

You can create custom themes by placing TOML files in the themes directory:

• Linux: ~/.config/termide/themes/
• macOS: ~/Library/Application Support/termide/themes/
• Windows: %APPDATA%\termide\themes\

User themes take priority over built-in themes with the same name. See crates/theme/themes/ directory in the repository for theme file format examples.

Shell commands you run often go into commands.toml — the global one in the configuration directory, or <project>/.termide/commands.toml for a project — and appear in the Commands menu:

[test]
name = "Run tests"
command = "cargo nextest run"
group = "cargo"
key = "Ctrl+Shift+T"

[clippy]
command = "cargo clippy --workspace -- -D warnings"
mode = "report"  # terminal (default), background, or report

Commands → Add command... creates one through a form. See Custom Commands for modes, parameters and hotkeys.

The codebase is a Cargo workspace of modular crates. For the crate layout, panel system, and event flow, see the Developer Guide and Architecture.

# Development build
cargo build

# Release build with optimizations
cargo build --release

# Run tests
cargo test

# Check code quality
cargo clippy
cargo fmt --check

The project includes a Nix flake for reproducible development environments:

# Enter development shell
nix develop

# Build with Nix
nix build

# Run checks
nix flake check

Contributions are welcome! Please feel free to submit issues and pull requests.

This project is licensed under the MIT License.

Built with:

• ratatui - Terminal UI framework
• crossterm - Cross-platform terminal manipulation
• portable-pty - PTY implementation
• tree-sitter - Syntax highlighting
• ropey - Text buffer
• sysinfo - System resource monitoring