@kmlckj/licos-bridge

LICOS 本地 Agent 桥接 CLI。它在本机启动后台 daemon，把平台里的本地个人助手连接到本机的 Claude ACP / Codex ACP 运行时。

前置依赖

• Node.js >= 20
• 本机至少安装或可运行一种 ACP runtime：
  • Claude：@agentclientprotocol/claude-agent-acp
  • Codex：@zed-industries/codex-acp

使用

npx -y @kmlckj/licos-bridge@latest --pat-token=<token> --pair-code=<pair-code> --handshake-url=<platform-url>

licos-bridge status
licos-bridge stop
licos-bridge refresh
licos-bridge purge
licos-bridge service install
licos-bridge service uninstall

工作目录

默认使用：

~/.licos/
├── bridge/
│   ├── bridge.pid
│   ├── bridge.port
│   ├── bridge.token
│   ├── bridge.log
│   └── config.json
└── agents/<agentId>/
    ├── config.json
    ├── workspace/
    └── logs/

可通过环境变量覆盖：

• LICOS_BRIDGE_HOME
• LICOS_BRIDGE_AGENTS_HOME
• LICOS_BRIDGE_HANDSHAKE_URL
• LICOS_PLATFORM_BASE_URL
• AIOS_PLATFORM_BASE_URL

云端协议入口

--handshake-url 可以是平台 base URL，也可以直接是 handshake endpoint。平台生成的连接命令会显式携带这个参数；如果手写命令，可以通过 LICOS_BRIDGE_HANDSHAKE_URL、LICOS_PLATFORM_BASE_URL 或 AIOS_PLATFORM_BASE_URL 提供。

桥接工具不再内置固定平台地址。没有命令参数、没有本地已保存地址、也没有环境变量时会直接报错，避免 dev/prod 环境串连。历史版本保存的 https://www.licos.com 默认地址在自动重连时会被拒绝，需要从目标平台重新复制连接命令。

默认 handshake path：

/api/v1/workbench/local-agent-bridge/handshake

handshake 返回的 frontierUrl / data.frontierUrl 会用于 WebSocket 长连接；也可以用 --frontier-url 覆盖。

已支持的 bridge 控制帧

_agent/create
_agent/detail
_agent/update
_agent/disconnect
_agent/health
_agent/getFileTree
_agent/getFileContent
_agent/listSkills
_agent/addSkills
_agent/removeSkills
session/new
session/prompt
session/cancel

文件树和文件内容只读取本地 agent workspace，不会自动上传到平台。技能安装会写入本地 workspace 的 .skills/<skillId>，并更新 agent config；安装或移除后会停止当前 ACP runtime，下一轮对话重新加载。

_agent/addSkills 支持三种输入：

• downloadUrl/packageUrl/archiveUrl/url：下载 .zip / .skill 包并解压。
• content/skillMd：直接写成 SKILL.md。
• files：直接写入多文件技能目录。