OpenCLI：把任意网站、Electron应用和本地工具变成统一CLI

数码系统

相机 win10

测评 win11

手机智车

华为 Tesla

小米理想

苹果蔚来

游戏软件

LOL 抖音

原神微信

当前位置：首页

AI教程

OpenCLI：把任意网站、Electron应用和本地工具变成统一CLI

热心网友时间：2026-06-26

转载

引言

今天要聊的这个项目，是「一天一个开源项目」系列的新一篇。主角叫 OpenCLI，一个能让终端变成「万能入口」的野心之作。（GitHub 链接见文末）

一天一个开源项目（第64篇）：OpenCLI - 把任意网站、Electron 应用与本地工具变成统一 CLI

开发者们一直在幻想这样一个终端入口：既能流畅地调起 gh、docker，又能直接刷 B 站热榜、查知乎、管小红书，最妙的是还能让 AI Agent 一眼发现、一键调用。OpenCLI 的解法很直接——把任意网站、Electron 桌面应用或本地 CLI 工具，统统标准化成统一的命令行接口。它通过 Browser Bridge（一个 Chrome/Chromium 扩展加上本地微守护进程）复用你已登录的浏览器会话，配上 70+ 个预置适配器、CLI Hub 透传（比如 opencli gh、opencli docker 这样的命令）、Electron 应用适配（Cursor、Antigra vity、ChatGPT 桌面版等），再加上面向 AI 的 opencli-operate 技能（点击、输入、截图、抽取等浏览器操作），让「人」和「Agent」共享同一套工具目录。

为什么值得关注？

? 统一 CLI Hub：一个 opencli 入口，内置站点命令 + 外部 CLI 注册与发现
? 账号相对安全：浏览器命令复用 Chrome/Chromium 登录态，凭据不离开浏览器语境（以官方 README 说明为准）
? 为 AI Agent 设计：Skills、AGENT.md / .cursorrules 里配置 opencli list 便于自动发现
? 网站即 CLI：explore / synthesize / record 等流程，把交互沉淀为可脚本化命令
?️ Electron 也可 CLI 化：桌面 AI 应用、IDE、IM 等可通过适配从终端驱动
? 输出可管道化：table / json / yaml / md / csv，Unix 退出码约定便于 CI

你将学到什么

OpenCLI 的产品分层：Browser Bridge、守护进程、CLI 本体、扩展之间的关系
内置能力：站点适配器、CLI Hub、Electron 适配、插件机制
AI 侧集成：opencli-operate、explore / synthesize / cascade 等工作流
隐私与边界：登录态复用、Provider 条款、Sparkle 式更新以外的数据流（以文档为准）
本地开发与排障：opencli doctor、常见错误码与扩展连接问题

前置知识

Node.js 20+（或 Bun 1.0+）与 npm 全局安装经验
Chrome / Chromium 与「加载未打包扩展」的基本操作
熟悉终端与管道（jq、脚本、CI）更佳
若开发适配器：TypeScript / YAML、浏览器自动化概念（可选）

项目背景

项目简介

OpenCLI 是一个用 Node.js 编写的通用命令行运行时：一端连接浏览器（通过扩展 + 本地守护进程，复用用户已登录的站点），另一端聚合本地已安装的 CLI（gh、docker、飞书 lark-cli 等），还能把 Electron 桌面应用通过 CDP 等方式纳入同一张「命令表」。项目强调 Deterministic（相同命令、稳定输出结构）、可脚本化、对 AI Agent 友好（Skills、命令发现、文档内嵌工作流）。

典型用法包括：在终端拉取各站内容（JSON 管道给 LLM）、让 Agent 通过 operate 控制真实浏览器完成复杂页面操作、把团队内部工具 opencli register 后纳入统一发现列表。

作者/团队介绍

维护者：jackwener（仓库主账号）
分发：npm 包名为 @jackwener/opencli
许可证：Apache-2.0

项目数据

