Vibe-SSH 是面向开发者与外部 AI Agent 的开源 macOS SSH/SFTP 客户端。让 Codex、Claude Code 等支持 Skill 的命令行 AI 操作你手动添加的服务器,完成网站部署、文件传输和故障排查;你可以实时查看命令与输出,随时接管独立任务空间。应用本身不内置模型。基于 Rust、Tauri、React 与 xterm.js,采用 MIT 开源协议。当前提供 Apple silicon 与 Intel Mac 预览版。关键词:SSH 客户端、AI Agent、Codex Skill、Claude Code、SFTP、DevOps、服务器管理、Vibe Coding。
Access rate limit exceeded. Please log in to continue.

Vibe-SSH
The SSH workspace for you and your AI.
An open-source macOS SSH/SFTP client with Skill and CLI access for external agents.
Add your servers manually. Deploy and troubleshoot through Skills.
Watch commands and output in real time. Take over whenever you need.
Download the macOS Beta
Product website · Features · Installation · Agent guide · Documentation · Roadmap · Contribute
English · 简体中文 | GitHub · AtomGit
Your terminals and agent task spaces stay separate, each with its own SSH connection.
Public Beta: packages target Apple silicon and Intel Macs. Linux is a remote-server target, not a desktop release. Packages are ad-hoc signed and are not yet Developer ID signed or notarized. See project status.

The actual application interface running with development sample data. Server names, addresses and task output in the screenshot are examples.
What you can do
| Capability | How it works |
|---|---|
| Use SSH yourself | Manually configure hosts, verify fingerprints, and open tabbed terminals with search, themes and adjustable text size. |
| Give an agent a server task | Enable access for a host. An external agent loads the Skill and uses the version-matched CLI. |
| See the work happen | Inspect commands, task state and terminal output while the agent works. |
| Take over and return control | Taking over blocks new agent writes in that space. Returning control issues a new lease; old leases stay invalid. |
| Move and edit files | Browse the SFTP filesystem, resume file and folder transfers, and edit bounded UTF-8 text with version checks and backups. |
| Connect through a route | Preview OpenSSH imports, use a local key agent, connect through verified jump hosts or a proxy, and configure personal TCP forwarding. |
| Compare project directories | Preview metadata and selected file contents, then explicitly apply reviewed additions or replacements with version checks and backups. |
| Read retained tasks | Follow deployment steps and transfer results, then read or export bounded raw output archives from history. |
| Inspect Linux resources | View CPU, memory, swap, load, uptime and root-filesystem usage. Samples are collected while monitoring is visible. |
| Deploy a website | Use the Skill's static-site/Nginx or Docker Compose reference flow, with service checks and failure handling. |
Vibe-SSH connects the AI agent you already use to your SSH workflow. The application itself does not run a model or make autonomous deployment decisions.
Install and connect
- Download the Beta from Releases. Choose
macos-arm64for Apple silicon ormacos-x86_64for Intel. Each release includes DMG/ZIP packages andSHA256SUMS.txt. - Move
Vibe-SSH.appto Applications and open it. Follow the installation guide for checksum verification and macOS's per-app opening procedure. - Add a server yourself: name, address, port, username, and password or private key. Verify the host fingerprint through a trusted channel before saving.
- Open a terminal for your own work. To let an agent use the server, enable agent access for that host.
On startup and upgrade, the app synchronizes its Skill links for compatible agents and its CLI link at ~/.local/bin/vibe-ssh. Unrelated existing entries are preserved. Paths and uninstall behavior are in the installation guide.
Let an external agent operate it
Keep Vibe-SSH running, then give your agent a server and a goal. For example:
Use Vibe-SSH to deploy this project's built site to my blog server. Check the existing configuration, preserve the working release, and verify the URL after deployment.
The agent starts by reading the installed guide:
vibe-ssh skill
# If the command is not on PATH:
"$HOME/.local/bin/vibe-ssh" skill
That guide describes the installed version: host discovery, one task space per goal, command execution, incremental output, uploads and handoff. Compatible agents that can read Skills and execute local commands can use the CLI; independent end-to-end evidence still needs to be recorded for each agent.
The Beta static-site Skill uses batch to combine commands and uploads in one invocation. Each step is visible in the desktop app, and the plan stops when a step fails, its result is unknown, or the user takes control. See the deployment benchmark.
Example CLI interaction
The placeholders come from the preceding command's JSON response. Agents manage these IDs and leases during normal use.
vibe-ssh hosts
vibe-ssh space open <host-id> --name "inspect deployment" --actor "Codex"
vibe-ssh run --lease <lease> -- 'uname -a'
Long tasks return a cursor for job wait. A wait expiring does not mean the task failed. Read the full guide before operating a server.
Deployment reference flows:
vibe-ssh skill static-site # built static files served by Nginx
vibe-ssh skill compose # an existing Docker Compose project
Watching and taking over
An agent's task space groups its commands, terminals and control state. Keep working in your own terminal while observing that space.
Taking over makes the kernel reject subsequent agent commands, input, uploads, interruptions and close operations for that space. Already-running commands continue until they finish or you explicitly interrupt them. An agent can also hand over when a password or human decision is needed.
Returning control creates a new lease. The agent must read updated state before continuing. Personal terminal spaces are not exposed through the agent interface. Manual host management and fingerprint trust are not agent socket methods.

