Vibeshell
The first SSH client built for AI agents. Let Claude Code, Codex, and other CLI agents manage your servers through MCP skills. Beautiful UI, native performance.
Ask AI about Vibeshell
Powered by Claude ยท Grounded in docs
I know everything about Vibeshell. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
VibeShell
The first SSH client built for AI agents. Let Claude Code, Codex, and other CLI agents manage your servers.
Built with Tauri 2 ยท React 18 ยท Xterm.js ยท russh
Why VibeShell ยท Features ยท AI Integration ยท Installation ยท Development
Why VibeShell
Most SSH clients were built in an era before AI. They have clunky interfaces, zero automation, and treat every session as a purely human activity.
VibeShell is different. It's a modern terminal with first-class support for AI coding agents โ Claude Code, OpenAI Codex, Cursor, Windsurf, and any MCP-compatible tool. Through a built-in MCP server and auto-installable skill system, your AI agents can SSH into servers, execute commands, transfer files, and manage infrastructure โ all while you watch in a beautiful UI or let it run autonomously.
Think of it as the terminal client that both you and your AI actually enjoy using.
Features
๐ค AI Agent Integration
The killer feature. VibeShell ships with a built-in MCP (Model Context Protocol) server and a skill installer that teaches AI agents how to use it.
| What your AI can do | MCP Tool |
|---|---|
| List & manage servers | server_list, server_add, server_get |
| Open SSH sessions | session_create, session_attach |
| Execute remote commands | exec |
| Browse & transfer files | sftp_ls, sftp_upload, sftp_download |
| Create directories, move/delete files | sftp_mkdir, sftp_mv, sftp_rm |
One-click install โ VibeShell auto-detects Claude Code, Codex CLI, Cursor, Windsurf, and other MCP-compatible tools on your machine, then installs its skill (SKILL.md + MCP config) so your agent knows exactly how and when to use SSH.
You: "Deploy the latest build to production"
Agent: [Uses VibeShell] โ connects to prod server โ pulls code โ restarts service โ confirms deployment
๐ฅ๏ธ Terminal
- Multi-tab sessions โ Connect to multiple servers simultaneously
- WebGL rendering โ Buttery-smooth terminal via Xterm.js
- Local shell โ Built-in local terminal alongside SSH sessions
- Ghost text completions โ Fish-shell-style inline suggestions
- Keyboard shortcuts โ
Ctrl+Nnew server,Ctrl+Kquick command,Ctrl+Wclose tab
๐ SSH & Security
- SSH tunneling โ Local forward, remote forward, and SOCKS5 dynamic forwarding
- Jump host (ProxyJump) โ Connect through bastion/jump servers
- SSH agent forwarding โ Forward local SSH agent to remote hosts
- Host key verification โ TOFU with SHA-256 fingerprint management
- Encrypted credential storage โ AES-encrypted passwords and key passphrases
๐ File Management
- SFTP browser โ Built-in file manager with upload, download, preview, edit
- Drag & drop โ Upload files by dragging into the SFTP panel
- Compression โ Compress/extract archives on remote servers
- File preview โ View text files, images, and code with syntax highlighting
โก Productivity
- Command snippets โ Save, tag, and reuse frequently used commands
- Session recording โ Record terminal sessions for playback and audit
- Post-login commands โ Auto-execute commands after SSH connection
- Quick command palette โ
Ctrl+Kto search and run anything - Server groups & tags โ Organize hundreds of servers effortlessly
๐จ Design
- Tokyo Night theme โ A beautiful dark theme, not a generic UI
- Internationalization โ English and ็ฎไฝไธญๆ
- Native performance โ Rust backend, ~8 MB binary, instant startup
- Cross-platform โ Windows, macOS, Linux with native look and feel
Installation
Download
| Platform | Download |
|---|---|
| Windows x64 | .exe installer ยท .msi |
| macOS Apple Silicon | .dmg |
| macOS Intel | .dmg |
| Linux x64 | .deb ยท .AppImage ยท .rpm |
Build from Source
# Prerequisites: Node.js 18+, Rust 1.70+, Tauri prerequisites
git clone https://github.com/veithly/vibeshell.git
cd vibeshell
npm install
npx tauri dev # Development mode with hot reload
npx tauri build # Build release binary
Architecture
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Frontend โ
โ React 18 + Zustand + Xterm.js + Tailwind CSS โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Tauri IPC Bridge โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Backend โ
โ Rust + russh + rusqlite + tokio โ
โ โโโโโโโโ โโโโโโโโ โโโโโโโโโโ โโโโโโโโโโโ โโโโโโโ โ
โ โ SSH โ โ SFTP โ โ Tunnel โ โ Storage โ โ MCP โ โ
โ โโโโโโโโ โโโโโโโโ โโโโโโโโโโ โโโโโโโโโโโ โโโโโโโ โ
โ โฒ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ Skill Installer & Detector โโ โ
โ โ Claude Code ยท Codex ยท Cursor ยท ... โโ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
- Frontend โ React handles UI, Zustand manages state, Xterm.js renders terminals
- Backend โ Rust provides native SSH/SFTP via
russh, SQLite for persistence - MCP Server โ Exposes 16 tools for AI agents to manage servers, sessions, and files
- Skill Installer โ Auto-detects AI tools and configures the VibeShell MCP skill
Development
npx tauri dev # Dev server with hot reload
npx tsc --noEmit # Type-check frontend
cargo check --manifest-path src-tauri/Cargo.toml # Check Rust backend
cargo test --manifest-path src-tauri/Cargo.toml # Run Rust tests
Project Structure
vibeshell/
โโโ src/ # React frontend
โ โโโ components/ # UI components (Terminal, SFTP, Settings, ...)
โ โโโ stores/ # Zustand state stores
โ โโโ i18n/ # Internationalization (en, zh)
โ โโโ lib/ # Utilities (tauri.ts, utils.ts)
โโโ src-tauri/ # Rust backend
โ โโโ src/
โ โโโ commands/ # Tauri command handlers (60+ commands)
โ โโโ ssh/ # SSH client & fingerprints (russh)
โ โโโ sftp/ # SFTP operations
โ โโโ tunnel/ # SSH tunneling engine
โ โโโ mcp/ # MCP server & 16 tool definitions
โ โโโ install/ # AI tool detector & skill installer
โ โโโ storage/ # SQLite database & encrypted credentials
โ โโโ logging/ # Session recording
โโโ cli/ # CLI companion tool
โโโ .github/workflows/ # CI + auto-release pipeline
Contributing
Contributions are welcome!
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
