🇷🇺 Русский

Modern terminal emulator built with Electron. Lightweight, fast, and feature-rich.

eTty icon

• Multiple tabs with independent zsh sessions
• WebGL-accelerated rendering (canvas fallback)
• 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
• 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)
• 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

• 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 .. and cd ~ 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
• Resizable editor panel

• Status bar showing ± +N -N diff 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-tap Shift
• 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 Enter opens 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 — Claude, Codex, Copilot, Cursor Agent, OpenCode, Qwen, Agento
• 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
• 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
• Double-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. This enables that agent's quick-reply buttons.
• 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 default to Kitty protocol.

• 7 built-in themes: Catppuccin Mocha (default), Monokai, Dracula, One Dark, Nord, Solarized Dark, Gruvbox Dark
• Focus indicator — glow, border, top-line, or none
• 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) or modifierEnd (Cmd/Ctrl appends to end); configurable in Settings → Terminal
• AI agent quick replies — CRUD editor with per-agent toggles; drag-and-drop reordering
• 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

• Node.js 18+
• macOS: Xcode Command Line Tools — xcode-select --install

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 + .deb

Output 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 dist

codesign -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 │ │
│ └──────────┘ └──────────┘ └──────────────────────────┘ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────────┐ │
│ │GitService│ │ TabState │ │SettingsStore│ │AgentService│ │
│ │ countDiff│ │ persist │ │ JSON config │ │ detect CLI │ │
│ └──────────┘ └──────────┘ └──────────────┘ └────────────┘ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ AppService — window, menu, auto-updater, state save on quit │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │pty-handl│ │fs-handl │ │git-handl│ │tabs-hand│ │settings │ ... │
│ │ ers │ │ ers │ │ ers │ │ ers │ │-handlers│ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
└──────────────────────────┬───────────────────────────────────────────┘
 │ IPC (~50 channels, constants in shared/)
┌──────────────────────────┴───────────────────────────────────────────┐
│ Preload (contextBridge) │
│ ~50 methods on window.electronAPI │
└──────────────────────────┴───────────────────────────────────────────┘
 │
┌──────────────────────────┴───────────────────────────────────────────┐
│ Renderer Process │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Core Infrastructure │ │
│ │ EventBus │ StateStore │ DI Container │ ElectronApiAdapter │ │
│ │ GitStatusService (polling) │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ ┌────────┐ ┌────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐ │
│ │Terminal│ │FileTree│ │EditorPanel│ │ GitPanel │ │SettingsPage │ │
│ │xterm.js│ │ lazy │ │CodeMirror │ │ diff │ │ overlay │ │
│ │ tabs │ │ DnD │ │ 20+ langs │ │ branches │ │ themes │ │
│ └────────┘ └────────┘ └──────────┘ └──────────┘ └──────────────┘ │
│ ┌────────┐ ┌────────────────┐ ┌─────────────────────────────────┐ │
│ │ TabBar │ │ ProjectSearch │ │ StatusBar │ │
│ │reorder │ │ dialog │ │ git ± │ cwd │ AI agents │ │
│ └────────┘ └────────────────┘ └─────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────────┘

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 with register*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):

• node-pty is a native module. electron-builder rebuilds it automatically via npmRebuild: true.
• build/entitlements.mac.plist contains 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.

Private