{"id":49899885,"url":"https://github.com/ilhamrisky/tedi","last_synced_at":"2026-06-08T03:03:42.284Z","repository":{"id":357507651,"uuid":"1237164472","full_name":"IlhamriSKY/TEDI","owner":"IlhamriSKY","description":"TEDI - Terminal Environment \u0026 Development Infrastructure.","archived":false,"fork":false,"pushed_at":"2026-05-31T03:18:13.000Z","size":25208,"stargazers_count":20,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-31T03:19:03.607Z","etag":null,"topics":["ai","claude-code","cmd","codex","open-source","opencode","powershell","terminal"],"latest_commit_sha":null,"homepage":"https://tedi.ilhamriski.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IlhamriSKY.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-13T00:00:22.000Z","updated_at":"2026-05-31T03:18:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/IlhamriSKY/TEDI","commit_stats":null,"previous_names":["ilhamrisky/tedi"],"tags_count":42,"template":false,"template_full_name":null,"purl":"pkg:github/IlhamriSKY/TEDI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IlhamriSKY%2FTEDI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IlhamriSKY%2FTEDI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IlhamriSKY%2FTEDI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IlhamriSKY%2FTEDI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IlhamriSKY","download_url":"https://codeload.github.com/IlhamriSKY/TEDI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IlhamriSKY%2FTEDI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34046005,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-08T02:00:07.615Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude-code","cmd","codex","open-source","opencode","powershell","terminal"],"created_at":"2026-05-16T03:45:55.639Z","updated_at":"2026-06-08T03:03:42.279Z","avatar_url":"https://github.com/IlhamriSKY.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"public/icon.png\" width=\"120\" height=\"120\" alt=\"TEDI\" /\u003e\n  \u003ch1\u003eTEDI\u003c/h1\u003e\n  \u003cp\u003e\u003cstrong\u003eOne lightweight app. Eight features. Your whole dev workflow in a single window.\u003c/strong\u003e\u003c/p\u003e\n\n  \u003cp\u003e\n    \u003cimg src=\"https://img.shields.io/badge/license-Apache--2.0-green\" alt=\"license\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey\" alt=\"platform\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/footprint-~7--10%20MB-brightgreen\" alt=\"footprint\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/telemetry-none-blue\" alt=\"no telemetry\" /\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n## What is TEDI?\n\n**TEDI** (**T**erminal **E**nvironment \u0026 **D**evelopment **I**nfrastructure) is a lightweight, low-footprint desktop app that folds eight tools devs reach for every day into one window - so you stop alt-tabbing between a terminal, an SSH client, a DB browser, an editor, an AI chat, a browser, and a Git tool.\n\nBuilt on Tauri 2 (Rust + a single webview), the whole app ships in roughly **7-10 MB** with **no telemetry** and API keys kept in the OS keychain.\n\n## The eight features\n\n| # | Feature | What it does |\n|---|---------|--------------|\n| 1 | **Terminal multiplexer** | Native PTY terminals (zsh / bash / fish / pwsh) on xterm.js + WebGL, split horizontally/vertically, grouped into tabs, with shell integration (cwd + prompt markers via OSC 7 / 133), inline search, and link detection. Inactive tabs keep streaming in the background. |\n| 2 | **SSH connection** | Connect to remote hosts (`russh`), open remote terminals, and browse/transfer files over an integrated **SFTP** explorer - all from a saved connection manager. |\n| 3 | **SQL explorer** *(extension)* | Browse and query databases from a dedicated panel - delivered through TEDI's extension system (see feature 8), so it installs at runtime and updates independently. |\n| 4 | **Code editor** | CodeMirror 6 with TS/JS, Rust, Python, PHP, HTML/CSS, JSON, Markdown, C/C++, Java, C#, SQL and more - plus inline AI autocomplete, diff view, Vim mode, image preview, and side-by-side Markdown preview. |\n| 5 | **AI-native agent** | Bring-your-own-key agent (OpenAI, Anthropic, Google, Groq, xAI, Cerebras, DeepSeek, any OpenAI-compatible endpoint, and **local** LM Studio). Multi-agent / sub-agents, voice input, project memory via `TEDI.md`, and tools (read / write / grep / glob / shell) gated behind explicit approval. |\n| 6 | **AI browser control** | A real in-app browser (native webview, not an iframe) that the agent can drive end-to-end: navigate, read the page, type like a human, click, scroll, and - as a last resort - screenshot the tab to *see* it. Group and rotate browser panes alongside your terminals. |\n| 7 | **Workspaces** | Each workspace keeps a distinct project session (tab layout + working dirs) and switches instantly without re-opening folders. The header's open-folder picker spawns a terminal rooted at the chosen directory. |\n| 8 | **Source control + extensions** | Inline Git diff / SCM pane for staging and reviewing changes, and a first-class **extension/plugin** system: install from a local `.zip` or a GitHub release and pull in settings, themes, slash commands, AI tools, commands, keybindings, and panels (this is how the SQL explorer above plugs in). |\n\n…and it's all **fully themeable** - presets, custom colors, transparency, and extension-supplied themes - while staying lightweight.\n\n## Install\n\nPre-built binaries: **[Releases](https://github.com/IlhamriSKY/TEDI/releases/latest)**.\n\nWindows, macOS, and Linux (`.deb`, `.rpm`, `.AppImage`). Download the artifact for your OS and install. TEDI checks for updates automatically; re-download from Releases or check in Settings when a new version drops.\n\n## Screenshots\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/tedi1.png\" width=\"49%\" alt=\"TEDI screenshot 1\" /\u003e\n  \u003cimg src=\"docs/tedi2.png\" width=\"49%\" alt=\"TEDI screenshot 2\" /\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/tedi3.png\" width=\"49%\" alt=\"TEDI screenshot 3\" /\u003e\n  \u003cimg src=\"docs/tedi4.png\" width=\"49%\" alt=\"TEDI screenshot 4\" /\u003e\n\u003c/p\u003e\n\n## Configure AI\n\nSettings \u003e AI \u003e pick a provider, paste your API key. For local/offline inference, point TEDI at your LM Studio endpoint. Keys are written to the OS keychain via `keyring` - they never touch disk or `localStorage`. Full provider list: `PROVIDERS` in [src/modules/ai/config.ts](src/modules/ai/config.ts).\n\n## Extensions\n\nTEDI ships **no extensions** in the binary - every extension (the SQL explorer included) is installed at runtime from either a local `.zip` or a GitHub release. Re-installing the same `manifest.id` replaces the previous copy, so the same install paths handle updates too.\n\n```\nSettings → Extensions → From file       (pick a local .zip)\nSettings → Extensions → From GitHub     (paste owner/repo)\nSettings → Extensions → Check updates   (re-hit releases/latest on every github-sourced extension)\n```\n\nPer-extension icon, namespaced settings/secrets/storage, and a permission-gated host API (`invoke`, `secrets`, `events`, `app context`, `ui.toast`). Authoring guide: [extensions/README.md](extensions/README.md) · Reference extension: [Discord Rich Presence](https://github.com/IlhamriSKY/TEDI.discord-rich-presence).\n\n## CLI Usage\n\nTEDI ships with a CLI that lets you open folders and files directly from the terminal.\n\n```bash\ntedi [PATH]          # Open a folder or file in TEDI\ntedi .               # Open the current directory\ntedi \u003cfile\u003e          # Open a file in the editor (parent folder loads in explorer)\ntedi ext \u003csubcmd\u003e    # Manage extensions headlessly (install / list / update / enable / ...)\ntedi theme \u003csubcmd\u003e  # Manage themes from the terminal\ntedi --help          # Print help message and exit\ntedi --version       # Print version and exit\ntedi --update        # Check for updates and open the update dialog\n```\n\nIf TEDI is already running, the request is forwarded to the existing window - a second instance is not opened.\n\n**Installing the `tedi` command (macOS / Linux AppImage):** the `tedi` command is not on `PATH` by default. Go to **Settings → General → \"Install `tedi` command in PATH\"** to create a shim at `~/.local/bin/tedi`. On Windows, the NSIS installer handles this automatically.\n\n## Architecture\n\nTEDI is a Tauri 2 app: a React 19 webview (`src/`) talks to a Rust backend (`src-tauri/`) through `invoke()` commands and streaming `Channel`s. Start with **[ARCHITECTURE.md](ARCHITECTURE.md)** for a one-page map with a diagram and end-to-end data-flow walkthroughs, then see [TEDI.md](TEDI.md) for the exhaustive per-module reference.\n\n## Build from source\n\nPrereqs:\n\n- Rust stable: https://rustup.rs\n- Node 20.19+ or 22.12+ and [pnpm](https://pnpm.io) (CI builds on Node 24; a `.nvmrc` pins it)\n- Tauri platform prereqs: https://tauri.app/start/prerequisites/\n\n```bash\npnpm install\npnpm tauri:dev     # dev (isolated data dir, won't touch your installed TEDI's data)\npnpm tauri build   # production bundle\n```\n\nChecks (see [CONTRIBUTING.md](CONTRIBUTING.md) for the full pre-PR list):\n\n```bash\npnpm exec tsc --noEmit          # frontend type-check\npnpm lint:imports               # module import discipline\npnpm format:check               # Prettier\ncd src-tauri \u0026\u0026 cargo clippy    # Rust lint\ncd src-tauri \u0026\u0026 cargo fmt       # Rust format\n```\n\n## Notes per platform\n\n- **Windows**: SmartScreen will warn on first launch (unsigned). Click _More info \u003e Run anyway_. Shell priority: `pwsh.exe`, `powershell.exe`, `cmd.exe`.\n- **Linux**: if you hit `EGL_BAD_PARAMETER` or a blank window, set `WEBKIT_DISABLE_DMABUF_RENDERER=1`. AppImage needs FUSE; otherwise run `--appimage-extract-and-run` or install the `.deb`/`.rpm`.\n- **macOS**: minimum macOS 10.15. If the release workflow is running without Apple Developer signing/notarization secrets, builds fall back to ad-hoc signing and Gatekeeper may say _\"TEDI can't be opened because Apple cannot check it for malicious software\"_ or _\"TEDI is damaged and can't be opened\"_ on first launch. Drag the app to `/Applications`, then in Terminal run once:\n  ```\n  xattr -cr /Applications/TEDI.app\n  ```\n  Then open from Launchpad/Finder (right-click → _Open_ the first time if still prompted).\n\n## Quality\n\n- Apache-2.0, **no telemetry**, API keys in the OS keychain (`keyring`)\n- Small bundle (~7-10 MB depending on platform), single webview, native PTY\n\n## Credits\n\nTEDI is a fork of and is derived from **[crynta/terax-ai@v0.5.9](https://github.com/crynta/terax-ai/releases/tag/v0.5.9)** by [Crynta](https://github.com/crynta). The original Tauri + Rust backend, the xterm.js terminal stack, the CodeMirror editor stack, and the AI agent pipeline are the work of Crynta and the Terax contributors. TEDI keeps the same Apache-2.0 license and tracks its own roadmap onward. If you find TEDI useful, please go give the upstream [Terax](https://github.com/crynta/terax-ai) project a star.\n\n## License\n\nApache-2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE) for required attribution.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Filhamrisky%2Ftedi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Filhamrisky%2Ftedi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Filhamrisky%2Ftedi/lists"}