TermIDE

A zero-config terminal IDE that unifies an editor, file manager, and terminal — with built-in git, database, hex, Markdown, image, and Mermaid viewers — in one cross-platform TUI written in Rust.

Website | Documentation | Releases | Screenshots

Why TermIDE?

Unlike traditional terminal editors that need extensive plugin configuration, TermIDE works out of the box:

Feature	TermIDE	Vim/Neovim	Helix	Micro
LSP Support	✓	✓	✓	plugin
Zero Config	✓	✗	✓	✓
Script Automation	✓	✓	✗	plugin
Remote Filesystems (SFTP/FTP)	✓	✓	✗	✗
Hex / Binary Viewer	✓	plugin	✗	plugin
Database Viewer	✓	plugin	✗	✗
Markdown Preview	✓	plugin	✗	✗
Diagram Viewer (Mermaid)	✓	plugin	✗	✗
Image Viewer	✓	plugin	✗	✗
Built-in Terminal	✓	plugin	✗	✗
File Manager	✓	plugin	✗	✗
Background File Operations	✓	plugin	✗	✗
Git Integration	✓	plugin	✗	✗
Sessions	✓	plugin	✗	✗
Multi-panel Layout	✓	plugin	✗	✗
Bookmarks	✓	plugin	✗	✗
Resource Monitor	✓	✗	✗	✗

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

Features

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
Smart File Manager - Tree view with expandable directories, nested git status, batch operations, file/content search (glob/regex), in-tree incremental search
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, 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)
39 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)
Session Management - Auto-save and restore panel layouts
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 Scripts - Run user-defined scripts from the Scripts menu (supports .bg. for background, .report. for scrollable modal output with success/failure indicator)
Settings Modal - Full-screen configuration (Alt+P) with sidebar layout, grouped fields (Appearance / Input / Layout / Performance / …), and in-place keybinding capture for 7 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 (Ctrl+P)

Installation

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)

Choose Your Installation Method

📦 Pre-built Binaries (Recommended)

Download the latest release for your platform from GitHub Releases:

# Linux x86_64 (also works in WSL)
wget https://github.com/termide/termide/releases/latest/download/termide-0.29.6-x86_64-unknown-linux-gnu.tar.gz
tar xzf termide-0.29.6-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.29.6-x86_64-unknown-linux-musl.tar.gz
tar xzf termide-0.29.6-x86_64-unknown-linux-musl.tar.gz
./termide

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

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

# Linux ARM64 (Raspberry Pi, ARM servers)
wget https://github.com/termide/termide/releases/latest/download/termide-0.29.6-aarch64-unknown-linux-gnu.tar.gz
tar xzf termide-0.29.6-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.29.6-aarch64-unknown-linux-musl.tar.gz
tar xzf termide-0.29.6-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.29.6-x86_64-pc-windows-msvc.zip

🪟 Windows (.zip)

TermIDE runs natively on Windows 10+ via ConPTY. Use Windows Terminal for the best experience.

Download termide-0.29.6-x86_64-pc-windows-msvc.zip from GitHub Releases.
Extract the archive.
Run termide.exe in Windows Terminal.

Configuration lives under %APPDATA%\termide\ (config, sessions) and %LOCALAPPDATA%\termide\cache\ (logs).

Alternatively, in WSL/WSL2 use the Linux x86_64 build (termide-0.29.6-x86_64-unknown-linux-gnu.tar.gz) as on any Linux.

🐧 Debian/Ubuntu (.deb)

Download and install the .deb package from GitHub Releases:

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

🎩 Fedora/RHEL/CentOS (.rpm)

Download and install the .rpm package from GitHub Releases:

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

🐧 Arch Linux (AUR)

Install from the AUR using your favorite AUR helper:

# Build from source
yay -S termide

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

Or manually:

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

🍺 Homebrew (macOS/Linux)

Install via Homebrew tap:

brew tap termide/termide
brew install termide

❄️ NixOS/Nix (Flakes)

Install using Nix flakes:

# 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 ];
}

🤖 Android (Termux)

Inside Termux, use the static ARM64 musl build (the glibc aarch64-unknown-linux-gnu build won't run on Android's Bionic libc):

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

Notes: the system clipboard isn't available on Android (no X11/Wayland), and the resource monitor may show partial data due to Android's restricted /proc. The editor, file manager, git, and the integrated terminal work normally.

🔨 Build from Source (Cargo)

Build from source using Cargo:

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

# Build and run
cargo run --release

🔨 Build from Source (Nix)

Build from source using Nix (for development):

# 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

📦 Portable static binary (Alpine / any Linux)

A fully static musl build is published with every release. It links no shared libraries and runs on any Linux distribution, including Alpine and minimal containers. The whole workspace is pure-Rust (rustls + russh + russh-sftp — no OpenSSL, no libssh2), so this is the same code, just compiled against musl.

