Uniterm AI Agent

<div align="center"> <img src="build/appicon.png" alt="uniTerm" width="128" height="128" /> <h1>uniTerm</h1> <p>All-in-one terminal covering 30+ protocols — SSH, RDP, SFTP, databases, Kubernetes and more<br>With a built-in AI Agent that runs multi-turn shell commands autonomously</p> <p><a href="https://uniterm.net">🌐 Homepage</a> &nbsp;|&nbsp; <a href="https://uniterm.net/guide/en/introduction">📖 User Guide</a> &nbsp;|&nbsp; <a href="https://github.com/ys-ll/uniterm">💻 GitHub</a> &nbsp;|&nbsp; <a href="https://gitee.com/ys-l/uniterm">💻 Gitee</a></p> </div> <div align="center">

<a href="README_zh-CN.md">简体中文</a>  |  <a href="README_zh-TW.md">繁體中文</a>  |  English  |  <a href="README_ja.md">日本語</a>  |  <a href="README_ko.md">한국어</a>  |  <a href="README_de.md">Deutsch</a>  |  <a href="README_es.md">Español</a>  |  <a href="README_fr.md">Français</a>  |  <a href="README_ru.md">Русский</a>  |  <a href="README_pt.md">Português</a>  |  <a href="README_vi.md">Tiếng Việt</a>

<br>

<a href="https://github.com/ys-ll/uniterm/releases/latest"><img src="https://img.shields.io/github/v/release/ys-ll/uniterm" alt="GitHub release" /></a> <a href="https://github.com/ys-ll/uniterm"><img src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux%20%7C%20Android%20%7C%20Docker-blue" alt="Platform" /></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-green" alt="License" /></a> <a href="https://github.com/ys-ll/uniterm/releases"><img src="https://img.shields.io/github/downloads/ys-ll/uniterm/total" alt="GitHub downloads" /></a> <a href="https://github.com/ys-ll/uniterm"><img src="https://img.shields.io/github/stars/ys-ll/uniterm?style=social" alt="GitHub stars" /></a> <a href="https://gitee.com/ys-l/uniterm"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fgitee.com%2Fapi%2Fv5%2Frepos%2Fys-l%2Funiterm&query=%24.stargazers_count&label=Stars&style=social&logo=gitee" alt="Gitee stars" /></a> <br> <a href="https://trendshift.io/repositories/109042?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-109042" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/109042" alt="ys-ll%2Funiterm | Trendshift" width="250" height="55"/></a> <a href="https://alternativeto.net/software/uniterm/about/?utm_source=badge&amp;utm_medium=referral" target="_blank"> <img src="https://alternativeto.net/static/badges/badge-compact-color.svg" alt="uniTerm | AlternativeTo" width="171" height="55" style="width: 171px; height: 55px;" /> </a>

</div>

Table of Contents

• Features
• Supported Protocols
• Screenshots
• Download
• Quick Workflows
• Tech Stack
• Build from Source
• Project Structure
• Roadmap
• Star this Project
• Feedback & Contributing
• License

Features

Full-Featured Terminal

Remote terminal, local & serial terminal, file transfer, remote desktop, database, containers, and server monitor — covering all remote access needs.

• Terminal — SSH / Telnet / Mosh / Raw TCP / Serial, plus local shells (PowerShell / CMD / Git Bash / WSL).
• File Transfer — SFTP / SCP / FTP / FTPS / SMB / WebDAV / S3 / Zmodem with dual-pane browsing and rz/sz support in SSH terminals.
• Remote Desktop — RDP (Windows Remote Desktop), VNC (Linux remote control), SPICE (KVM/QEMU VMs), X11 (X Window forwarding)
• Database Client — MySQL / PostgreSQL / Oracle / SQL Server / SQLite / rqlite / Redis / MongoDB / Elasticsearch, with AI-powered natural-language queries and data-row editing.
• Kubernetes & Containers — Kubernetes / Docker / Podman / nerdctl (containerd) / WSLC, with cluster resource & image management, Pod logs and exec terminals, and CPU/memory metrics.
• Server Monitor — Real-time CPU, memory, disk, network, processes, ports, and network interfaces.