⭐ GitHub Stars: 约 12,570（以仓库页面为准，会随时间变化）
? Forks: 以 GitHub 页面为准
? 版本：见 npm 与 Releases
? License: Apache-2.0
? 文档：仓库内 README.md、README.zh-CN.md、docs/

主要功能

核心作用

网站 → CLI：对 Bilibili、知乎、小红书、Twitter/X、Reddit、YouTube 等提供子命令；总计 70+ 适配器（文档中有完整列表入口）。
浏览器自动化（operate）：为 AI Agent 提供可脚本化的页面操作指令集（open、click、type、screenshot 等，见官方 Skills）。
CLI Hub：opencli gh、opencli docker 等透传；缺失时可尝试通过包管理器自动安装（如 README 所述 brew install 再执行）。
Electron / 桌面应用：内置多类桌面应用适配说明（Cursor、Codex、Antigra vity、ChatGPT 桌面版等），并给出扩展阅读文档链接。
插件生态：支持社区 YAML/TS 插件安装与更新。
输出与退出码：多格式输出 + 对齐 sysexits.h 的退出码，便于 shell 与 CI。

使用场景

终端里消费站点数据
- 热榜、搜索、时间线等，配合 -f json 管道给脚本或模型。
AI Agent 统一工具发现
- 在 AGENT.md 或 .cursorrules 中引导执行 opencli list，减少「不知道有哪些工具」的摩擦。
把重复网页操作固化成命令
- 使用 record / 生成适配器相关工作流，将一次性操作变为可复用 CLI。
在自动化里驱动桌面 AI 应用
- 通过文档中的 Electron 适配路径，从终端编排「应用级」任务（需阅读对应适配文档与合规边界）。
与现有 CLI 共存
- 不替换 gh 或 docker，而是通过 Hub 统一入口与发现。

快速开始

1. 安装 Browser Bridge 扩展

从 GitHub Releases 下载 opencli-extension.zip，在 chrome://extensions 开启开发者模式后 Load unpacked。

2. 安装 CLI

npm install -g @jackwener/opencli

3. 自检与试用

opencli doctor
opencli daemon status
opencli list
opencli hackernews top --limit 5
opencli bilibili hot --limit 5

说明：hackernews 等可走公开 API；需要登录态的站点需先在 Chrome/Chromium 中登录对应网站（见 README 前置说明）。

4.（可选）为 AI 安装 Skills

npx skills add jackwener/opencli
# 或按需安装 opencli-usage、opencli-operate、opencli-explorer、opencli-oneshot

核心特性

CLI All Electron：将部分 Electron 应用暴露为可脚本化命令（详见 docs/adapters/desktop/）。
Browser Automation（operate）：面向 Agent 的浏览器操控能力，与 opencli-operate Skill 配套。
Website → CLI：大量预置适配器 + explore / synthesize / generate 等生成与注册流程。
账号与风控：复用真实浏览器登录；README 宣称多层反自动化指纹处理（webdriver、chrome 对象等），以降低被站点风控的概率（效果因站点策略而异）。
CLI Hub 与 register：opencli register mycli 将自有 CLI 纳入列表。
插件：opencli plugin install 等子命令管理社区插件。
多格式输出：table（默认）、json、yaml、md、csv。
Self-healing：opencli doctor 诊断扩展、守护进程与连接。
运行时零 LLM 费用：README 强调常规命令运行不消耗大模型 Token（与「生成适配器时是否调用模型」需区分阅读文档）。

项目优势

对比项	OpenCLI	单一站点爬虫脚本	纯 Playwright 自写
统一入口与发现	✅ `opencli list` + Hub	❌ 各写各的	⚠️ 需自建规范
登录态	✅ 复用用户浏览器	⚠️ 常要单独处理 Cookie	⚠️ 需自行维护会话
AI 集成	✅ Skills + operate 工作流	❌ 通常无	⚠️ 需自建
输出规范	✅ 多格式 + 退出码约定	⚠️ 视项目而定	⚠️ 视项目而定
学习成本	⚠️ 需装扩展与理解概念	✅ 单点脚本简单	❌ 工程量大