TEDI

Terminal Director

One lightweight app. Eight features. Your whole dev workflow in a single window.

What is TEDI?

TEDI (Terminal Director) folds eight tools you reach for every day (a terminal, SSH client, DB browser, editor, AI agent, browser, API client, and Git) into one window, so you stop alt-tabbing. Built on Tauri 2, so a Rust core owns every OS resource and the UI is a single webview: no Node runtime, no bundled Chromium, and a resident footprint closer to a terminal than to an IDE. No telemetry; API keys stay in the OS keychain, and it runs fully offline against a local model if you want.

The eight features

| # | Feature | What it does | | --- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1 | Terminal multiplexer | Native PTY terminals (zsh / bash / fish / pwsh) on xterm.js + WebGL: split panes, tab groups, shell integration (OSC 7 / 133), inline search, and link detection. Inactive tabs keep streaming. Each workspace holds its own tab layout and working dirs and reopens exactly where you left it. | | 2 | SSH connection | Connect to remote hosts (russh), open remote shells, and browse/transfer files over an integrated SFTP explorer, all from a saved connection manager. | | 3 | SQL explorer _(extension)_ | Query MySQL, PostgreSQL and SQLite from a dedicated panel, with a schema tree and inline row edits. Reaches a database behind a bastion over an SSH tunnel. Ships as an extension (feature 8), so it installs and updates at runtime. | | 4 | Code editor | CodeMirror 6 for TS/JS, Rust, Python, PHP, HTML/CSS, JSON, Markdown, C/C++, Java, C#, SQL, and more, with inline AI autocomplete, diff view, Vim mode, and Markdown/image preview. | | 5 | AI-native agent | Bring-your-own-key agent across twelve providers (OpenAI, Anthropic, Google, xAI, Cerebras, Groq, DeepSeek, SumoPod, AgentRouter, or sign in with a ChatGPT account so a subscription pays for the turn) and local models via LM Studio or any OpenAI-compatible server (Ollama, llama.cpp, vLLM). Plan mode, MCP, ten sub-agents, voice input, project memory from AGENTS.md and TEDI.md, and tools gated by approval. | | 6 | Browser _(extension)_ | A real browser pane on the engine TEDI itself runs on (wry on WebView2, so Windows only for now), so it downloads nothing and starts no second process. Address bar, its own profile, and unpacked Chrome extensions such as an ad blocker. The agent drives the same page you do: it reads the page's accessibility tree rather than scraping the DOM, clicks and types with trusted input, and drains console errors to find out why your page broke. Ships as an extension (feature 8). | | 7 | API client _(extension)_ | Postman-style workbench: collections, environments and variables, auth (Bearer / Basic / API key / OAuth 2.0), every body mode, pre-request and test scripts, a collection runner, and Postman / OpenAPI / cURL import-export. Also an extension (feature 8). | | 8 | Source control + extensions | Inline Git diff / SCM pane, and a first-class extension system: install from a .zip or GitHub release to add settings, AI tools, commands, keybindings, panels, and status / header / sidebar items. |

Everything is fully themeable (presets, custom colors, transparency) while staying lightweight.

Install

Pre-built binaries: Releases (Windows, macOS, Linux .deb / .rpm / .AppImage). Download for your OS and install; TEDI auto-checks for updates.

Download size

| Target | Size | | --------------------------- | ---------------------------------------------------------------------------------------- | | Windows .exe | 9.4 MB | | macOS .dmg | 11.3 MB (Intel) / 10.8 MB (Apple silicon) | | Linux .deb / .rpm | 11.2 MB | | Linux .AppImage | 95.6 MB. It carries its own GTK/WebKit runtime; the .deb and .rpm use the system one | | Installed on disk (Windows) | ~19 MB |

It stays this small because the UI is one webview provided by the OS: no Node runtime and no bundled browser engine. Extensions are installed at runtime and are not in the download, and they inherit the same property: the Browser extension adds no engine at all, because a browser pane is another webview from the same OS runtime the shell already uses.