AI Agent

Autonomous AI Agent that independently plans and executes multi-turn shell commands directly in your terminal.

• Autonomous AI Agent — The AI Agent can plan, execute, observe results, and iterate across multiple rounds of shell commands without manual intervention; sidebar chat with Anthropic/OpenAI-compatible API, supporting Claude, GPT and other compliant models.
• Flexible Execution Modes — Bypass, dangerous only, dangerous + write, or confirm all — you control how much oversight the AI Agent needs.
• Terminal Integration — AI commands execute directly in the active terminal tab, with optional pinning to a specific tab or following your active one. Collaborate side-by-side in split panes, each with its own terminal context.
• MCP Server — Built-in MCP server that lets external AI agents (Claude Code, Codex, Gemini CLI, ...) run commands and transfer files on saved connections — credentials never leave the app.
• Skills & Commands — Reusable skill workflows and prompt-template commands, attached with / in the AI input; the AI can also save new skills itself; external MCP servers can also be connected to extend the AI's toolbox.
• Smart Completion — Real-time completion while typing, based on command history and AI capabilities.

Personalization

Connection management, split panes, cloud sync, themes & i18n — your terminal, your way.

• Connection Manager — Group, search, and batch-manage server connections; encrypted import/export, and import from other terminal apps (MobaXterm, Xshell, etc.).
• Workspace — Drag terminal tabs into the content area to split freely and combine them into a workspace; drag panel edges to resize and rearrange.
• Network Toolbox — Network scanning, SSH port forwarding tunnels, and local services to run temporary servers for other devices.
• Cloud Sync — Encrypted cloud sync in five modes: Git repository, WebDAV, SFTP, S3 and SMB — no worry about data loss or leaks, and pick up your work seamlessly across devices.
• Themes & Internationalization — 28 terminal themes plus 3 UI themes (Dark / Deep Blue / Light) and a customizable background image; 11-language UI: Simplified Chinese, Traditional Chinese, English, Japanese, Korean, German, Spanish, French, Russian, Portuguese, Vietnamese.

Supported Protocols

Category	Protocol	Description
Terminal	SSH	Remote server shell management
Terminal	Telnet	Remote terminal for legacy devices and embedded systems
Terminal	Mosh	Server connections over high-latency or intermittent networks
Terminal	Serial	Serial port terminal with configurable baud rate and other parameters
Terminal	Raw TCP	Raw TCP console that opens a plain socket and transceives raw bytes
Terminal	Local	PowerShell, CMD, Git Bash, and other local shells
Terminal	WSL	Open installed WSL distributions via local terminal (Windows only)
File Transfer	SFTP	Server file management and transfer
File Transfer	SCP	Fallback protocol for legacy SSH servers that do not support SFTP
File Transfer	FTP / FTPS	Website hosting, NAS file transfer
File Transfer	SMB	Windows shared folders, NAS file access
File Transfer	WebDAV	WebDAV server file management
File Transfer	S3	Amazon S3 compatible object storage
File Transfer	Zmodem	In-terminal file transfer via rz/sz commands
Remote Desktop	RDP	Windows server remote desktop management
Remote Desktop	VNC	Linux server remote control
Remote Desktop	SPICE	KVM/QEMU VM management
Remote Desktop	X11	X Window forwarding
Database	MySQL	MySQL protocol: MySQL, MariaDB, TiDB, and more
Database	PostgreSQL	PostgreSQL protocol: PostgreSQL, CockroachDB, and more
Database	Oracle Database	Oracle Database connections through a pure Go driver
Database	SQL Server	SQL Server connections through a pure Go driver
Database	SQLite	Embedded local database, connect by opening the database file
Database	rqlite	Lightweight distributed DB built on SQLite with Raft consensus
Database	Redis	In-memory key-value store with visual key browsing and editing
Database	MongoDB	Document database with tree browsing, query editor, and inline editing
Database	Elasticsearch	Distributed search and analytics engine with index and document management
Containers	Kubernetes	Cluster resource browsing and management, Pod logs and exec, performance metrics
Containers	Docker	Container and image management, on the local machine or remote hosts over SSH
Containers	Podman	Docker-compatible container engine, on the local machine or remote hosts over SSH
Containers	nerdctl (containerd)	containerd container management with namespace switching
Containers	WSLC	Windows WSL2 Container runtime (Windows only)

