curl -F "reqtype=fileupload" -F "fileToUpload=@文件路径" https://catbox.moe/user/api.php

Vibe Remote 技能

远程调用 AI Coding Agent 的工具，通过 iOS app 远程控制 Mac/Linux 机器上的 Claude Code / Codex 来写代码。

基本信息

• - 仓库: https://github.com/ymzuiku/vibe-remote
• 文档: https://docs.vibe-remote.com
• 支持的 Agent: Claude Code（推荐）、Codex、OpenCode（实验性）

启动

bash
export PATH=$HOME/bin:$PATH
vibe-remote

启动后会显示 QR 二维码，用 iOS Vibe Remote app 扫码连接。

Headless 模式（CI / 脚本）：
bash
vibe-remote --headless --account <用户名> --password <密码>

二进制文件路径：~/bin/vibe-remote

GitHub Issue 提交流程

提交 issue 前需要：

1. 1. 确保 gh CLI 已登录 GitHub：gh auth status
2. 确认 owner/repo：ymzuiku/vibe-remote
3. Issue 提交完成后，必须将链接发送给用户

Bug Report 格式

bash
gh issue create --repo ymzuiku/vibe-remote \
--title <标题> \
--body ## Bug Description
<描述>

Steps to Reproduce

1. 1. ...
2. ...

Expected Behavior

<期望行为>

Actual Behavior

<实际行为>

Version

<版本号> vibe-remote Version: <版本> \ --label bug

Feature Request 格式

bash
gh issue create --repo ymzuiku/vibe-remote \
--title <标题> \
--body ## Problem / Motivation
<问题背景>

Proposed Solution

<建议方案>

Alternatives Considered

<考虑过的替代方案> \ --label enhancement

图片/视频上传（嵌入 Issue）

GitHub Issue API 不支持直接上传二进制文件。规则：

文件类型	上传方式
图片（jpg/png/gif/webp）	使用 nodeimage-upload 技能；如不可用则用 catbox
视频（mp4/mov）

上传到 catbox（见下方命令） |

上传到 catbox（图片或视频均可用）：
bash
curl -F reqtype=fileupload -F fileToUpload=@文件路径 https://catbox.moe/user/api.php

返回的 URL：

• - 图片：用 嵌入 issue body
• 视频：直接贴 URL

Issue 模板（参考）

字段	说明
vibe-remote 版本	版本号，如 0.1.254
操作系统

macOS (Apple Silicon) / macOS (Intel) / Linux / Windows | | Bug 描述 | 描述问题 | | 重现步骤 | 重现步骤 | | 期望行为 | 期望行为 | | 实际行为 | 实际行为 |

Issue 链接格式：https://github.com/ymzuiku/vibe-remote/issues/<编号>

常用命令

bash

显示帮助

vibe-remote help

检查版本

vibe-remote --version

重新生成 QR 码（运行中按 r）