Modern terminal emulator built with Electron — file tree, code editor, Git integration and AI agents. Lightweight, fast, and feature-rich.
- Multiple tabs with independent shell sessions (zsh on macOS/Linux; PowerShell 7 / Windows PowerShell 5.1 / Git Bash /
cmd.exeon Windows, selectable in Settings → Terminal) - Configurable terminal renderer — Canvas 2D (default, stable), WebGL (GPU-accelerated) or DOM, switchable in Settings → Terminal; automatic WebGL context-loss recovery and texture-atlas repair
- Kitty keyboard protocol — Shift+Enter, Ctrl+Enter, Ctrl+Shift+Enter sequences
- Full Unicode support — Cyrillic, accented characters, emoji
- Shell directory tracking via OSC 7 — file tree syncs automatically
- Command busy indicator via OSC 133 — navigation buttons reflect shell state
- Per-shell command dialect — everything eTty types into a tab (
cd, open file, run script, launch agent with a proxy) is built for that tab's shell (POSIX / PowerShell /cmd/ Git Bash); SSH tabs are always POSIX - Tab drag-and-drop — reorder tabs by dragging the grip handle
- Configurable new tab placement — choose whether new tabs open adjacent to the active tab or at the end; hold Cmd/Ctrl while clicking "+" to toggle the behavior (configurable in Settings)
- Local tab from an SSH tab — right-click "+" for a "Local tab / SSH: " menu, or press
Cmd+Shift+T(Ctrl+Shift+T); otherwise a lone SSH tab made "+" always inherit its connection - Keyboard shortcut to switch tabs — bind
Cmd+Option+←/→orCmd+Shift+←/→to jump to the adjacent tab (wraps around at the ends); off by default, configurable in Settings → Terminal - Confirmation before closing a busy tab — closing a tab (× button or context menu) while an AI agent/process is still running shows a confirmation dialog instead of silently killing it
- Auto-open tab for busy terminal — triggering a run-script or cd from the file tree while the active tab is occupied by an agent automatically opens a new tab for the command
- 2,500 lines scrollback buffer (performance-optimized)
- Scroll-to-bottom button — floating button appears when you scroll up into history; click to jump back to the latest output
- Overlay scrollbars — the handle shows only while scrolling and native scrollbar controls follow the app theme (Windows/Linux)
- SSH panel — dedicated sidebar for saved connections; position configurable in Settings → SSH Panel (left, right, or off — off by default). The toolbar toggle button is hidden entirely when the panel is off
- SSH / tmux switch — a segmented control in the panel header decides what a click on a connection does: open a regular SSH tab, or (tmux mode) expand the row into the list of tmux sessions on the server; the choice is remembered
- Add/edit/delete/reorder — host, port, user, auth type (ssh-agent, private key, or password), private key path, extra
ssharguments; drag-and-drop to reorder - Encrypted password storage — saved passwords/passphrases are encrypted at rest via Electron
safeStorage(OS keychain); on Windows it uses DPAPI, and over SSH they're passed tosshthroughaskpass.cmd(OpenSSH ≥ 8.4) - Click to connect — opens a regular terminal tab (color-accented, SSH icon) running the system
sshbinary — full support for~/.ssh/config, ssh-agent,ProxyJump, 2FA - "+" clones the active connection — pressing "+" while an SSH tab is active opens another tab to the same host
- Connection overlay — spinner while connecting; on a dropped session, an error with exit code and a reconnect button, without closing the tab
- Export / import (
.ettyx) — move saved connections between machines or to the mobile app: an encrypted file (PBKDF2-SHA256 + AES-256-GCM) protected by a passphrase; private keys are included only if you tick the checkbox - Session restore — SSH tabs are saved and restored like local tabs; only the tab that was active reconnects automatically on launch, others reconnect lazily when you switch to them
- File tree and editor over SSH — browse, create, rename, delete, copy, move, read and write remote files; operations run as short-lived non-interactive calls multiplexed over the system
ssh(a long-livedssh -T … /bin/shstdio channel, since OpenSSH for Windows has no ControlMaster), so there's no extra authentication and nothing to install on the server - Windows paths — a renderer-side path service handles
C:\, UNC and case-insensitive comparison; OSC 7file:///C:/…, Git paths and editor links all resolve - Change detection — polling of expanded directories (
fs.watchisn't available over SSH) with an immediate refresh after your own changes - Git over SSH — branch, file statuses, editor gutter and the Git panel work for remote repositories (git runs on the server through the tab's SSH channel)
- Image paste —
Cmd+V/Ctrl+Vwith an image in the clipboard uploads it to the server (/tmp/etty-paste/) and pastes the remote path, so claude/opencode/agy can attach it - CLI agents work remotely — remote shell hooks (zsh and bash) report the working directory and busy state, so quick replies, Shift+Enter and the busy indicator behave as in local tabs; falls back to an optimistic busy state if the server blocks hooks (
RemoteCommand/ForceCommand) - Agents detected on Windows too — CLI agents are found via PATH/PATHEXT without
sh, including the.cmdshims npm installs
- Sessions survive disconnects — a tab attaches to a named tmux session, so a network drop, laptop sleep or app restart doesn't kill what's running on the server; closing a tab detaches instead of killing, and restoring tabs re-attaches the same session
- Session list without an open tab — in tmux mode, expand a connection to see all its tmux sessions (not only eTty's own); connect, rename (inline) or kill (with confirmation) from the context menu; the list refreshes automatically
- Several independent sessions per connection — new ones are named
etty-<id>,-2,-3…; clicking a session that's already open just switches to its tab - tmux badge — persistent tabs get a "tmux" badge and their own accent color
- Taken over from elsewhere — if another client attaches to the session, the tab shows a "detached" overlay rather than a generic error
- tmux not installed? — eTty detects the server's package manager and offers to type the install command into the tab's own terminal; nothing runs without your confirmation, and any
sudopassword is entered by you - Configurable socket — per-connection tmux socket (
-L, defaultetty; empty uses the server's default) - Running agent restored — a restored tmux tab whose session still has a CLI agent running (claude, opencode, …) brings back that agent's quick-reply panel by inspecting the full process command line (recognizing versioned native binaries like Claude Code); tab switching resyncs active agent detection
- Shared global history (5,000 lines) across all tabs
- Per-tab history files — each tab gets its own
HISTFILE - Smart merging — new commands merge back to global on tab close
- Session restore — history survives app restarts
- Automatic cleanup of orphaned history files
- Lazy-loaded directory tree with expand/collapse
- Hidden files toggle
- Quick navigation —
cd ..andcd ~buttons - Live sync — filesystem watcher with 500ms debounce
- Context menus — new file/folder, rename, delete, copy, paste, open external, copy relative path
- Hover overlay — quick-action buttons appear on hover: cd into directory, copy path, and run script (▶) to execute the file in the active terminal
- Multi-select — Ctrl/Cmd+Click, Shift+Click range, Ctrl+A select all
- Bulk operations — copy (
Ctrl+C/Cmd+C), paste (Ctrl+V/Cmd+V), and delete (Delete) on the current selection - Drag-and-drop — move files/folders within the tree
- Undo — Ctrl+Z to undo last move operation
- Binary file handling — images, videos, executables (.dmg, .exe, etc.) open with the OS default application instead of the code editor
- Resizable sidebar (150–600px)
- Path traversal protection — all paths validated against CWD
- CodeMirror 6 with syntax highlighting for 20+ languages: JavaScript/TypeScript, Python, Go, Rust, HTML, CSS/SCSS, JSON, YAML, Markdown, Vue, C#
- Send to terminal — select code and send it to the active shell (Cmd+Enter)
- Unsaved changes indicator
- Auto-features — bracket closing, fold gutter, active line highlight, search
- Clickable file paths — Cmd/Ctrl+Click a path in the editor (backtick-wrapped, markdown link,
./relative, or absolute) to open it - Resizable editor panel
- Scroll position preserved — switching between open file tabs, or between terminal tabs, restores each file's exact scroll position (CodeMirror scroll snapshot)
- Status bar showing
± +N -Ndiff stats, updated every 5 seconds- Click on stats to toggle Git panel
- Branch management — switch, create, delete branches
- Inline diff viewer with colored additions/deletions
- Commit, push, discard — all from the GUI
- Per-file stats — additions and deletions count for each changed file
- File tree indicators — new files (green), modified (blue), deleted (red + strikethrough)
- Folder dot markers — nested changes bubble up to parent directories (deleted > modified > new)
- Editor gutter bars — 3px color strips left of line numbers for added (green) and modified (blue) lines
- Auto-refresh — polling every 5 seconds + immediate update on file save (
Cmd+S) - Repository-aware — only active when the working directory is inside a git repo
- Modal search dialog —
Cmd+F(macOS) /Ctrl+F(Windows/Linux), or double-tapShift - File names + contents — searches both simultaneously; file-name matches shown first
- Search options — case sensitive, whole word, regex toggles; include/exclude glob patterns
- Live preview — click a result to preview file contents with highlighted matches
- Quick open — double-click or
Enteropens the file in the editor and closes the dialog - Cancellable — long searches abort automatically when the query changes
- Status-bar launcher — one-click launch of detected CLI agents
- Auto-detection & PATH resolver — Claude, Codex, Copilot, Cursor Agent, OpenCode, Qwen, Agento; automatic scanning of common CLI paths (
~/.local/bin,~/.cargo/bin, pnpm, nvm, fnm, brew) and shell profiles (~/.zprofile,~/.zshrc,~/.bash_profile), with dynamic Zsh PATH sync (_etty_sync_pathwithrehash) and instant status bar updates when terminal commands complete - Custom launch commands — override default launch commands or binary paths for built-in agents in Settings → AI Agents (e.g. custom executable path or flags)
- Custom agents — add your own CLI agent (label, launch command, optional detect command) alongside the built-ins; available in quick replies too
- Busy lock — agent buttons disabled while terminal is busy
- Active agent highlight — launched agent button glows while running
- Force-disable — toggle agents on/off in Settings; disabled agents are cleanly hidden from the status bar
- Proxy support — configure HTTP proxy for all agent commands
- Customizable quick replies — define agent-specific quick commands (e.g.,
/clear,Ok,Продолжай) via Settings; drag-and-drop to reorder - Quick reply groups — bundle related replies under a named group; the group collapses into a single status-bar button that opens a dropdown menu with the matching replies
- Radial quick-access menu — a multi-level circular menu right on the terminal that mirrors the status-bar quick access (the active agent's quick replies with groups as sub-levels, or agent launch buttons); opened by a real touch gesture over the terminal — double tap with two fingers (default) or three; on/off and gesture in Settings → Terminal. On macOS raw trackpad touches are read by a small native addon (built on install,
npm run build:native), so it works regardless of the "Tap to click" setting; touchscreens use Pointer Events. The touch stream heals itself: after sleep or screen unlock it restarts with retries while the trackpad driver is still coming up, so gestures no longer stay dead until an app restart - Two-finger swipes on the terminal (macOS trackpad) — swipe up/down sends the arrow keys; swipe left/right sends the arrow keys or switches tabs; each axis is configured separately in Settings → Terminal (off by default)
- Double-click or right-click to select active agent — when the terminal is busy but the active agent wasn't auto-detected (e.g., launched manually or via another app), double-click any agent button in the status bar to manually assign it as active. Right-clicking an agent button opens a context menu to launch the agent or select it as already running (especially useful in remote/SSH tabs where busy state may not be reported).
- Per-agent Shift+Enter mode — configure how Shift+Enter behaves for each AI agent (Kitty protocol, newline, or Ctrl+J). Qwen and Agento default to Ctrl+J mode; others fall back to the default mode below.
- Activity rail on the left — files, project search, Git, editor, SSH panel and settings; the active item is marked with a single accent line
- Command palette —
Cmd+K/Ctrl+K(orCmd+Shift+P): fuzzy search over every app command (panels, tabs, themes, settings) with shortcuts shown next to each - Flat, consistent UI — one set of design tokens, a single modal/button/toast implementation, visible keyboard focus, context menus operable from the keyboard
- Busy indicator on tabs — a pulsing dot while a command or agent is running
- Panel widths are remembered between launches
- 14 built-in themes — eTty Dark and eTty Light (default), Dark, Light, Catppuccin Mocha/Latte, Monokai Pro, Dracula, One Dark, Nord, Solarized Dark/Light, Gruvbox Dark, GitHub Light, Tokyo Night, Night Owl; every theme gets readable text contrast (≥ 4.5:1) automatically
- Light, dark or "follow the system" — Settings → Appearance; theme picker with live mini-terminal previews
- Terminal font — size, line height and font family, applied on the fly (Settings → Terminal)
- Settings sections — navigation by section, search across all settings, "Saved" stamp, Esc to close, and a read-only list of keyboard shortcuts
- Focus indicator — soft glow frame, 2px frame, top line, or none
- Swipe modifier — vertical two-finger swipes can require Shift, Option or Cmd/Ctrl so they never fight with scrolling (Settings → Terminal)
- File tree behavior — collapse children on close, single/double-click to open
- Prompt style — default (from
~/.zshrc), short, minimal, arrow (for new tabs) - Status bar size — compact, standard, or large; adjustable in Settings → Appearance
- New tab placement —
modifierAdjacent(Cmd/Ctrl opens next to active tab) ormodifierEnd(Cmd/Ctrl appends to end); configurable in Settings → Terminal - Tab switch hotkey — off,
Cmd+Option+←/→, orCmd+Shift+←/→; configurable in Settings → Terminal - Open links in system browser —
clickorcmd-click(Cmd/Ctrl+click, default) on a terminal link opens it in the default browser; configurable in Settings → Terminal - Default Shift+Enter mode — Kitty protocol, newline, or Ctrl+J; the fallback for agents without a per-agent override, configurable in Settings → Terminal
- SSH panel position — off (default), left, or right; configurable in Settings → SSH Panel
- SSH panel mode — SSH (regular tabs) or tmux (persistent sessions); switched right in the panel header
- AI agent quick replies — CRUD editor with per-agent toggles; drag-and-drop reordering and grouping into a tree
- Full settings backup (
*.ettybackup) — Settings → Backup exportsconfig.json(appearance, terminal, file tree, SSH panel, agents with proxy, quick replies) and your custom themes into one file; SSH connections are optional and, when included, the file is encrypted with a passphrase (PBKDF2-SHA256 + AES-256-GCM), private keys only if you tick the box. Import replaces the config and themes (themes upserted byid), merges connections byid, keeps a copy of the previous settings inuserData/eTty/backups/<timestamp>/, and restarts the app so everything applies - Auto-persisted to disk with debounced saves
- Tab state saved on quit, restored on next launch (with confirmation dialog)
- Per-tab tree state — expanded directories and scroll position remembered when switching tabs
- Menu option to manually restore tabs
- Detects nvm, fnm, and asdf — reads the manager already installed on your system (plus fnm, nvm-windows and Volta on Windows)
- Switch, install, uninstall Node.js versions from a dialog, no manual shell commands
- Current version shown per-project, respecting
.nvmrcwhere present - Status bar indicator — shows the version actually running in the active tab (local or SSH), reported by the shell hook; click to open the version dialog
- macOS, Windows, Linux — native window controls and shell resolution per platform
- Shell auto-detection — resolves the login shell and its
PATHcorrectly even when launched from a GUI (Dock/Start Menu), not just from a terminal - Windows first-class — PowerShell 7 / Windows PowerShell 5.1 / Git Bash /
cmd.exewith cwd sync (OSC 7), busy indicator (OSC 133), node version reporting and per-tab history; Windows paths, agent detection and the remote file tree work without a POSIX shell anywhere
eTty Mobile (mobile/, Flutter) is the phone-sized sibling of the desktop app — an SSH terminal with persistent tmux sessions.
- SSH + tmux — pure-Dart client (
dartssh2), several tabs per connection, sessions survive app restarts and are shared with the desktop app (same protocol and tmux socket) - Session picker — list and open the server's tmux sessions, or start a new one in a folder chosen in the file tree
- Remote file tree and editor — browse (including hidden files), edit and share files over SFTP
- Bidirectional clipboard — TUI apps copy to system clipboard via OSC 52; radial command wheel features a built-in "Clipboard" group with
Paste(bracketed paste) andCopy(terminal selection to clipboard) - Floating action button — a draggable button over the terminal: tap sends Shift+Enter, double-tap pastes from the clipboard, long-press opens a grid panel of your own actions (keys,
Paste,Copy,Attach file); enablement, tap bindings, panel contents and position live in Settings → Floating button - Touch gestures in the terminal — one-finger scroll (tmux history, mouse wheel for TUI apps — Page Up/Down on full-screen TUIs including alternate-screen apps that enable DECSET 1007, local scrollback), two-finger swipe sends an arrow key, tap clicks in mouse-aware TUIs (htop, mc, vim), long-press selects text, a plain three-finger tap opens the quick-action wheel (Ctrl+C, Esc, Shift+Tab, Ctrl+O, Ctrl+D, Ctrl+L, attach a photo/file — pick a sector with a tap), two-finger double-tap opens a two-level wheel of your own commands (Settings → Quick commands); a key row above the keyboard has Esc, Tab, arrows, modifiers and Shift+Enter
- Security — biometric lock (Android
FlutterFragmentActivity/ iOS Face ID/Touch ID); secrets in the OS secure storage; import of desktop connections via.ettyx
Build and run instructions: mobile/README.md.
| Shortcut | Action |
|---|---|
Cmd+K / Ctrl+K, Cmd+Shift+P |
Command palette |
Cmd+, / Ctrl+, |
Open settings |
Cmd+Shift+G / Ctrl+Shift+G |
Toggle Git panel |
Cmd+F / Ctrl+F |
Open project search dialog |
Cmd+E / Ctrl+E |
Toggle editor panel |
Cmd+S / Ctrl+S |
Save file in editor |
Cmd+Enter |
Send selection from editor to terminal |
Shift+Enter |
Kitty protocol: \x1b[13;2u |
Ctrl+Enter |
Kitty protocol: \x1b[13;5u |
Ctrl+Shift+Enter |
Kitty protocol: \x1b[13;6u |
Cmd+ArrowLeft (macOS) |
Home — \x1b[H |
Cmd+ArrowRight (macOS) |
End — \x1b[F |
Cmd+Option+←/→ or Cmd+Shift+←/→ (configurable, off by default) |
Switch to adjacent tab (wraps around) |
Cmd+Shift+T |
New local tab (even when the active tab is SSH); right-click on + also offers local / SSH connections |
| Component | Technology |
|---|---|
| Desktop shell | Electron 33 |
| Build tooling | electron-vite (Vite-based) |
| Terminal UI | xterm.js 5.5 + Canvas/WebGL/DOM, Fit, WebLinks, Search addons |
| PTY backend | node-pty 1.1 (native module) |
| Code editor | CodeMirror 6 with 13 language packages (JS/TS, Python, Go, Rust, HTML, CSS, JSON, YAML, Markdown, Vue, C#) |
| Git operations | simple-git |
| Mobile app | Flutter (Dart 3.13+, dartssh2) for iOS and Android |
| UI font | Roboto (global application font) |
| Packaging | electron-builder |
| Logging | electron-log |
| Auto-update | electron-updater (stub) |
- Node.js 18+
- Native module toolchain for
node-pty(rebuilt automatically viapostinstall):- macOS: Xcode Command Line Tools —
xcode-select --install - Windows: Visual Studio Build Tools with the "Desktop development with C++" workload, plus Python 3
- Linux:
build-essential,python3
- macOS: Xcode Command Line Tools —
npm install
npm run dev# 1. Compile with electron-vite
npm run build
# 2. Package distributable
npm run dist # macOS .dmg (arm64 + x64)
npm run dist:win # Windows NSIS installer
npm run dist:linux # Linux AppImage + .debOutput goes to dist/.
Without certificates the app is signed ad-hoc — fine for local testing. For a signed and notarized release:
export CSC_LINK=/path/to/certificate.p12
export CSC_KEY_PASSWORD=...
export APPLE_ID=you@example.com
export APPLE_APP_SPECIFIC_PASSWORD=xxxx-xxxx-xxxx-xxxx
export APPLE_TEAM_ID=XXXXXXXXXX
npm run build && npm run distcodesign -dv --verbose=4 dist/mac-arm64/eTty.app
spctl -a -vvv -t install dist/mac-arm64/eTty.app┌────────────────────────────────────────────────────────────────────────┐
│ Main Process │
│ ┌──────────┐ ┌──────────┐ ┌──────────────────────────┐ │
│ │PtyManager│ │FileManager│ │ HistoryManager │ │
│ │ node-pty │ │ fs ops │ │ global + per-tab │ │
│ └──────────┘ └──────────┘ └──────────────────────────┘ │
│ ┌──────────┐ ┌──────────────┐ ┌────────────┐ │
│ │ TabState │ │SettingsStore │ │AgentService│ │
│ │ persist │ │ = ConfigLoader│ │detect CLI │ │
│ │ │ │ + ThemeLoader │ │ │ │
│ └──────────┘ └──────────────┘ └────────────┘ │
│ ┌────────────────────┐ ┌──────────────────────────────────────┐ │
│ │ShellPathResolver │ │ NodeVersionManager │ │
│ │login shell + PATH │ │ nvm / fnm / asdf detect, switch │ │
│ │(GUI-launch fix) │ │ │ │
│ └────────────────────┘ └──────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ AppService — window, menu, auto-updater, state save on quit │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ ┌────────┐┌────────┐┌────────┐┌────────┐┌────────┐┌────────┐┌──────┐│
│ │pty ││fs ││git ││tabs ││settings││agents ││... ││
│ │-handl. ││-handl. ││-handl. ││-handl. ││-handl. ││-handl. ││search││
│ └────────┘└────────┘└────────┘└────────┘└────────┘└────────┘└──────┘│
└──────────────────────────┬───────────────────────────────────────────┘
│ IPC (70+ channels, constants in shared/)
┌──────────────────────────┴───────────────────────────────────────────┐
│ Preload (contextBridge) │
│ ~90 methods on window.electronAPI │
└──────────────────────────┴───────────────────────────────────────────┘
│
┌──────────────────────────┴───────────────────────────────────────────┐
│ Renderer Process │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Core Infrastructure │ │
│ │ EventBus │ StateStore │ DI Container │ ElectronApiAdapter │ │
│ │ GitStatusService (polling) │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ ┌────────┐ ┌────────┐ ┌──────────┐ ┌──────────────────┐ ┌────────┐ │
│ │Terminal│ │FileTree│ │EditorPanel│ │ GitPanel (master/ │ │Settings│ │
│ │xterm.js│ │ lazy │ │CodeMirror │ │ detail, features/ │ │Page │ │
│ │ tabs │ │ DnD │ │ 20+ langs │ │ git/*) │ │overlay │ │
│ └────────┘ └────────┘ └──────────┘ └──────────────────┘ └────────┘ │
│ ┌────────┐ ┌────────────────┐ ┌────────────────┐ ┌─────────────┐ │
│ │ TabBar │ │ ProjectSearch │ │NodeVersionDialog│ │ StatusBar │ │
│ │reorder │ │ dialog │ │ nvm/fnm/asdf UI │ │git±│cwd│AI │ │
│ └────────┘ └────────────────┘ └────────────────┘ └─────────────┘ │
└────────────────────────────────────────────────────────────────────┘
The codebase follows a layered architecture after a 4-block refactoring:
- DI Container (
renderer/core/container.js) — components receive dependencies via constructor injection, not global variables - EventBus (
renderer/core/event-bus.js) — pub/sub communication between decoupled components - StateStore (
renderer/core/state-store.js) — centralized reactive state with subscriptions (ui.theme,ui.sidebarVisible, etc.) - IPC_CHANNEL constants (
shared/ipc-channels.js) — single source of truth for all IPC channel names, no string literals - IPC handler modules (
main/ipc-handlers/*.js) — each domain group in its own file withregister*Handlers(ipcMain, deps)signature - AppService (
main/services/app-service.js) — application lifecycle in main process (window, menu, updater, state save)
All user data is stored in ~/.config/eTty/ (Electron userData):
| File | Purpose |
|---|---|
config.json |
App settings (theme, focus indicator, file tree behavior, prompt style, agent proxy, force-disabled/force-enabled agents, custom agents, quick replies, SSH panel position and mode); versioned, deep-merged with defaults on load |
themes/*.json |
User-defined custom themes, loaded alongside the 14 built-ins |
ssh-connections.json |
Saved SSH connections; passwords/passphrases encrypted via safeStorage |
tabs-state.json |
Saved tab state for session restore |
history/global.zsh_history |
Shared command history (5000 lines) |
history/tabs/<id>.zsh_history |
Per-tab command history |
backups/<timestamp>/ |
Snapshot of config.json and themes/ taken before a settings-backup import (manual rollback) |
node-ptyis a native module. electron-builder rebuilds it automatically vianpmRebuild: true.build/entitlements.mac.plistcontains macOS entitlements required for node-pty under hardened runtime (JIT, unsigned memory, library validation).- Auto-update is stubbed — logs only, no update server configured yet.
- Settings overlay blocks tab switching to prevent focus leaking to hidden terminals.
- Saved SSH passwords are auto-filled via
SSH_ASKPASSon macOS/Linux (OpenSSH ≥ 8.4); on Windows the same works via anaskpass.cmdhelper when OpenSSH ≥ 8.4 is installed (otherwise the terminal prompts for the password). - The remote file tree, remote agent tracking and the tmux session list use a second service connection. On macOS/Linux it multiplexes over SSH ControlMaster; OpenSSH for Windows has no ControlMaster, so there eTty opens a separate long-lived
ssh -T … /bin/shchannel. It authenticates non-interactively (key /ssh-agent, or a saved password viaaskpass), so on Windows an SSH tab without either stays terminal-only. - Passing the working directory and busy state through tmux needs tmux ≥ 3.3 on the server (DCS passthrough); on older versions persistent sessions still work, with the optimistic busy fallback.
Private