OpenCLI
OpenCLI is a command-line program, not the Browser Use tool. Run it with the ordinary shell tool; the Computer plugin connects OpenCLI's standard local port to its persistent browser. For direct page or desktop interaction, load the computer skill and use computer.
Rules
- Run
openclithroughshell; never send OpenCLI arguments to a Browser tool. - Prefer a site adapter. Run
opencli list -f jsonand the leaf command's--help -f jsonbefore guessing commands or flags. - Request
-f jsonfor structured adapter output.PUBLICandLOCALadapters need no browser;COOKIE,INTERCEPT, andUIadapters need the Browser Bridge. - Browser-backed site adapters use
--window background --site-session persistent --keep-tab trueso one logged-in session can be reused. - Before browser-dependent work, run
opencli doctor. Daemon, Extension, and Connectivity must all be ready. - Preserve the exact shell exit code, stdout, stderr, and error. Do not silently fall back to raw HTTP or another browser profile.
- Never start another browser, close the persistent Chromium process, delete its profile, or remove
Singleton*files. The Computer plugin owns that lifecycle.
Discover and diagnose
shell({"command":"opencli list -f json","description":"列出 OpenCLI 能力"})
shell({"command":"opencli bilibili history --help -f json","description":"查看站点命令帮助"})
shell({"command":"opencli doctor","description":"检查 OpenCLI 连接"})
shell({"command":"opencli auth status","description":"检查登录状态"})
Site adapters
Put persistent browser options after the leaf command:
shell({"command":"opencli bilibili history -f json --window background --site-session persistent --keep-tab true","description":"读取哔哩哔哩历史"})
shell({"command":"opencli github whoami -f json --window background --site-session persistent --keep-tab true","description":"读取 GitHub 身份"})
The Computer plugin refreshes known login sessions every 12 hours and retries a failed refresh after 15 minutes. If a site has logged out, ask the user to log in once through the visible Computer panel.
Choosing the right capability
Site adapter or structured data → OpenCLI through shell
Page or desktop interaction → computer skill + computer