Oracle Database support is implemented with a pure Go driver. uniTerm does not bundle Oracle Database, Oracle Instant Client, OJDBC, wallet files, or Oracle brand assets; users are responsible for their own Oracle licenses, credentials, and database access.

Screenshots

<p align="center"> <picture> <source srcset="docs/imgs/start_tab.webp" media="(prefers-color-scheme: dark)" /> <img src="docs/imgs/start_tab_light.webp" alt="Start Page" width="45%" loading="eager" /> </picture> <picture> <source srcset="docs/imgs/new_connection.webp" media="(prefers-color-scheme: dark)" /> <img src="docs/imgs/new_connection_light.webp" alt="New Connection" width="45%" loading="eager" /> </picture> </p> <p align="center"> <picture> <source srcset="docs/imgs/ai_assistant.webp" media="(prefers-color-scheme: dark)" /> <img src="docs/imgs/ai_assistant_light.webp" alt="SSH Terminal with AI Assistant" width="45%" loading="eager" /> </picture> <picture> <source srcset="docs/imgs/workspace.webp" media="(prefers-color-scheme: dark)" /> <img src="docs/imgs/workspace_light.webp" alt="Workspace" width="45%" loading="eager" /> </picture> </p> <p align="center"> <picture> <source srcset="docs/imgs/sftp.webp" media="(prefers-color-scheme: dark)" /> <img src="docs/imgs/sftp_light.webp" alt="SFTP File Transfer" width="45%" loading="eager" /> </picture> <picture> <source srcset="docs/imgs/database.webp" media="(prefers-color-scheme: dark)" /> <img src="docs/imgs/database_light.webp" alt="Database Browser" width="45%" loading="eager" /> </picture> </p> <p align="center"> <picture> <source srcset="docs/imgs/kubernetes.webp" media="(prefers-color-scheme: dark)" /> <img src="docs/imgs/kubernetes_light.webp" alt="Kubernetes Management" width="45%" loading="eager" /> </picture> <img src="docs/imgs/background_image.webp" alt="Terminal Background Image" width="45%" loading="eager" /> </p>

Download

Get the latest pre-built binaries from GitHub Releases or Gitee Releases:

• Windows (amd64 / arm64): installer uniterm-windows-*-installer-*.exe, or portable uniterm-windows-*-portable-*.zip
• macOS (Apple Silicon arm64 / Intel amd64): Download uniterm-darwin-*-*.dmg
• Linux (amd64 / arm64): Download uniterm-linux-*-*.tar.gz, .deb, or .rpm
• Android (arm64): Download uniterm-android-arm64-*.apk
• Docker (amd64 / arm64): web multi-tenant deployment — a browser-accessible server deployment where every user gets an isolated workspace, see the Docker deployment guide

