dinotty

为 Coding Agent 打造的多端同步终端服务器。在任意设备上运行 Claude Code、opencode、Codex 或 OpenClaw，桌面端专业高效，移动端随时掌控——无缝切换，会话永不丢失。

截图

桌面端演示

桌面端同样专业好用，媲美 iTerm2 的终端体验：

分屏 — 可拖拽的多面板分屏，自由调整布局：

插件系统 — JS 插件热重载，内置 CC Switch、JSON Formatter 等：

网页预览 — 手机上也能预览本地开发服务器，内建反向代理，不用切浏览器：

为什么选择 Dinotty？

终端 Coding Agent（Claude Code、opencode、Codex、OpenClaw 等）功能强大，但它们被束缚在单一终端窗口里。Dinotty 让你：

• 在任意设备上管理 agent——桌面端深度编码，离开工位时手机扫码即可继续查看和管理 agent 工作，工作连贯不中断
• 多端同步，无缝切换——电脑上写到一半，掏出手机继续；回到电脑，一切原样
• 直接验证 agent 产出——代码 diff、渲染的网页、生成的文件，内置浏览器一目了然
• 永远不会丢失会话——断网、息屏、切换设备——回来后一切都在原处

轻量级——不是远程桌面

核心特性

• 服务端虚拟终端 — 完整 VTE 解析，服务端掌握精确屏幕状态，支持会话恢复与屏幕快照
• 会话持久化 — PTY 进程在断网后存活，自动重连 + 指数退避，刷新页面即可恢复
• 分屏与多 Tab — 可拖拽分屏、多 Tab 管理，服务端主导的 Pane 生命周期
• 广播模式 — 一个 pane 输入，多个 pane 同步执行，免费
• 命令收藏 — 右键终端文本直接收藏，分组管理，一键执行
• 服务器列表 — 管理多台远程服务器，快速切换连接
• 响应式布局 — 竖屏上下排列，横屏左右并排；触控优化的按钮与面板缩放
• 可自定义快捷键盘 — 为手机补齐 Ctrl/Esc/功能键，支持任意转义序列
• 内建文件浏览器 — 代码高亮、Markdown 渲染、Office 文档预览、音视频播放
• Git 变更指示 — 编辑器 gutter 增/改/删标记，inline diff，Stage/Revert
• 网页预览 — 内建反向代理，在 iframe 中预览本地开发服务器
• 通知系统 — 终端 bell/OSC 检测，WebSocket 推送，可配置声音提醒
• 系统监控 — 实时 CPU/内存/网络图表
• 插件系统 — JS 插件 + CLI 桥接，热重载，内置 CC Switch、JSON Formatter、Claude Code 对话管理等
• Open API — HTTP 端点，支持 Stream Deck、快捷指令等外部设备控制
• 命令面板 — 快速访问命令启动器
• 桌面应用 — 可选 Tauri 原生客户端

与其他终端的对比

其他 Web 终端只是 WebSocket 到 PTY 的透传管道。Dinotty 在服务端运行完整的虚拟终端仿真器，使得会话恢复、屏幕快照成为可能，结合内建文件/网页浏览器，提供自包含的 Coding Agent 工作环境。

AI Coding 方案对比

Claude Code 和 Codex 各自提供了内建的远程方案，但仅限于自身 Agent 生态。Happy/hapi 是第三方远程控制层，包装 CLI 实现手机审批和语音交互。Dinotty 是通用 Web 终端服务器，Agent 在服务端原生运行，同时提供文件浏览、网页预览、插件系统等完整工作环境，桌面端和移动端均有专业体验。

安装

前往 GitHub Releases 下载对应平台的安装包：

也可以从源码构建，见下方「快速开始」。

macOS 注意事项：由于应用未签名，macOS 可能会提示 "Dinotty" is damaged and can't be opened。安装后请在终端执行以下命令解除限制：

xattr -cr /Applications/Dinotty.app

Linux 一键下载安装：

curl -LO https://github.com/xichan96/dinotty/releases/download/v0.11.2/dinotty-server_0.11.2-1_amd64.deb && sudo dpkg -i dinotty-server_0.11.2-1_amd64.deb

Linux 启动方式：

# systemd
systemctl start dinotty-server
systemctl enable dinotty-server  # 开机自启

# Docker 容器
nohup dinotty-server &

默认监听端口 8999，启动后访问 http://<your-ip>:8999。可通过 -p 参数指定端口：

dinotty-server -p 3000

快速开始

# 构建前端
cd frontend && pnpm install && pnpm run build && cd ..

# 运行服务器
cargo run

在浏览器中打开 http://127.0.0.1:8999 。

# 带调试日志运行
RUST_LOG=debug cargo run

# 前端类型检查
cd frontend && npx vue-tsc --noEmit

技术栈

Rust 编写 · 单二进制 · 零依赖部署 — 服务端跑完整 VT 状态机，不是管道转发，断线会话不丢失。

项目结构

src/               # Rust 后端
  main.rs          # Axum 路由与服务入口
  lib.rs           # 库入口
  ws.rs            # WebSocket ↔ PTY 桥接
  vt_screen.rs     # 虚拟终端仿真器（基于 VTE）
  session.rs       # 会话管理器（多面板）
  pty.rs           # PTY 创建与管理
  tabs.rs          # Tab 与 Pane 管理
  history.rs       # 会话历史记录
  workspace/       # 文件工作区 API
  proxy/           # 反向代理（预览）
  monitor.rs       # 系统监控
  notification.rs  # 通知广播（bell/OSC 检测）
  plugin/          # 插件系统管理
  settings.rs      # 设置持久化
  auth.rs          # 身份认证
  file_watcher.rs  # 文件变更监听

frontend/          # Vue 3 SPA
  src/
    App.vue
    components/
      split/           # SplitContainer, TabBar, PaneHeader, StatusBar
      terminal/        # TerminalPane, MonitorPopover
      command/         # CommandPalette, CommandBookmarks
      keyboard/        # MobileKeyboard, HistoryPanel, SuggestionBar
      notification/    # NotificationPanel, NotificationCard
      preview/         # FileWorkspacePreview, PreviewPanel, WebPreview
      settings/        # 各设置 Tab（General, Theme, Keyboard 等）
      workspace/       # MonacoEditor, FilePreviewContent, gitDecorations
      plugin/          # PluginView
      ui/              # ConfirmModal 等通用组件
      ServerList.vue   # 服务器列表
    composables/   # useTerminal, useTransport, useSettings, useTabApi 等

src-tauri/         # Tauri 桌面客户端
docs/              # 设计文档

WebSocket 协议

通过 /ws 传输的 JSON 消息：

更多文档

• 部署指南 — systemd、Docker、跨平台构建、配置说明
• 通知系统 — HTTP API、Claude Code 集成、Open API
• 插件系统 — 安装、清单、API、内置插件
• 插件开发 — 完整的插件开发文档
• 贡献指南 — 分支策略、Commit 规范、代码风格

贡献者

感谢所有为 Dinotty 做出贡献的人！

Star History

许可证

MIT