The easiest way is to grab the pre-built tarball from the release:

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

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

If you'd rather build it yourself (e.g. for a different musl variant), the flake exposes the same recipe as a derivation:

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

Either binary can be copied anywhere — into a container, a stripped Alpine image, an embedded box — and it will work without needing musl-dev or glibc installed.

Requirements

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

Command-Line Options

termide [OPTIONS] [FILE]...

Arguments:
  [FILE]...            File(s) to open. With a path, TermIDE starts in a clean
                       editor view (no session restore/save), so it works as
                       $EDITOR for git, crontab, visudo, etc.

Options:
  --log-level <LEVEL>  Set log level (trace, debug, info, warn, error)
  --no-lsp             Disable LSP language servers
  --config <FILE>      Use custom config file path
  --diagnostics        Run pre-flight diagnostics and exit (no UI)
  -h, --help           Print help
  -V, --version        Print version

Use as your editor:

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

Usage

Quick Start

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.

Documentation

For detailed documentation, see:

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

Keyboard Shortcuts

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.

Configuration

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

Session data location:

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

Log file location:

Linux/BSD: ~/.cache/termide/termide.log (or $XDG_CACHE_HOME/termide/termide.log)
macOS: ~/Library/Caches/termide/termide.log
Windows: %LOCALAPPDATA%\termide\cache\termide.log

Bookmarks location:

Linux/BSD: ~/.local/share/termide/bookmarks.toml (or $XDG_DATA_HOME/termide/bookmarks.toml)
macOS: ~/Library/Application Support/termide/bookmarks.toml

Example Configuration

[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
session_retention_days = 30
bell_on_operation_complete = true
icon_mode = "auto"  # auto, emoji, unicode
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"

Available Themes

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

Custom Themes

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.

Custom Scripts

You can add custom scripts to the Scripts menu by placing executable files in:

Linux: ~/.local/share/termide/scripts/
macOS: ~/Library/Application Support/termide/scripts/
Windows: %APPDATA%\termide\scripts\

Features:

Scripts appear in the Scripts menu (menu bar)
Subdirectories create nested submenus (clicking a group toggles expand/collapse)
Add .bg. to filename for background execution (e.g., deploy.bg.sh)
Add .report. to filename for background with modal output (e.g., check.report.sh). Report modal is scrollable (Up/Down, PageUp/PageDown, Home/End, mouse wheel) and shows ✓/✗ in the title
Display name is the part before the first dot

Example:

# Create scripts directory
mkdir -p ~/.local/share/termide/scripts

# Add a simple script
cat > ~/.local/share/termide/scripts/hello.sh << 'EOF'
#!/bin/bash
echo "Hello from TermIDE!"
read -p "Press Enter to close..."
EOF

# Make it executable (required on Unix)
chmod +x ~/.local/share/termide/scripts/hello.sh

Note: On Unix systems, scripts must have the executable permission (chmod +x). Use Options → Manage scripts to open the scripts folder.

Development

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

Building

# Development build
cargo build

# Release build with optimizations
cargo build --release

# Run tests
cargo test

# Check code quality
cargo clippy
cargo fmt --check

Nix Development

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

Contributing

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

License

This project is licensed under the MIT License.

Acknowledgments

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

Name		Name	Last commit message	Last commit date
Latest commit History 1,240 Commits
.agents/skills		.agents/skills
.cargo		.cargo
.github		.github
.termide		.termide
assets		assets
crates		crates
doc		doc
packaging		packaging
src		src
tests		tests
.envrc		.envrc
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
LICENSE		LICENSE
README.md		README.md
README.ru.md		README.ru.md
README.zh.md		README.zh.md
SECURITY.md		SECURITY.md
build.rs		build.rs
default.nix		default.nix
deny.toml		deny.toml
flake.lock		flake.lock
flake.nix		flake.nix
install.sh		install.sh
rust-toolchain.toml		rust-toolchain.toml

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

TermIDE

Why TermIDE?

Features

Installation

Choose Your Installation Method

Requirements

Command-Line Options

Usage

Quick Start

Documentation

Keyboard Shortcuts

Configuration

Example Configuration

Available Themes

Custom Themes

Custom Scripts

Development

Building

Nix Development

Contributing

License

Acknowledgments

About

Releases

Used by

Contributors

Languages

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

TermIDE

Why TermIDE?

Features

Installation

Choose Your Installation Method

Requirements

Command-Line Options

Usage

Quick Start

Documentation

Keyboard Shortcuts

Configuration

Example Configuration

Available Themes

Custom Themes

Custom Scripts

Development

Building

Nix Development

Contributing

License

Acknowledgments

About

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Used by

Contributors

Languages