Screenshots

Configure AI

Settings → AI, pick a provider and paste your API key. Keys go to the OS keychain via keyring, never to disk or localStorage. Full list: PROVIDERS in src/modules/ai/config.ts.

Running fully local? Two routes, both keyless:

• LM Studio is its own provider. Start its server and point TEDI at it (default http://localhost:1234/v1).
• OpenAI Compatible takes any server that speaks the API, and you can add several at once. Presets ship for Ollama (:11434), llama.cpp (:8080), vLLM (:8000), plus OpenRouter and 9Router. A localhost / 127.0.0.1 endpoint needs no API key; leave the field blank.

Extensions

TEDI ships no extensions in the binary; every one (including the SQL explorer and the API client, features 3 and 7) installs at runtime. Re-installing the same manifest.id replaces the old copy, so the same path handles updates.

Settings → Extensions → From file       (pick a local .zip)
Settings → Extensions → From GitHub     (paste owner/repo)
Settings → Extensions → Check updates   (re-check releases/latest)

Per-extension icon, namespaced settings/secrets/storage, and a permission-gated host API. Authoring guide: extensions/README.md. Reference extension: Discord Rich Presence.

CLI

tedi [PATH]          # open a folder or file in TEDI
tedi .               # open the current directory
tedi ext <subcmd>    # manage extensions headlessly (install / list / update / ...)
tedi theme <subcmd>  # manage themes from the terminal
tedi --help | --version | --update

If TEDI is already running, the request forwards to the existing window (no second instance). On macOS / Linux AppImage the tedi command is not on PATH by default: Settings → General → "Install tedi command in PATH" creates a shim at ~/.local/bin/tedi. Windows' installer handles this.

Architecture

A Tauri 2 app: a React 19 webview (src/) talks to a Rust backend (src-tauri/) via invoke() and streaming Channels. See ARCHITECTURE.md for a one-page map, then AGENTS.md for the commands, rules and gotchas.

Build from source

Prereqs: Rust stable (rustup), Node 20.19+ / 22.12+ with pnpm, and Tauri's platform prereqs.

pnpm install
pnpm tauri:dev     # dev (isolated data dir)
pnpm tauri build   # production bundle

Pre-PR checks (full list in CONTRIBUTING.md):

pnpm exec tsc --noEmit && pnpm lint:imports && pnpm format:check
cd src-tauri && cargo clippy && cargo fmt

Notes per platform

• Windows: SmartScreen warns on first launch (unsigned); click _More info > Run anyway_. Shell priority: pwsh.exe, powershell.exe, cmd.exe.
• Linux: TEDI turns WebKitGTK's DMA-BUF renderer off by itself on anything but Mesa-backed GNOME/KDE/COSMIC, and on any session with no DRM render node, because without a working EGL display the web process aborts with EGL_BAD_PARAMETER before the window opens. It prints the reason on stderr; force the decision either way with WEBKIT_DISABLE_DMABUF_RENDERER=1 (safe) or =0 (hardware). App opacity / glass needs a running compositor, so on a bare tiling WM start one (picom) or leave that setting off. AppImage needs FUSE (else --appimage-extract-and-run, or use the .deb / .rpm); on Arch that is the fuse2 package, and .deb / .rpm are not usable there.
• macOS: minimum 10.15. Unsigned builds may trip Gatekeeper; drag to /Applications, run xattr -cr /Applications/TEDI.app once, then open from Finder.

Credits

TEDI is a fork of crynta/[email protected] by Crynta. The Tauri/Rust backend, the xterm.js terminal, the CodeMirror editor, and the AI agent pipeline are the work of Crynta and the Terax contributors. Same Apache-2.0 license; if TEDI is useful, please star upstream Terax.

License

Apache-2.0. See LICENSE and NOTICE for required attribution.