OpenCode Remote Manager

A macOS menu bar app for managing two OpenCode remote connections and exposing localhost remotes.

GitHub Repository

Language / 语言: 中文 · English

---

中文

导航: 概览 · 功能 · 安装 · 开发 · 打包 · 发布 · 许可与社区

概览

OpenCode Remote Manager 是一个开源 macOS 菜单栏应用，用于管理两个 OpenCode 远程连接，并将 localhost remote 稳定暴露给本机工作流。它面向日常使用，重点是常驻、状态清晰和操作简单。

功能

• 菜单栏常驻，快速查看连接与健康状态
• 管理两个固定的 OpenCode remote 连接
• 维护 SSH 隧道与 localhost remote 暴露
• 支持登录后自动启动，减少手动干预
• 提供 CLI 诊断与常用运维命令

安装

• 发布版本可从 GitHub Releases 下载
• 打包产物名称为 dist/OpenCodeRemoteManager-macOS.zip
• 解压后将应用移入 Applications 并启动

开发

要求：

• macOS 14+
• Swift 6.0+

git clone https://github.com/a1418507570/opencode-remote-manager.git
cd opencode-remote-manager
swift build
DYLD_FRAMEWORK_PATH="/Library/Developer/CommandLineTools/Library/Developer/Frameworks" \
DYLD_LIBRARY_PATH="/Library/Developer/CommandLineTools/Library/Developer/usr/lib" \
swift test -Xswiftc -F -Xswiftc /Library/Developer/CommandLineTools/Library/Developer/Frameworks \
  -Xlinker -rpath -Xlinker /Library/Developer/CommandLineTools/Library/Developer/Frameworks \
  -Xlinker -rpath -Xlinker /Library/Developer/CommandLineTools/Library/Developer/usr/lib
swift run OpenCodeRemoteManagerCLI diagnose --json

打包

./Scripts/package-app.sh
./Scripts/package-release.sh

发布压缩包输出到 dist/OpenCodeRemoteManager-macOS.zip。

发布

• CI 工作流文件：.github/workflows/ci.yml
• 发布标签格式：v*，例如 v0.1.0
• 建议在 GitHub Release 中附上 dist/OpenCodeRemoteManager-macOS.zip

许可与社区

• 许可证：Apache-2.0
• 贡献说明：CONTRIBUTING.md
• 项目路线图：ROADMAP.md
• 社区行为：CODE_OF_CONDUCT.md
• 安全反馈：SECURITY.md

---

English

Navigation: Overview · Features · Installation · Development · Packaging · Release · License & Community

Overview

OpenCode Remote Manager is an open-source macOS menu bar app for managing two OpenCode remote connections and exposing localhost remotes to local workflows. It is built for day to day use, with a focus on always-on presence, clear status, and simple operation.

Features

• Menu bar first experience with quick connection and health visibility
• Management for two fixed OpenCode remote connections
• SSH tunnel handling and localhost remote exposure
• Login-time auto start for less manual setup
• CLI diagnostics and operator commands when needed

Installation

• Download releases from GitHub Releases
• The packaged artifact is dist/OpenCodeRemoteManager-macOS.zip
• Unzip the app bundle, move it into Applications, and launch it

Development

Requirements:

• macOS 14+
• Swift 6.0+

git clone https://github.com/a1418507570/opencode-remote-manager.git
cd opencode-remote-manager
swift build
DYLD_FRAMEWORK_PATH="/Library/Developer/CommandLineTools/Library/Developer/Frameworks" \
DYLD_LIBRARY_PATH="/Library/Developer/CommandLineTools/Library/Developer/usr/lib" \
swift test -Xswiftc -F -Xswiftc /Library/Developer/CommandLineTools/Library/Developer/Frameworks \
  -Xlinker -rpath -Xlinker /Library/Developer/CommandLineTools/Library/Developer/Frameworks \
  -Xlinker -rpath -Xlinker /Library/Developer/CommandLineTools/Library/Developer/usr/lib
swift run OpenCodeRemoteManagerCLI diagnose --json

Packaging

./Scripts/package-app.sh
./Scripts/package-release.sh

The release archive is written to dist/OpenCodeRemoteManager-macOS.zip.

Release

• CI workflow file: .github/workflows/ci.yml
• Release tags should follow v*, for example v0.1.0
• Attach dist/OpenCodeRemoteManager-macOS.zip to the GitHub release

License & Community

• License: Apache-2.0
• Contributing: CONTRIBUTING.md
• Roadmap: ROADMAP.md
• Code of Conduct: CODE_OF_CONDUCT.md
• Security: SECURITY.md