Cocurdex

设备与本地网页

在本机浏览器中打开 Cocurdex,把另一台设备按权限配对,或在同一 daemon 上使用 iOS 与 Android 应用。

桌面应用是主机。设置 → 设备 让你从浏览器使用这台主机——本机,或你配对的另一台设备——也可以从 iOS 与 Android 应用使用。

这里不会替换 daemon。浏览器和手机应用连的都是已经在这台机器上运行的 Cocurdex 实例,不会另开一个工作区,也不需要云账号。

在浏览器中打开(本机)

设置 → 设备 → 在浏览器中打开 会加载本地网页客户端,连到与桌面应用相同的工作区和会话。

CLI 会打印该 URL:

cocurdex web

桌面应用必须在运行,daemon 才能提供该客户端。URL 带有本机 token,请把它当作对本机的访问权限来对待。

远程访问

默认关闭。允许远程设备 让局域网或 Tailscale tailnet 上已配对的设备连到这台电脑。

  • 有可达地址时,界面会列出 局域网 和 Tailscale。
  • 可以设置监听端口(字段里会显示默认值)。
  • 连接未加密。请在受信任的网络上使用,或走 Tailscale。

从 CLI:

cocurdex host status
cocurdex host remote enable [--port <port>]
cocurdex host remote disable

配对设备

配对设备 会生成一次性配对码。在另一台设备的浏览器里打开配对链接,或在配对此浏览器界面输入配对码。在 iOS 或 Android 应用里,把该链接粘贴到配对电脑(字段是配对链接,然后点配对)。应用会加入这台电脑、选中它,然后回到会话。

设置含义
设备名称显示在已配对设备列表中的标签
配对码有效期10、30 或 60 分钟
权限新设备可以做什么(见下)

若要让对方打开链接,请先开启远程访问。配对码只能用一次。未完成的配对会出现在待完成的配对中,直到过期或你取消。

cocurdex host pair --label "My phone" [--scopes read,interact,approvals] [--ttl <minutes>]
cocurdex host pairings
cocurdex host pairing cancel <pairing-id>

CLI 默认权限是 read、interact 和 approvals。

已配对设备可以做什么

配对时选择权限。主机管理(改应用设置、管理设备)只属于这台电脑,不能授给已配对设备。

权限允许该设备
读取查看会话、消息、笔记、issue 和演示文稿
交互发送消息、停止会话、编辑笔记、issue 和演示文稿
审批处理权限请求、问题和计划审批
启动任务启动会话、团队和脚本运行
读取文件读取工作区文件、差异和 Git 状态,并读出工作区里 PowerPoint 文件的提纲
写入文件编辑工作区文件、暂存、提交,以及把导出的演示文稿写进工作区
破坏性 Git 操作丢弃更改、切换分支和推送
凭据管理模型提供方登录、API Key 和 MCP 服务器

随时可在已配对设备中吊销。设备会立即断开,必须重新配对才能再连。

cocurdex host devices
cocurdex host revoke <device-id>
cocurdex host audit [--limit <n>]

访问记录记录本机上的配对、吊销和远程访问变更。

原生应用

iOS 与 Android 应用有两个标签:会话和电脑。电脑列出已配对的电脑。会话是工具栏里当前电脑的实时会话列表。

还没有配对电脑时,会话会显示还没有电脑和配对电脑。配对之后,点工具栏上的电脑名称可以切换,或选择配对电脑再加一台。

会话按工作区分组。搜索会话用来筛选。子会话的状态会汇总到根会话那一行:

状态含义
需要处理有权限请求、提问或计划在等你
运行中会话仍在工作
未读已有结果,你还没打开

标题下面的一行更具体,例如等你批准、有问题要问你、计划已写好,等你决定、正在运行…、正在连接…、正在后台运行或已完成。运行失败时显示运行失败。

手机暂时连不上电脑、但本地已有列表时,列表会保留,并显示连不上电脑名称**,显示的是最后一次更新。** 还没有任何列表时,画面是连不上该电脑,下面写着请确认电脑没有休眠,并且和手机在同一网络。,并提供重试。这台电脑没有会话时显示没有会话——在该电脑上开始的会话会显示在这里。 搜索没有命中时显示没有匹配“…”的会话。

打开一行后,底部标签栏隐藏,返回按钮为会话。标题是会话名,下面是工作区和模型。记录会随着 Agent 运行而更新:你的消息、助手的消息,以及工具调用。

助手的消息按 Markdown 显示。表格会渲染。代码块会显示语言名、复制按钮和语法高亮。数学公式已关闭。

输入框的占位符是回复 agent。发送送出消息。会话正在运行且输入为空时,这个按钮是停止。发送和停止都需要配对时授予的交互权限。

Agent 在等你时,底部的停靠栏会换掉输入框:

  • 权限请求,以及给出的选项。
  • 提问。在你的回答里输入后点回复,或直接选一个选项。Agent 没有自定标题时,标题是 agent 有个问题。
  • 计划,标题是审阅计划。批准接受计划。继续规划让 Agent 继续规划。

配对时没有审批权限时,这个停靠栏会显示请在电脑上批准和这台手机配对时没有授予审批权限。 请在电脑上完成批准。

相关

本页目录