轻量、纯原生、AI 加持的 macOS Shell 工作台。

一个使用 SwiftUI 构建的原生 macOS SSH + SFTP + AI 工作台，聚焦轻量、纯原生、高频终端体验，以及原生文件管理与 Docker 工作流。

English • 更新日志 • 功能特性 • 截图 • 快速开始 • 常见问题 • 项目结构 • 架构 • 测试 • 社区 • 参与贡献

Remora 聚焦在一个实用组合：

• 原生 macOS 体验的连接与会话管理。
• SSH 与 SFTP 在一个工作区内协同完成。
• AI 助手自然嵌入终端流程，用来解释输出、建议命令、辅助排障，而不是强行把终端变成聊天应用。
• 轻量、纯原生、尽量低心智负担：打开就能连，设置清晰，日常工作不需要围着复杂代理系统转。

• Fantastic：本地优先的 SSH + SFTP 工作区，支持现代 TUI 所需 ANSI/VT、xterm 风格选择、快捷命令/快捷路径、拖拽传输，以及独立文件管理窗口。
• Beautiful：原生 macOS 视觉与交互，布局简洁，支持浅色/深色/跟随系统，终端专注无干扰。
• AI-assisted：内置 Terminal AI，支持 provider → model 配置、自定义 endpoint、OpenAI / Claude 兼容接口、上下文压缩、排队提问、命令建议与解释。
• Extensible：支持本地拓展脚本，可用 Shell / Python / JavaScript / Swift 编写全局或主机级自动化，并从 SSH 主机上下文一键运行。
• Fast：Swift 6 原生实现 + SwiftTerm 终端栈 + 原生 macOS UI，面向高频 TUI 与滚动场景优化。
• Secure：采用本地优先的凭据策略，配置与已保存密码写入 ~/.config/remora 本地 JSON 文件，SSH 主机指纹通过 StrictHostKeyChecking=ask 显式确认，任何明文密码导出或复制都需要用户主动确认。
• Simple：轻量设计，99% Swift-native 技术栈，默认配置即可开箱使用，并支持键盘快捷工作流。

• 在同一工作区里运行本地 Shell 与 SSH 会话（多标签/分栏）。
• 管理主机分组、搜索、收藏，并使用快速连接。
• 通过独立的 SFTP 文件管理窗口执行新建、重命名、移动、删除、复制/粘贴、上传/下载，并查看传输进度。
• 拖拽上传到目录或当前路径，带目标高亮与提示。
• 获取即时操作反馈（toast）并重试失败传输。
• 需要时开启终端目录与文件管理目录同步。
• 打开原生 Docker 工作区，查看容器 / 镜像 / Compose，执行 Shell、查看日志、停止或重启容器。
• 在设置中保存拓展脚本，或从主机右键菜单运行全局/主机脚本。
• 在终端侧边面板里使用 Terminal AI 解释输出、建议下一条命令、修复常见错误，并在长对话中自动压缩上下文。
• 在设置中配置语言、外观、快捷键和指标采样。

拓展脚本在你的 Mac 本地执行，脚本文件保存到 ~/.config/remora/extension-scripts.json。Remora 支持 Shell、Python、JavaScript 和 Swift，分别依赖本机可用的 /bin/zsh 或 /bin/bash、python3、node、swift。

从 SSH 主机上下文运行时，Remora 会注入 REMORA_HOST_ID、REMORA_HOST_NAME、REMORA_HOST、REMORA_PORT、REMORA_USER、REMORA_AUTH_METHOD、REMORA_KEY_PATH、REMORA_LOCAL_DOWNLOAD_DIR 和 REMORA_CONTEXT_JSON。REMORA_CONTEXT_JSON 指向一个临时 JSON 文件，包含更完整的主机上下文。出于安全考虑，Remora 默认不会把密码、token 或私钥内容注入脚本；请只运行来源可信的脚本。

SSH 工作区	终端（TUI 友好）
独立文件管理窗口 + 传输进度	Terminal AI 对话
Terminal AI 设置

• macOS 14.0 (Sonoma) 或更高版本
• Xcode 15.4+

swift build
swift run RemoraApp

如果你更习惯 Xcode，直接打开 Remora.xcodeproj，首次等待 Xcode 自动解析 Swift packages，然后运行 Remora scheme 即可。

正式的本地打包与 GitHub Actions 使用同一条命令：

./scripts/package_macos.sh --arch "$(uname -m)" --version 0.0.0-local --build-number 1

输出文件位于 dist/，例如：

dist/Remora-0.0.0-local-macos-arm64.zip

可选压力工具：

swift run terminal-stress

运行核心测试：

swift test

运行 UI 自动化测试（按需开启）：

REMORA_RUN_UI_TESTS=1 swift test --filter RemoraUIAutomationTests

如果 RemoraApp 二进制路径非默认：

REMORA_RUN_UI_TESTS=1 REMORA_APP_BINARY=/abs/path/to/RemoraApp swift test --filter RemoraUIAutomationTests

A: 先确认这是你信任的来源（例如 GitHub Releases），并且你解压的是完整的 Remora.app。
然后在终端执行（把路径替换成你本地实际路径）：

xattr -dr com.apple.quarantine /path/to/Remora.app

A: 到系统设置手动放行一次：

1. 打开“系统设置” -> “隐私与安全性”。
2. 在安全提示区域找到被阻止的 Remora.app。
3. 点击“仍要打开”并确认。

• Sources/RemoraCore：SSH/SFTP/会话/主机/安全/核心模型。
• Sources/RemoraTerminal：SwiftTerm 适配层与 app 侧终端视图集成。
• Sources/RemoraApp：SwiftUI 应用、工作区 UI、设置、文件管理。
• Sources/TerminalStressTool：终端吞吐/压力工具。
• Tests/*：core、terminal、app 测试。
• docs/：清单、截图与运行说明文档。

欢迎贡献代码与建议。

• 提交 PR 前请先阅读 CONTRIBUTING.md。
• 社区互动请遵守 CODE_OF_CONDUCT.md。
• Bug 或功能建议请使用 GitHub Issues。

• GitHub: wuuJiawei/Remora
• Issues: 提交 Bug / 功能建议
• Support: SUPPORT.md
• X（更新公告）: @1Javeys

Remora 在设计与实现过程中受到了以下项目和产品的启发或帮助：

• opencode
• oh-my-opencode
• SwiftTerm
• OpenAI
• Claude Code

特别感谢 2Libra 和 V2EX 社区。

两个社区的早期用户提供了不少非常有价值的反馈，也帮助发现了不少问题，对于产品的进步和成熟提供了极大的帮助。

感谢每一位愿意试用、讨论、提出建议和指出问题的朋友。

请阅读 SECURITY.md 了解负责任披露流程。

本项目采用 MIT License，详见 LICENSE。