Creator / Owner: jiayizhen
Companies: MrToken & Nebulaedata
An AI‑agent‑powered SSH client / 由 AI 智能体驱动的运维终端
A modern SSH client with a built‑in AI ops agent that can run, diagnose, and operate your servers — with your confirmation.
Powered by MrToken & Nebulaedata · Created by jiayizhen
NebuShell is a cross‑platform desktop SSH client with a first‑class AI ops agent baked in. Connect to your servers, open multiple terminals, browse and edit remote files over SFTP, and let the built‑in agent run commands, read their output, and carry out operations for you — always behind an explicit plan‑and‑confirm workflow, so nothing runs on your machines without your say‑so.
Everything is stored locally and secured by a master‑password vault. No cloud account required.
- 🖥️ Multi‑tab terminals & flexible split view — xterm.js terminals with a fit addon, web links, and per‑theme styling. Split any pane right or down from the tab‑strip buttons, keep splitting the split‑out panes recursively into any grid, drag tabs between panes (drop on an edge to make a new split, on the center to merge), drag a tab out of the window to tear it off into its own window (the live session moves with it), and drag the dividers to resize.
- 🤖 Built‑in AI ops agent — an OpenAI‑compatible agent that can
run_command,read_command_output,ask_user, andpresent_plan. It proposes a plan, asks for confirmation, then executes across one or many terminals. Send it images too — paste a screenshot, pick a file, or drag one into the composer. - 🔐 Encrypted vault — hosts, passwords, and SSH keys are protected behind a master password; the keychain never leaves your machine. Trust this device to skip the password on future launches.
- 📁 SFTP file browser — dual‑pane remote/local file management with drag‑and‑drop transfers and a live transfer queue. Create files and folders from the toolbar or by right‑clicking blank space in the listing.
- 📝 Built‑in editor — a Monaco (VS Code) editor for quickly editing remote and local files, with syntax highlighting. Ctrl+S saves a remote file straight back to the server (and snapshots a history version).
- 🖼️ Image preview — open remote images directly in a tab.
- 🗂️ Host management — organize connections, duplicate sessions, reconnect, and jump between them from the tab bar.
- ⌨️ Command history & command palette — every command you type is saved locally per server (tagged User / Agent) and shared across that host's tabs; a history panel splits Local vs the server's own
~/.bash_history. Triple‑tap Ctrl to open a tabbed palette that searches history and runs quick actions — picking a command drops it into the prompt without executing. - 📜 History docs — keep track of past sessions and documents.
- 📊 System monitor — per‑core CPU with a live sparkline, a memory donut, network up/down rates, per‑mount disk usage with read/write I/O, and a process manager you can search and kill from.
- 🎨 Light / dark themes — a clean, modern UI that adapts to your OS.
Recent updates (July 2026)
- 🪟 Tear tabs off into their own windows (2026‑07‑15) — drag any content tab (a terminal, SFTP, editor or image tab — including one living inside a split pane) out of the window to pop it into a new window at the cursor; drop it onto another window to merge it there instead (both directions). The session moves without dropping — the SSH connection and any running command keep going untouched, and the terminal keeps its full scrollback, replayed into the new window. Close the original window and the torn‑off session is unaffected.
- 🖼️ Send images to the agent — the agent composer now takes images three ways: paste a screenshot straight into the input (
Ctrl+V), pick files from the new image button, or drag and drop them onto the box. Thumbnails sit above the input (click to zoom, × to remove), up to 6 per message. Screenshots are downscaled to 1568px before sending, so a 4K grab doesn't balloon the request or eat your context window — and the context meter counts the images too. Works with any vision-capable OpenAI-compatible model. - 🔓 Trust this device — the master-password screen gains a 信任此设备 checkbox. Tick it and the next launch unlocks the vault automatically, straight to the main window. The password is sealed with the OS credential store (DPAPI on Windows, Keychain on macOS) — never written in plaintext — and the trust record is dropped automatically if it stops working. Turn it back off any time from Settings; systems without a credential store disable the option rather than fall back to storing the password in the clear.
- 🗃️ Create files & folders in SFTP — the file listing gains a New file button next to New folder, and right‑clicking blank space (including an empty directory) offers 新建文件 / 新建文件夹. Right‑clicking a file still shows its own menu (open / download / rename / delete), so the two never collide. Both panes (remote and local) check for a name clash first, so creating a file can never blank out an existing one.
- 💾 Ctrl+S saves to the server — with a remote file open in the editor, Ctrl/Cmd+S now saves it straight back over SFTP and snapshots a history version, exactly like the 保存到服务器 button. Saving is blocked while the file is still loading, so a placeholder can never overwrite your file.
- 🧾 Breathing room under the prompt — the terminal now reserves two blank rows at the bottom, so the prompt no longer sits flush against the window edge. It is reserved in rows, not pixels, so the gap stays correct at any font size and is reapplied on resize, split, and font changes.
- 📋 Ctrl+Shift+V no longer pastes twice — the terminal's paste shortcut now calls
preventDefault(), stopping the browser's native "paste as plain text" from firing on top of our own paste handler. (Ctrl+Shift+C got the same treatment.) - 🪟 Draggable, recursive split view — split panes now keep splitting. Each pane's tab strip (and the top bar) gains 向右分屏 / 向下分屏 buttons that split a pane right or down — including the panes you already split, so you can build any grid. Drag a tab by mouse from one pane into another: drop on an edge to carve out a new split, or on the center to merge it into that pane. Splitting a single‑tab terminal pane duplicates the session into the new pane, and the dividers have a wider grab zone for easier resizing. (Dragging is pointer‑based rather than HTML5 drag‑and‑drop, so it works reliably inside the app window.)
- 📜 Persistent command history — commands you type are now saved locally per server (surviving restarts) and shared across every tab of that host, each tagged User or Agent — agent‑run commands are captured too, not just what you type. The history panel gains a Local / Server split, where the Server tab reads the box's own
~/.bash_history/~/.zsh_history. Click any command to drop it into the input line without running it, delete single entries, or clear a server's history. - ⌨️ Triple‑Ctrl command palette — tap Ctrl three times in a terminal to pop a tabbed palette: 历史记录 (History) searches your merged local + server history, 快捷操作 (Quick actions) fires common actions. Tab / Shift+Tab switch tabs, ↑/↓ + Enter pick, and the chosen command is inserted into the prompt (never auto‑run).
- 🛡️ Agent terminal anti-jam — the agent no longer hangs on blocking commands (
tail -f,top, interactive[Y/n]prompts). It actively probes whether the shell is at a prompt, and when a command jams the terminal it runs a recovery ladder (Ctrl‑C → Ctrl‑C → pagerq→ editor:q!→ Ctrl‑Z suspend +kill %1), reporting a clear interrupted / stuck state instead of silently timing out. Completion is judged by an idle+ceiling heartbeat, so long jobs (apt,docker build) run to the end while truly stuck ones are recovered — and the agent is guided to bound streaming commands (tail -n,top -bn1,timeout N …). - 📊 Rich system monitor — the monitor panel now covers system info (IP / OS / timezone / uptime), per‑core CPU with a live sparkline, a memory donut (used / cache / free), network up/down rates & cumulative traffic, disk usage per mount with read/write I/O, and a process manager (hotspot list plus a full searchable table with kill / force‑kill). All charts and colors adapt to the active theme.
- ⚡ Faster SFTP transfers — local↔remote uploads/downloads now use concurrent
fastPut/fastGet, saturating high-latency links instead of sending one 32 KB chunk per round-trip. Large files move dramatically faster. - 📈 Transfer speed & ETA — the transfer UI shows live throughput (MB/s) and estimated time remaining, not just a percentage.
- 🗂️ Per-window transfer records — transfers are grouped by the window that started them into a collapsible dock; finished transfers stay as browsable history until you clear them.
⚠️ Close-tab protection — closing a tab with an in-progress transfer now asks for confirmation, since closing tears down the SFTP connection.- 📊 Progress in the side-panel SFTP view — the embedded SFTP panel shows transfer progress too, and the toolbar upload button supports multi-select with a progress bar.
- ⚙️ Configurable transfer concurrency — a new Settings page lets you tune the SFTP concurrency (default 64, range 1–256); the value is persisted.
- 🎨 Terminal color fix — the built-in themes now ship full 16-color ANSI palettes, fixing colored (especially white) text that was invisible on the light theme.
A ready-made landing page lives at docs/index.html — open it in a browser or publish it via GitHub Pages.
| Vault setup | Add a host | Host management |
|---|---|---|
 |
 |
 |
