Vibe-SSH:基于 Rust 和 Tauri 的 AI Agent SSH 协作客户端项目

Vibe-SSH 是支持外部 Agent Skill 的 macOS SSH/SFTP 客户端,可查看真实命令输出并随时接管。个人版源码公开,采用 PolyForm Strict 1.0.0:允许条款内非商业使用,不授予修改或再分发权。企业版 Pro 独立闭源开发。已发布 Beta 1 及更早 MIT 版本保留原授权。

Branch6Tags6

Vibe-SSH — SSH for you and your AI. Watch agent operations and take over.

Vibe-SSH

The SSH workspace for you and your AI.

PolyForm Strict License Download releases View live CI status macOS desktop

A source-available 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 Personal Beta for macOS

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.

Personal 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.

Vibe-SSH workspace with server navigation, sessions and agent activity

The actual application interface running with development sample data. Server names, addresses and task output in the screenshot are examples.

Editions

Edition Availability Scope
Personal Beta Source available under PolyForm Strict for permitted noncommercial use; no modification or redistribution grant. Existing Beta 1 downloads remain MIT. SSH, SFTP, port forwarding, monitoring, Agent Skill and CLI, batch deployments, history, logs, and human takeover.
Enterprise Pro Separate proprietary commercial edition in development; source is not published here. Versioned release templates and Markdown delivery reports for repeatable deployments.

Server credentials stay on your machine in both editions. This repository contains the full Personal edition. See the Enterprise Pro development plan.

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

  1. Download the Beta from Releases. Choose macos-arm64 for Apple silicon or macos-x86_64 for Intel. Each release includes DMG/ZIP packages and SHA256SUMS.txt.
  2. Move Vibe-SSH.app to Applications and open it. Follow the installation guide for checksum verification and macOS's per-app opening procedure.
  3. Add a server yourself: name, address, port, username, and password or private key. Verify the host fingerprint through a trusted channel before saving.
  4. 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.

Vibe-SSH session view with task output and human control actions

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

License

Current project-owned Personal edition source is offered under PolyForm Strict 1.0.0: permitted noncommercial use, with no public grant to modify or redistribute. Commercial use outside its permitted purposes requires separate written authorization. Enterprise Pro remains proprietary and is developed separately.

This is source-available software, not OSI Open Source. Earlier MIT versions, including v0.2.0-beta.1, retain their original grants; current download links still point to those MIT packages. The change applies to source containing this license transition and future differently versioned packages, not to existing releases. Read LICENSING.md for scope, platform permissions and historical notices. Third-party components retain their own licenses and notices.

Introduction

Vibe-SSH 是支持外部 Agent Skill 的 macOS SSH/SFTP 客户端,可查看真实命令输出并随时接管。个人版源码公开,采用 PolyForm Strict 1.0.0:允许条款内非商业使用,不授予修改或再分发权。企业版 Pro 独立闭源开发。已发布 Beta 1 及更早 MIT 版本保留原授权。

https://vibe-ssh.intmainjhy.cn/Customize your domain