About Windows antivirus false positives: As this open-source software has not purchased a code-signing certificate, the unsigned executable may trigger false positives in some antivirus engines (e.g. Windows Defender). This is a known issue with Go/Wails applications (see wailsapp/wails#3308). You can add an exclusion rule in your antivirus to allow it. Please download only from the official open-source channels — GitHub and Gitee. If you are still concerned about malware, you can download the source code and build and run it locally yourself.

Package Managers

# Windows
scoop bucket add uniterm https://github.com/ys-ll/scoop-uniterm && scoop install uniterm

# macOS
brew install --cask ys-ll/uniterm/uniterm

# Linux (deb)
curl -sLo uniterm.deb https://github.com/ys-ll/uniterm/releases/latest/download/uniterm-linux-amd64-*.deb
sudo dpkg -i uniterm.deb

# Linux (rpm)
curl -sLo uniterm.rpm https://github.com/ys-ll/uniterm/releases/latest/download/uniterm-linux-amd64-*.rpm
sudo rpm -i uniterm.rpm

Runtime Dependencies

• Windows: WebView2 runtime (included in Windows 10+; older versions need a one-time install)
• macOS: No extra dependencies (uses the system WebKit)
• Linux: libgtk-3-0 and libwebkit2gtk-4.1-0 (preinstalled on most desktop distros)
• Android: Android 5.0+ (uses the system WebView, no extra dependencies)
• Docker: only Docker Engine on the host (Docker Compose v2 for compose deployments); the image ships with all runtime dependencies

Quick Workflows

SSH Connection

1. Click New Connection in the Connection Manager
2. Fill in host, port, and authentication (password or private key)
3. Click Connect to open an SSH terminal session

AI Agent

1. Go to Settings and configure your AI provider (API endpoint, model, and key)
2. Open a terminal tab (SSH or local)
3. Open the AI sidebar chat — type your task, and the AI Agent executes commands directly in your terminal

SFTP File Transfer

1. In the Connection Manager, right-click an SSH connection
2. Select Connect SFTP
3. Browse, upload, download, and drag-and-drop files in the dual-pane file manager

Tech Stack

Layer	Technology
Desktop Framework	Wails v3
Backend	Go
Frontend	Vue 3 + Pinia + Element Plus
Terminal	xterm.js
AI Protocol	Anthropic Messages API / OpenAI Chat Completions API

Build from Source

• Go 1.26+
• Node.js 20+
• wails3 CLI v3.1.0 (install with go install github.com/wailsapp/wails/v3/cmd/wails3@v3.1.0)
• macOS needs Xcode Command Line Tools
• Linux needs libgtk-3-dev and libwebkit2gtk-4.1-dev
• Android builds additionally need JDK 21 and the Android SDK/NDK (sdkmanager "platform-tools" "platforms;android-35" "build-tools;35.0.0" "ndk;26.3.11579264")

git clone https://github.com/ys-ll/uniterm.git
cd uniTerm
cd frontend && npm install && cd ..
wails3 dev                  # Development
wails3 build                # Production build

Project Structure

uniTerm/
├── main.go                       # Entry point
├── app.go                        # Wails bindings, LLM API proxy, SFTP API
├── app_*.go                      # Platform-specific implementations
├── backend/
│   ├── session/                  # SSH/Telnet/Serial/SFTP/database session management
│   ├── database/                 # SQL execution, schema introspection, DSN builders
│   ├── container/                # Docker/Podman/nerdctl container management
│   ├── k8s/                      # Kubernetes cluster management
│   ├── store/                    # Persistent config (connections, AI, settings)
│   ├── sync/                     # Cloud sync (Git / WebDAV)
│   ├── update/                   # Auto-update
│   ├── platform/                 # Platform abstraction layer
│   └── log/                      # File-based logging
├── frontend/
│   └── src/
│       ├── components/           # Vue components
│       ├── composables/          # Terminal composables
│       ├── stores/               # Pinia stores
│       ├── services/             # AI agent loop, LLM client
│       ├── i18n/                 # Translations
│       ├── types/                # TypeScript type definitions
│       ├── utils/                # Utility functions
│       └── vendor/               # Third-party libraries
├── plugins/                      # Plugin directory
├── docs/                         # Documentation
├── Taskfile.yml                  # wails3 build tasks
└── build/
    └── config.yml                # build config (app info, dev mode)

Roadmap

See ROADMAP.md for the current protocol / feature status and what's planned next. For per-release history, see CHANGELOG.md.

Star this Project

If uniTerm is helpful to you, please consider giving it a ⭐ Star — it's the best encouragement for the project and helps more people discover it.

<a href="https://www.star-history.com/?repos=ys-ll%2Funiterm&type=date&legend=top-left"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=ys-ll/uniterm&type=date&theme=dark&legend=top-left&sealed_token=EJf9Yr6aVGkBwIbfGQ6u9hRwpxdIl7vVpUJshd8jaRUCw-OkotyrQX9qzDP5cXNidgLvC0yq8ltQivK06MxiTJYOxkVbPCPuIuCBZj7aTkMxUA-mqJk2KA" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=ys-ll/uniterm&type=date&legend=top-left&sealed_token=EJf9Yr6aVGkBwIbfGQ6u9hRwpxdIl7vVpUJshd8jaRUCw-OkotyrQX9qzDP5cXNidgLvC0yq8ltQivK06MxiTJYOxkVbPCPuIuCBZj7aTkMxUA-mqJk2KA" /> <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=ys-ll/uniterm&type=date&legend=top-left&sealed_token=EJf9Yr6aVGkBwIbfGQ6u9hRwpxdIl7vVpUJshd8jaRUCw-OkotyrQX9qzDP5cXNidgLvC0yq8ltQivK06MxiTJYOxkVbPCPuIuCBZj7aTkMxUA-mqJk2KA" /> </picture> </a>

Feedback & Contributing

This is a personal hobby project maintained in the author's spare time, with no commercialization or sponsorship plans — anyone who shares the same interest is warmly welcome to join, discuss, and build together.

Issues, suggestions, and feedback are welcome at GitHub Issues, and code contributions via Pull Request are always welcome. Due to the wide variety of terminal environments and usage scenarios, the author cannot cover every possible case in testing — if you run into any issues, feel free to fork the project and contribute directly. This project welcomes vibe coding.

Thanks to the following people for contributing code and improvements, and to everyone who reported issues and shared suggestions — you help make uniTerm better ❤️

<table> <tr> <td align="center"><a href="https://github.com/yuwei5380">@yuwei5380</a></td> <td align="center"><a href="https://github.com/surenwuyuwuqiu">@surenwuyuwuqiu</a></td> <td align="center"><a href="https://github.com/wangxufeng">@wangxufeng</a></td> <td align="center"><a href="https://github.com/coderstory">@coderstory</a></td> </tr> <tr> <td align="center"><a href="https://github.com/jiayunora">@jiayunora</a></td> <td align="center"><a href="https://github.com/iCarrear">@iCarrear</a></td> <td align="center"><a href="https://github.com/boltomli">@boltomli</a></td> <td align="center"><a href="https://github.com/kxn">@kxn</a></td> </tr> <tr> <td align="center"><a href="https://github.com/windtear">@windtear</a></td> <td align="center"><a href="https://github.com/Sunshow">@Sunshow</a></td> <td align="center"><a href="https://github.com/feuvan">@feuvan</a></td> <td align="center"><a href="https://github.com/zhangsir1211">@zhangsir1211</a></td> </tr> <tr> <td align="center"><a href="https://github.com/sonnartliao">@sonnartliao</a></td> <td align="center"><a href="https://github.com/Teejer">@Teejer</a></td> <td align="center"><a href="https://github.com/IBRAHIMELAMRABET">@IBRAHIMELAMRABET</a></td> <td align="center"><a href="https://github.com/chris-edstrom">@chris-edstrom</a></td> </tr> <tr> <td align="center"><a href="https://github.com/andreafunicelli">@andreafunicelli</a></td> <td align="center"><a href="https://github.com/dungvv">@dungvv</a></td> <td align="center"><a href="https://github.com/zhongqian97">@zhongqian97</a></td> <td align="center"><a href="https://github.com/laigcss">@laigcss</a></td> </tr> <tr> <td align="center"><a href="https://github.com/lutzr400">@lutzr400</a></td> <td align="center"><a href="https://github.com/Merrcurys">@Merrcurys</a></td> <td align="center"><a href="https://github.com/etanman">@etanman</a></td> <td align="center"><a href="https://github.com/wuqiang57">@wuqiang57</a></td> </tr> <tr> <td align="center"><a href="https://github.com/lijinxiao1982">@lijinxiao1982</a></td> <td align="center"><a href="https://github.com/mikemikimike">@mikemikimike</a></td> <td align="center"><a href="https://github.com/macoladik">@macoladik</a></td> <td align="center"><a href="https://github.com/NatureLProokie">@NatureLProokie</a></td> </tr> <tr> <td align="center"><a href="https://github.com/kevin9327">@kevin9327</a></td> <td align="center"><a href="https://github.com/gezerui888">@gezerui888</a></td> <td align="center"><a href="https://github.com/eltociear">@eltociear</a></td> <td align="center"><a href="https://github.com/dajiaohuang">@dajiaohuang</a></td> </tr> <tr> <td align="center"><a href="https://github.com/rsipka">@rsipka</a></td> </tr> </table>

License

Apache 2.0