关于 opencli-usage
opencli-usage 是指导 Agent 使用 OpenCLI 的技能。它介绍命令搜索、浏览器会话、网站适配器、插件、认证与守护进程管理,并说明 JSON 输出和错误处理。
主要功能
- 01搜索和分页浏览命令
- 02查看命令帮助与输出格式
- 03管理 Chrome 浏览器会话
- 04初始化和测试网站适配器
- 05管理插件、认证和守护进程
适用场景
- 01查找适用于网站的 CLI 命令
- 02连接 Chrome 并检查浏览器状态
- 03测试网站适配器命令
- 04诊断认证或桥接进程状态
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jackwener/ opencli --skill opencli-usage安装后在 Claude Code 中输入/opencli-usage确认已加载。
详细介绍
OpenCLI
OpenCLI 向 Agent 提供可复用的网站适配器和直接调用 Chrome 的工具。
opencli list search
opencli list --site github --limit 20
opencli github search --help -f json
list [query] 会搜索内置工具和适配器中的命令名称与描述。
结果简洁且支持分页:{ok:true,data:{commands,total,nextOffset?}}。
传入 --offset <nextOffset> 可继续查看。使用命令帮助查看确切的输入参数。
不要对适配器目录进行硬编码,也不要将所有命令都输出到上下文中。
结果
命令默认以 JSON 格式输出:{ok:true,data:...}。执行失败会返回非零退出代码,
并在 stdout 上输出 {ok:false,error:{code,message,hint?,...}}。日志使用 stderr。
命令帮助中列出的命令支持显式使用 -f table|yaml|csv|md|plain 导出。
帮助、版本、补全和显式的 plain 导出会保留各自的格式。
浏览器跟随模式会逐行输出一个 JSON 封装。
使用错误代码和提供的候选项/键进行恢复。写入结果未知时,必须先检查状态再重复操作。 成功但结果为空与执行失败是两种不同情况。
浏览器
opencli browser open https://example.com --session research
opencli browser state --session research
opencli browser close --session research
opencli browser chrome describe
页面命令使用 --session;原生 Chrome 方法无需会话。--profile
用于选择已连接的 Chrome 配置文件。使用 profile list 查找配置文件,
并使用 profile use <name> 设置默认配置文件。使用 doctor 诊断连接问题。
有关交互、API 证据和标签页/分组管理,请参阅 opencli-browser。
适配器和安装
opencli adapter init example/search
opencli adapter check example/search
opencli adapter test example/search --args '{"query":"hello"}'
opencli adapter status
有关实现方法,请参阅 opencli-adapter-author。adapter eject 可将官方站点适配器设为可在本地编辑;
adapter reset 会移除本地覆盖。适配器测试会执行真实命令,也可能执行写入操作。
plugin list|install|update|uninstall|create 用于管理插件包。auth status
会报告网站登录状态;auth refresh 会刷新会话。daemon status|restart|stop
用于管理桥接进程。请查阅所选功能的帮助。
通过 skills list 和
skills read opencli-browser -f plain 可以查看随附的技能内容(省略 -f plain 时输出 JSON)。