Session screenshot uses the application's development sample data.
Project status
The macOS public Beta is 0.2.0-beta.1. It includes personal SSH terminals, isolated agent spaces, resumable SFTP transfers, Linux monitoring and version-matched Skill/CLI integration.
The desktop interface currently uses Simplified Chinese. The CLI guide and these community docs are available in English.
Validation records cover temporary OpenSSH servers and an isolated Debian 13 VM: execution, upload, interruption, takeover, password handoff and the two deployment flows. These scoped records do not establish that every agent has independently deployed an application or that public-server deployment is universally verified.
In an isolated acceptance run, Codex used the installed Skill to deploy a static site, recover from an Nginx configuration error and hand control back to the user. Claude Code discovered the Skill; its configured model gateway was unavailable for the deployment run.
Beta keeps task summaries and output tails and also archives new output up to 64 MiB per stream and 512 MiB per profile. History shows when capture is incomplete. Personal history remains visible only in the app. See ADR 0007.
Native acceptance covers host setup and fingerprints, Chinese terminal input, SFTP transfers, guarded text saves, takeover and quit protection. An encrypted-key passphrase survived a restart in an isolated macOS Keychain.
Native and loopback validation for Beta are listed in the implementation log. Stable distribution still needs clean-system installation, physical Intel coverage, Developer ID signing and Apple notarization.
See the implementation and evidence log, roadmap and release notes.
Architecture
flowchart LR
Agent[Codex / Claude Code / external agent] --> Skill[Version-matched Skill]
Skill --> CLI[vibe-ssh CLI]
CLI --> Socket[Current-user Unix socket]
Socket --> Core[Rust kernel inside the desktop app]
UI[Tauri + React + xterm.js] --> Core
Core --> AgentSpace[Agent space / own SSH connection]
Core --> Personal[Personal terminal / separate SSH connection]
AgentSpace --> Server[Your server]
Personal --> Server
Rust/Tokio and russh handle SSH. Tauri 2, React/TypeScript and xterm.js provide the desktop interface. Connections are reused within each task space. Protocol v2 exposes agent operations, while manual configuration and control stay inside the application.
Read the architecture decisions and agent protocol for the boundaries and failure semantics.
Build from source
Build on macOS with Rust 1.89 or newer, Node.js 24, Xcode Command Line Tools and the Tauri macOS prerequisites.
git clone https://github.com/IntMainJhy/Vibe-SSH.git
cd Vibe-SSH
cd apps/desktop
npm ci
npm test
npm run build
cd ../..
cargo fmt --all -- --check
cargo clippy --workspace --all-targets --locked -- -D warnings
cargo test --workspace --locked
cd apps/desktop
npx tauri build
The desktop crate embeds the built frontend: build the frontend before checking the Rust workspace. Native end-to-end tests use macOS's /usr/sbin/sshd with temporary directories and identities.
For the isolated Linux VM and deployment examples, see Contributing. A browser-only development preview uses sample data and does not connect to servers.
FAQ
Does Vibe-SSH include its own AI model?
It uses external agents through Skills and a CLI. Keep using your existing agent environment.
Can I use it as a regular SSH client?
Yes. Configure hosts and use terminals, files and monitoring yourself; agent access is enabled per host.
Do I need a Vibe-SSH service on my VPS?
The app connects over SSH. Operations still need their usual server-side tools, such as tar, Nginx or Docker.
Is it faster than a traditional SSH tool?
The design reduces repeated setup and makes output and task state directly available to agents. A scoped loopback benchmark exists; it does not establish a general speedup for public networks or full deployments.
Are Windows and Linux desktop clients available?
Current packages are for macOS. Linux is a remote-server target. Other desktop platforms are on the roadmap.
Community and documentation
- Report a bug with your version and reproducible steps.
- Ask a question or share a workflow.
- Contribute, review the code of conduct, or read the support guide.
- Report security issues privately.
- Browse the technical documentation, design system and agent Skill.
License
Vibe-SSH is available under the MIT License. Third-party components retain their own licenses; release packaging maintains separate third-party notices.
Introduction
Vibe-SSH 是面向开发者与外部 AI Agent 的开源 macOS SSH/SFTP 客户端。让 Codex、Claude Code 等支持 Skill 的命令行 AI 操作你手动添加的服务器,完成网站部署、文件传输和故障排查;你可以实时查看命令与输出,随时接管独立任务空间。应用本身不内置模型。基于 Rust、Tauri、React 与 xterm.js,采用 MIT 开源协议。当前提供 Apple silicon 与 Intel Mac 预览版。关键词:SSH 客户端、AI Agent、Codex Skill、Claude Code、SFTP、DevOps、服务器管理、Vibe Coding。
https://vibe-ssh.intmainjhy.cn/Customize your domain