| SSH terminal | Agent workspace | Agent mode control |
|---|---|---|
 |
 |
 |
| Plan and confirm | System checks | Execution plan |
|---|---|---|
 |
 |
|
| Model provider | SFTP browser | Multi-pane SFTP |
|---|---|---|
 |
 |
 |
| Remote editor |
|---|
 |
| Layer | Tech |
|---|---|
| Shell | Electron + electron-vite |
| UI | React + TypeScript + Tailwind CSS |
| Terminal | @xterm/xterm |
| Editor | Monaco Editor |
| SSH / SFTP | ssh2 |
| State | Zustand |
Prerequisites: Node.js 18+ and npm.
# Clone the repo
git clone https://github.com/SoySauceJYZ/NebuShell.git
cd NebuShell
# Install dependencies
npm install
# Start in development mode
npm run devPrefer a prebuilt binary? Grab the latest from the Releases page.
# Windows → dist/NebuShell-<version>-setup.exe
npm run build:win
# macOS → dist/NebuShell-<version>.dmg (must be built on macOS)
npm run build:mac
# Linux → dist/NebuShell-<version>.AppImage (+ snap / deb)
npm run build:linux
# Unpacked directory (quick smoke test, no installer)
npm run build:unpackThe agent talks to any OpenAI‑compatible endpoint. Open the agent settings in‑app and provide:
- Base URL — e.g.
https://api.openai.com/v1or your own gateway - API Key
- Model — e.g.
gpt-4o,claude-...via a compatible proxy, or a local model
The agent will refuse to run until all three are set.
src/
├── main/ # Electron main process
│ ├── ssh/ # SSH connection manager
│ ├── sftp/ # SFTP manager
│ ├── vault/ # Encrypted credential vault
│ ├── llm/ # LLM client (OpenAI-compatible)
│ └── ipc/ # IPC handlers
├── preload/ # Preload bridge
└── renderer/ # React UI (terminals, SFTP, editor, agent panel)
- Creator / Owner: jiayizhen
- Companies: MrToken & Nebulaedata
- Built with: Claude & Codex
- AI compute: provided by MrToken & Nebulaedata
Released under the MIT License. © 2026 jiayizhen / MrToken & Nebulaedata.
NebuShell 是一款跨平台桌面 SSH 客户端,内置了一流的 AI 运维智能体。你可以连接服务器、打开多个终端、通过 SFTP 浏览与编辑远程文件,并让内置智能体替你执行命令、读取输出、完成运维操作——所有操作都遵循「先出计划、确认后执行」的流程,没有你的同意,不会在你的机器上跑任何命令。
所有数据都保存在本地,并由主密码保险库加密,无需注册云账号。
- 🖥️ 多标签终端与灵活分屏 —— 基于 xterm.js,支持自适应、网页链接识别和主题化。可在标签条上点击向右/向下分屏,并对分出来的屏递归继续分屏组成任意网格;支持拖动标签页在各屏之间移动(拖到边缘新建分屏,拖到中间合并到该屏),还能把标签页拖出窗口撕成独立窗口(会话原样跟着搬走),分隔条可拖动调整大小。
- 🤖 内置 AI 运维智能体 —— 兼容 OpenAI 接口,支持
run_command(执行命令)、read_command_output(读取输出)、ask_user(向你提问)、present_plan(给出计划)。先出方案、征得确认,再在一个或多个终端上执行。还可以给它发图片——截图直接粘贴、选择文件,或拖进输入框。 - 🔐 加密保险库 —— 主机、密码和 SSH 密钥都由主密码保护,密钥库永不离开本机。可勾选「信任此设备」,下次打开免输主密码。
- 📁 SFTP 文件浏览器 —— 远程/本地双栏文件管理,支持拖拽传输和实时传输队列。可从工具栏或右键空白处新建文件 / 文件夹。
- 📝 内置编辑器 —— 集成 Monaco(VS Code 同款)编辑器,快速编辑远程与本地文件,支持语法高亮。打开服务器文件后按 Ctrl+S 即可直接保存回服务器(并自动存一个历史版本)。
- 🖼️ 图片预览 —— 直接在标签页中打开远程图片。
- 🗂️ 主机管理 —— 整理连接、复制会话、一键重连,并可在标签栏之间快速切换。
- ⌨️ 命令历史与命令面板 —— 你输入的每条命令都会按服务器本地持久化(标记 User / Agent),并在该主机的所有标签页间共享;历史面板分「本地 / 服务器」两个子标签,服务器标签直接读取机器自身的
~/.bash_history。在终端里连按三次 Ctrl 可呼出分标签命令面板,搜索历史或执行快捷操作——选中的命令只填入输入行、不自动执行。 - 📜 历史文档 —— 记录过往会话与文档。
- 📊 系统监控 —— 每核心 CPU 占用与实时折线、内存环形图、网络上下行速率、按挂载点的磁盘用量及读写 IO,以及可搜索、可结束进程的进程管理器。
- 🎨 明暗主题 —— 简洁现代的界面,随系统自动切换。
近期更新(2026 年 7 月)
- 🪟 把标签页撕成独立窗口 (2026‑07‑15) —— 把任意内容标签(终端 / SFTP / 编辑器 / 图片,包括分屏面板里的某个标签)拖出窗口,即可在光标处弹出一个新窗口装它;若拖到另一个已有窗口上,则合并进那个窗口(双向都行)。会话原样搬移、不断开——SSH 连接和正在运行的命令都毫发无伤,终端保留完整历史滚屏(在新窗口里回放重建)。关掉原窗口也不会影响已经撕出去的会话。
- 🖼️ 给智能体发图片 —— 智能体输入框现在支持三种加图方式:截图直接粘贴(
Ctrl+V)、点新增的「图片」按钮选择文件、或把图片拖进输入框。缩略图排在输入框上方(点击放大,× 移除),单条消息最多 6 张。图片发送前会按最长边缩到 1568px,4K 截图不会把请求体撑爆、也不会吃光上下文——上下文用量表也会把图片算进去。任何支持视觉的 OpenAI 兼容模型都能用。 - 🔓 信任此设备 —— 主密码界面新增「信任此设备」勾选框。勾上之后,下次打开应用会自动解锁保险库,直接进主界面。主密码用操作系统凭据存储加密保存(Windows DPAPI / macOS 钥匙串),绝不明文落盘;万一记录失效(比如保险库被重建),会自动清掉并退回手输密码,不会卡死。随时可在「设置」里关掉。系统若不支持安全存储,该选项会被禁用,而不是退化成明文保存密码。
- 🗃️ SFTP 新建文件与文件夹 —— 文件列表在「新建文件夹」旁边新增了「新建文件」按钮,右键空白处(包括空目录)也会弹出「新建文件 / 新建文件夹」菜单。右键文件行仍然是原来的菜单(打开 / 下载 / 重命名 / 删除),两者互不冲突。远程和本地两个面板都会先查重名,所以新建文件绝不会把同名文件清空。
- 💾 Ctrl+S 保存到服务器 —— 在编辑器里打开服务器文件后,按 Ctrl/Cmd+S 就会通过 SFTP 直接保存回服务器,并存一个历史版本,效果与点「保存到服务器」按钮完全一致。文件还在加载时会阻止保存,避免把占位文本覆盖到你的文件上。
- 🧾 提示符不再贴底 —— 终端底部现在会保留两行空白,命令提示符不再紧贴窗口边缘。留白是按「行」而不是像素预留的,所以任何字号下间距都正确,并且在窗口缩放、分屏、改字号时都会重新生效。
- 📋 修复 Ctrl+Shift+V 重复粘贴 —— 终端的粘贴快捷键现在会调用
preventDefault(),阻止浏览器原生的「粘贴为纯文本」在我们自己的粘贴之外再粘一次。Ctrl+Shift+C 也做了同样处理。 - 🪟 可拖动的递归分屏 —— 分屏后还能继续分屏。每个面板的标签条(以及顶栏)新增了「向右分屏 / 向下分屏」按钮,可对已经分出来的面板继续分屏,组成任意网格。用鼠标把标签页从一个面板拖到另一个:拖到边缘新建分屏,拖到中间合并进该面板。对单标签的终端面板分屏时会复制会话到新面板,分隔条也有更宽的拖拽热区便于调整大小。(拖拽改用指针实现而非 HTML5 拖放,在应用窗口内更稳定可靠。)
- 📜 命令历史持久化 —— 你输入的命令现在会按服务器本地保存(重启后仍在),并在该主机的所有标签页间共享,每条标注来源 User 或 Agent(智能体执行的命令也会被记录,而不只是手输的)。历史面板新增「本地 / 服务器」子标签——服务器标签直接读取机器自身的
~/.bash_history/~/.zsh_history。点击任意命令即可填入输入行而不执行,并支持删除单条或清空某台服务器的历史。 - ⌨️ 三击 Ctrl 命令面板 —— 在终端里连按三次 Ctrl 弹出分标签面板:「历史记录」搜索本地 + 服务器合并的历史,「快捷操作」执行常用动作。Tab / Shift+Tab 切换标签,↑/↓ + 回车 选择,选中的命令会填入输入行(不自动执行)。
- 🛡️ 智能体终端防卡死 —— 智能体不再被
tail -f、top、交互式[Y/n]等阻塞命令卡住。它会主动探测 shell 是否停在提示符;当某条命令把终端卡死时,走恢复阶梯(Ctrl‑C → 再 Ctrl‑C → 分页器q→ 编辑器:q!→ Ctrl‑Z 挂起并kill %1)夺回提示符,并明确回报「已中断 / 终端卡死」状态,而不是默默超时。完成判定改用「空闲 + 硬上限」心跳,apt、docker build等长任务能跑到底,真正卡死的才被恢复;同时引导模型对持续输出型命令做有界化(tail -n、top -bn1、timeout N …)。 - 📊 系统监控大升级 —— 监控面板现覆盖:系统信息(IP / 系统 / 时区 / 运行时间)、每核心 CPU 占用与实时折线、内存环形图(已用 / 缓存 / 空闲)、网络上下行速率与累计流量、按挂载点的磁盘用量及读写 IO,以及进程管理(热点列表 + 可搜索全表,支持结束 / 强制结束进程)。所有图表与配色随当前主题自适应。
- ⚡ SFTP 传输提速 —— 本地↔远端的上传/下载改用并发
fastPut/fastGet,填满高延迟链路,不再"一次一个 32KB 分块等往返"。大文件传输速度大幅提升。 - 📈 传输速度与剩余时间 —— 传输界面新增实时速度(MB/s)与预计剩余时间,不再只有百分比。
- 🗂️ 按窗口保存的传输记录 —— 传输按所属窗口归集到可折叠的记录面板;完成后作为历史保留,可随时查看,直到手动清除。
⚠️ 关闭页面保护 —— 关闭仍有传输进行中的标签页时会弹出确认(关闭会中断 SFTP 连接)。- 📊 侧边栏 SFTP 也显示进度 —— 终端右侧内嵌 SFTP 面板同样显示传输进度,工具栏上传支持多选并带进度条。
- ⚙️ 传输并发数可调 —— 新增「设置」页,可调节 SFTP 并发数(默认 64,范围 1–256),并持久化保存。
- 🎨 终端配色修复 —— 内置主题补全了 16 色 ANSI 调色板,修复浅色主题下彩色(尤其是白色)文字看不见的问题。
项目自带一个介绍页 docs/index.html —— 用浏览器打开,或通过 GitHub Pages 发布即可。
| 主机与终端 | AI 智能体 | SFTP 与编辑器 |
|---|---|---|
|
|
|
| 层级 | 技术 |
|---|---|
| 外壳 | Electron + electron-vite |
| 界面 | React + TypeScript + Tailwind CSS |
| 终端 | @xterm/xterm |
| 编辑器 | Monaco Editor |
| SSH/SFTP | ssh2 |
| 状态管理 | Zustand |
环境要求: Node.js 18+ 及 npm。
# 克隆仓库
git clone https://github.com/SoySauceJYZ/NebuShell.git
cd NebuShell
# 安装依赖
npm install
# 开发模式启动
npm run dev想直接用安装包?到 Releases 页面 下载最新版本。
# Windows → dist/NebuShell-<版本号>-setup.exe
npm run build:win
# macOS → dist/NebuShell-<版本号>.dmg (需在 macOS 上打包)
npm run build:mac
# Linux → dist/NebuShell-<版本号>.AppImage(以及 snap / deb)
npm run build:linux
# 仅解压目录(快速验证,不生成安装包)
npm run build:unpack智能体支持任意 兼容 OpenAI 的接口。在应用内打开智能体设置,填写:
- Base URL —— 例如
https://api.openai.com/v1或你自建的网关 - API Key
- 模型 —— 例如
gpt-4o、通过兼容代理的claude-...,或本地模型
三项未配置齐全前,智能体不会执行任何操作。
src/
├── main/ # Electron 主进程
│ ├── ssh/ # SSH 连接管理
│ ├── sftp/ # SFTP 管理
│ ├── vault/ # 加密凭据保险库
│ ├── llm/ # LLM 客户端(兼容 OpenAI)
│ └── ipc/ # IPC 处理
├── preload/ # 预加载桥接
└── renderer/ # React 界面(终端、SFTP、编辑器、智能体面板)
- 开发者 / 所有者: jiayizhen
- 公司: MrToken、Nebulaedata
- 构建开发: 由 Claude 与 Codex 构建开发
- AI 算力: 由 MrToken、Nebulaedata 提供
基于 MIT 协议 发布。© 2026 jiayizhen / MrToken、Nebulaedata。
开发者 / 所有者 jiayizhen · 公司 MrToken、Nebulaedata · 由 Claude 与 Codex 构建开发 · AI 算力由 MrToken、Nebulaedata 提供
Made with ❤️ · Powered by MrToken & Nebulaedata
Made with ❤️ · Powered by MrToken & Nebulaedata