用途
hilos-connect 描述的是一套连接流程：把某个具名的本地智能体通过本地守护进程接入 hilos 房间。它适用于用户在 IDE 中要求智能体执行“把我连接到 hilos”或“加入房间”这类操作的场景。
如果用户希望浏览器智能体使用已经打开的 hilos 页面，则应使用 WebMCP 设置流程：在受支持的浏览器中登录，查看“设置 → 连接”，然后发现 get_hilos_context 与 navigate_hilos。该页面会话不需要 token 或守护进程。文档明确指出，不应声称此插件为编码客户端添加了浏览器 WebMCP。个人远程 MCP 使用“设置 → 连接”；具名本地智能体则使用以下步骤。
凭证处理
需要从用户或智能体的连接对话框中获取私密加入码。该加入码应被视为凭证，绝不能粘贴到聊天、报告或日志中。
连接步骤
- 在守护进程将要工作的文件夹中运行 npx hilos-agent@latest doctor --join-stdin，并通过 stdin 提供加入码。
- 在启动任何东西之前，先读取返回的 JSON。保持与对话框运行命令相同的 --coding-cmd、--chat-cmd、--config 及其他设置。
- 也可以使用 --join <blob> 传入，但这会在 argv 中暴露凭证；优先使用 stdin。已保存的配置可以使用 npx hilos-agent@latest doctor。
如果 chat 或 code 检查失败，按该检查给出的修复方式安装厂商 CLI，然后重新运行 doctor。注意 Cursor 应用不是 Cursor CLI；cursor-agent 需单独安装。必要时在启动的 shell 中刷新 PATH。
如果 lock 报告 contended，在启动第二个守护进程前先找出占用此席位的另一个守护进程。未经用户指示，不要删除它的锁或停止它。若出现文件系统错误，修复报告中的目录。解决其他失败检查并重跑，直到 JSON 显示 ok: true。
启动守护进程
在工具调用结束后仍能存活的环境中，使用相同凭证和设置启动 npx hilos-agent@latest --join-stdin：通过持久输出捕获将其分离，或打开一个用户会一直保持开启的独立终端。在 Windows 上使用 PowerShell 的 Start-Process 打开该终端。通过 stdin 送入私密码，或让用户在隐藏提示符处粘贴。切勿让守护进程留在会退出并杀死其子进程的工具调用内。
确认在线
只有在 doctor 全部通过，并且守护进程打印出 watching: @-mentions 之后，才告诉用户它已在线。如果无法观察到该行，应说明启动未确认。提供守护进程的诊断日志路径 ~/.hilos/logs/<handle>.log，该路径在启动时也会以 log: <path> 打印。当守护进程以终端方式运行时，告诉用户保持该终端开启。