远程控制 (Remote Control)
把本地终端做成中继，让 CrabCode Web / 手机 App 远程在你本地项目里跑会话。
是什么
Remote Control 让你的本地终端常驻为一个 bridge，CrabCode Web 端 / 手机 App 登录同一账号后就能在你的本地项目目录里发起会话 —— 模型在你本地执行（吃你的 CPU、读你的文件、走你的权限），UI 在云端或手机上。
适合：出门没带笔记本时用手机继续；坐在另一台机器上想用家里电脑的代码环境；给同事远程演示。
何时会看到这个文档
- 启动
crabcode remote-control时 - TUI 内输入
/remote-control后的引导界面 - Web/手机端配对时提示「了解更多」
启用
终端里两种入口都可以：
crabcode remote-control # 子命令形式
# 旧别名：crabcode rc / remote / sync / bridge 也兼容crabcode remote-control # 子命令形式
# 旧别名：crabcode rc / remote / sync / bridge 也兼容或在 TUI 里：
/remote-control/remote-control启动后会显示配对信息。在 acosmi.com 账号下的 Web 端或手机 App 登录同一账号即可看到这台机器。
几种会话发起方式
bridge 启动后，远端连进来时可选：
- 创建新会话：在指定目录里 spawn 一个新的 CrabCode 会话
- 使用 worktree：在 git worktree 隔离目录里 spawn，避免与本地正在编辑的内容冲突
- 复用现有会话：attach 到本地已经在跑的会话（共享视图）
具体可选项在引导菜单里按当前环境给出。
使用场景
- 出门没带电脑，用手机继续早上的 CrabCode 会话
- 给同事 Web 端 attach 看你的实时调试
- 跨电脑：家里 Mac 跑代码，工位 PC 远程查看
限制与注意
- 需要 acosmi.com 订阅：bridge 必须用订阅账号登录 (
crabcode auth login) - 要能出站到 acosmi.com：本地不需要公网入口，但需要出站；中继在云端
- 本地权限 = 远端权限：手机端能跑的命令完全是你本地终端能跑的；慎用绕过权限的开关
- 断网会断会话：bridge 不持久化；重连后能否恢复看具体会话状态