Vibe Remote Skill
远程调用 AI Coding Agent 的工具,通过 iOS app 远程控制 Mac/Linux 机器上的 Claude Code / Codex 来写代码。
基本信息
启动
export PATH="$HOME/bin:$PATH"
vibe-remote
启动后会显示 QR 二维码,用 iOS Vibe Remote app 扫码连接。
Headless 模式(CI / 脚本):
vibe-remote --headless --account <用户名> --password <密码>
二进制文件路径:~/bin/vibe-remote
GitHub Issue 提交流程
提交 issue 前需要:
- 确保
gh CLI 已登录 GitHub:gh auth status
- 确认 owner/repo:
ymzuiku/vibe-remote
- Issue 提交完成后,必须将链接发送给用户
Bug Report 格式
gh issue create --repo ymzuiku/vibe-remote \
--title "<标题>" \
--body "## Bug Description
<描述>
## Steps to Reproduce
1. ...
2. ...
## Expected Behavior
<期望行为>
## Actual Behavior
<实际行为>
## Version
<版本号>
vibe-remote Version: <版本>" \
--label "bug"
Feature Request 格式
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 Skill;如不可用则用 catbox |
| 视频(mp4/mov) | 上传到 catbox(见下方命令) |
上传到 catbox(图片或视频均可用):
curl -F "reqtype=fileupload" -F "fileToUpload=@文件路径" https://catbox.moe/user/api.php
返回的 URL:
- 图片:用
 嵌入 issue body
- 视频:直接贴 URL
Issue 模板(参考)
| 字段 | 说明 |
|---|
| vibe-remote Version | 版本号,如 0.1.254 |
| Operating System | macOS (Apple Silicon) / macOS (Intel) / Linux / Windows |
| Bug Description | 描述问题 |
| Steps to Reproduce | 重现步骤 |
| Expected Behavior | 期望行为 |
| Actual Behavior | 实际行为 |
Issue 链接格式:https://github.com/ymzuiku/vibe-remote/issues/<编号>
常用命令
# 显示帮助
vibe-remote help
# 检查版本
vibe-remote --version
# 重新生成 QR 码(运行中按 r)