Agente

Agente 是一款专为开发者设计的 iOS 客户端，用于连接和交互远程编码代理。它支持 ACP（Agent Client Protocol） 和 Codex 应用服务器协议，让你在移动设备上查看工具调用、执行结果与完整对话历史。

无论你使用的是 Copilot CLI、Gemini CLI、Claude Code 适配器，还是 Qwen、Mistral Vibe 等开源模型代理，只要它们实现了 ACP 或 Codex 协议，Agente 都能接入。

核心功能

• 连接 ACP 代理
  支持主流编码代理：Copilot CLI、Gemini CLI、Claude Code 适配器、Qwen、Mistral Vibe 等。
• 连接 Codex 应用服务器
  可对接任何符合 Codex 协议的后端服务。
• 会话记录可视化
  清晰展示每一步的工具调用（Tool Call）及其返回结果，便于调试与回溯。
• 安全远程访问（可选）
  支持通过 Cloudflare Tunnel + Access 实现加密、受控的远程连接，适用于家庭服务器或云主机。

如何设置远程代理？

你可以在任意远程主机（如 Mac、Linux 服务器）上启动一个 ACP 代理，并通过 WebSocket Secure（wss://）暴露给 Agente。

快速示例：用 stdio-to-ws 暴露 Copilot CLI

# 启动代理（持久化，7天无活动自动退出）
npx -y @rebornix/stdio-to-ws --persist --grace-period 604800 "copilot --acp" --port 8765

# 停止代理
pkill -9 -f "stdio-to-ws.*8765"

该命令将 copilot --acp 的标准输入输出桥接到本地 WebSocket 服务（端口 8765）。

接下来，通过 TLS（如 Nginx、Caddy 或 Cloudflare Tunnel）将该端口暴露为 wss://your-host.example.com，即可在 Agente 中填入该地址进行连接。

若服务受保护，可在 Agente 中配置 Bearer Token 或 Cloudflare Access 服务令牌进行认证。

安全与部署建议

• 所有通信应通过 WSS（WebSocket Secure） 加密；
• 生产环境建议配合 Cloudflare Tunnel 避免公网 IP 暴露；
• 敏感操作可通过 Cloudflare Access 实现零信任访问控制；
• 代理进程支持长时间运行（--persist）并在闲置超时后自动清理（--grace-period）。

完整部署指南请参考本地文档：
📄 Agents.md（快速参考）
📄 docs/remote-agent.md（远程代理详细配置）

适用场景

• 在通勤途中审查 AI 生成的代码；
• 移动端调试本地开发机上的代理行为；
• 远程访问家庭实验室中的 Claude Code 或 Copilot CLI；
• 安全地从手机连接受 Cloudflare 保护的内部工具链。

Agente 不是一个通用聊天应用，而是一个面向编码工作流的终端延伸。它把代理的“思考过程”——包括工具调用与执行结果——带到你的掌中，让移动端真正成为开发闭环的一部分。