@jackwener/opencli 1.0.5 → 1.1.0

package/src/clis/chatgpt/README.md

@@ -1,44 +1,5 @@
-# ChatGPT Desktop Adapter for OpenCLI
+# ChatGPT Adapter
 
-Control the **ChatGPT macOS Desktop App** directly from the terminal. OpenCLI supports two automation approaches for ChatGPT.
+Control the **ChatGPT macOS Desktop App** from the terminal via AppleScript or CDP.
 
-## Approach 1: AppleScript (Default, No Setup)
-
-The current built-in commands use native AppleScript automation — no extra launch flags needed.
-
-### Prerequisites
-1. Install the official [ChatGPT Desktop App](https://openai.com/chatgpt/mac/) from OpenAI.
-2. Grant **Accessibility permissions** to your terminal app (Terminal / iTerm / Warp) in **System Settings → Privacy & Security → Accessibility**. This is required for System Events keystroke simulation.
-
-### Commands
-- `opencli chatgpt status`: Check if the ChatGPT app is currently running.
-- `opencli chatgpt new`: Activate ChatGPT and press `Cmd+N` to start a new conversation.
-- `opencli chatgpt send "message"`: Copy your message to clipboard, activate ChatGPT, paste, and submit.
-- `opencli chatgpt read`: Copy the last AI response via `Cmd+Shift+C` and return it as text.
-
-## Approach 2: CDP (Advanced, Electron Debug Mode)
-
-ChatGPT Desktop is also an Electron app and can be launched with a remote debugging port for deeper automation via CDP:
-
-```bash
-/Applications/ChatGPT.app/Contents/MacOS/ChatGPT \
-  --remote-debugging-port=9224
-```
-
-Then set the endpoint:
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9224"
-```
-
-> **Note**: The CDP approach enables future advanced commands like DOM inspection, model switching, and code extraction — similar to the Cursor and Codex adapters.
-
-## How It Works
-
-- **AppleScript mode**: Uses `osascript` and `pbcopy`/`pbpaste` for clipboard-based text transfer. No remote debugging port needed.
-- **CDP mode**: Connects via Chrome DevTools Protocol to the Electron renderer process for direct DOM manipulation.
-
-## Limitations
-
-- macOS only (AppleScript dependency)
-- AppleScript mode requires Accessibility permissions
-- `read` command copies the last response — earlier messages need manual scroll
+📖 **Full documentation**: [docs/adapters/desktop/chatgpt](../../../docs/adapters/desktop/chatgpt.md)

package/src/clis/chatwise/README.md

@@ -1,38 +1,5 @@
-# ChatWise Adapter for OpenCLI
+# ChatWise Adapter
 
-Control the **ChatWise Desktop App** from the terminal via Chrome DevTools Protocol (CDP). ChatWise is an Electron-based multi-LLM client supporting GPT-4, Claude, Gemini, and more.
+Control the **ChatWise Desktop App** (multi-LLM client) from the terminal via CDP.
 
-## Prerequisites
-
-1. Install [ChatWise](https://chatwise.app/).
-2. Launch with remote debugging port:
-   ```bash
-   /Applications/ChatWise.app/Contents/MacOS/ChatWise \
-     --remote-debugging-port=9228
-   ```
-
-## Setup
-
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9228"
-```
-
-## Commands
-
-### Diagnostics
-- `opencli chatwise status`: Check CDP connection status.
-- `opencli chatwise screenshot`: Export DOM + accessibility snapshot.
-
-### Chat
-- `opencli chatwise new`: Start a new conversation (`Cmd+N`).
-- `opencli chatwise send "message"`: Send a message to the active chat.
-- `opencli chatwise read`: Read the current conversation.
-- `opencli chatwise ask "prompt"`: Send + wait for response + return it (one-shot).
-
-### AI Features
-- `opencli chatwise model`: Get the current AI model.
-- `opencli chatwise model gpt-4`: Switch to a different model.
-
-### Organization
-- `opencli chatwise history`: List conversations from the sidebar.
-- `opencli chatwise export`: Export conversation as Markdown.
+📖 **Full documentation**: [docs/adapters/desktop/chatwise](../../../docs/adapters/desktop/chatwise.md)

package/src/clis/codex/README.md

@@ -1,34 +1,5 @@
-# OpenAI Codex Adapter for OpenCLI
+# Codex Adapter
 
-Control the **OpenAI Codex Desktop App** headless or headfully via Chrome DevTools Protocol (CDP).
-Because Codex is built on Electron, OpenCLI can directly drive its internal UI, automate slash commands, and manipulate its AI agent threads.
+Control the **OpenAI Codex Desktop App** via Chrome DevTools Protocol (CDP).
 
-## Prerequisites
-
-1. You must have the official OpenAI Codex app installed.
-2. Launch it via the terminal and expose the remote debugging port:
-   ```bash
-   # macOS 
-   /Applications/Codex.app/Contents/MacOS/Codex --remote-debugging-port=9222
-   ```
-
-## Setup
-
-Export the CDP endpoint in your shell:
-```bash
-export OPENCLI_CODEX_CDP_ENDPOINT="http://127.0.0.1:9222"
-```
-
-## Commands
-
-### Diagnostics
-- `opencli codex status`: Checks connection and reads the current active window URL/title.
-- `opencli codex dump`: Dumps the full UI DOM and Accessibility tree into `/tmp` (ideal for building AI automation tools on top of it).
-
-### Agent Manipulation
-- `opencli codex new`: Simulates `Cmd+N` to start a completely fresh and isolated Git Worktree thread context.
-- `opencli codex send "message"`: Robustly finds the active Thread Composer and injects your text.
-  - *Pro-tip*: You can trigger internal shortcuts by sending them, e.g., `opencli codex send "/review"` or `opencli codex send "$imagegen draw a cat"`.
-- `opencli codex read`: Extracts the entire current thread history and AI reasoning logs into readable text.
-- `opencli codex extract-diff`: Automatically scrapes any visual Patch chunks and Code Diffs the AI generated inside the review UI.
-- `opencli codex model`: Get the currently active AI model.
+📖 **Full documentation**: [docs/adapters/desktop/codex](../../../docs/adapters/desktop/codex.md)

package/src/clis/cursor/README.md

@@ -1,33 +1,5 @@
-# Cursor Adapter for OpenCLI
+# Cursor Adapter
 
-Control the **Cursor IDE** from the terminal via Chrome DevTools Protocol (CDP). Since Cursor is built on Electron (VS Code fork), OpenCLI can drive its internal UI, automate Composer interactions, and manipulate chat sessions.
+Control the **Cursor IDE** from the terminal via Chrome DevTools Protocol (CDP).
 
-## Prerequisites
-
-1. Install [Cursor](https://cursor.sh/).
-2. Launch it with the remote debugging port:
-   ```bash
-   /Applications/Cursor.app/Contents/MacOS/Cursor --remote-debugging-port=9226
-   ```
-
-## Setup
-
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9226"
-```
-
-## Commands
-
-### Diagnostics
-- `opencli cursor status`: Check CDP connection status.
-- `opencli cursor dump`: Dump the full DOM and Accessibility snapshot to `/tmp/cursor-dom.html` and `/tmp/cursor-snapshot.json`.
-
-### Chat Manipulation
-- `opencli cursor new`: Press `Cmd+N` to start a new file/tab.
-- `opencli cursor send "message"`: Inject text into the active Composer/Chat input and submit.
-- `opencli cursor read`: Extract the full conversation history from the active chat panel.
-
-### AI Features
-- `opencli cursor composer "prompt"`: Open the Composer panel (`Cmd+I`) and send a prompt for inline AI editing.
-- `opencli cursor model`: Get the currently active AI model (e.g., `claude-4.5-sonnet`).
-- `opencli cursor extract-code`: Extract all code blocks from the current conversation.
+📖 **Full documentation**: [docs/adapters/desktop/cursor](../../../docs/adapters/desktop/cursor.md)

package/src/clis/discord-app/README.md

@@ -1,28 +1,5 @@
-# Discord Desktop Adapter
+# Discord Adapter
 
 Control the **Discord Desktop App** from the terminal via Chrome DevTools Protocol (CDP).
 
-## Prerequisites
-
-Launch with remote debugging port:
-```bash
-/Applications/Discord.app/Contents/MacOS/Discord --remote-debugging-port=9232
-```
-
-## Setup
-
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9232"
-```
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `discord status` | Check CDP connection |
-| `discord send "message"` | Send a message in the active channel |
-| `discord read` | Read recent messages |
-| `discord channels` | List channels in the current server |
-| `discord servers` | List all joined servers |
-| `discord search "query"` | Search messages (Cmd+F) |
-| `discord members` | List online members |
+📖 **Full documentation**: [docs/adapters/desktop/discord](../../../docs/adapters/desktop/discord.md)

package/src/clis/feishu/README.md

@@ -1,20 +1,5 @@
-# Feishu (飞书/Lark) Desktop Adapter
+# Feishu (飞书/Lark) Adapter
 
 Control **Feishu/Lark Desktop** from the terminal via AppleScript.
 
-> **Note:** Feishu uses a custom `Lark Framework` (Chromium-based but NOT Electron). CDP is not available, so this adapter uses AppleScript + clipboard.
-
-## Prerequisites
-
-1. Feishu/Lark must be running and logged in
-2. Terminal must have **Accessibility permission**
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `feishu status` | Check if Feishu/Lark is running |
-| `feishu send "msg"` | Send message in active chat (paste + Enter) |
-| `feishu read` | Read current chat (Cmd+A → Cmd+C) |
-| `feishu search "query"` | Global search (Cmd+K) |
-| `feishu new` | New message/document (Cmd+N) |
+📖 **Full documentation**: [docs/adapters/desktop/feishu](../../../docs/adapters/desktop/feishu.md)

package/src/clis/neteasemusic/README.md

@@ -1,31 +1,5 @@
-# NeteaseMusic Desktop Adapter (网易云音乐)
+# NeteaseMusic (网易云音乐) Adapter
 
-Control **NeteaseMusic** (网易云音乐) from the terminal via Chrome DevTools Protocol (CDP). The app uses Chromium Embedded Framework (CEF).
+Control **NeteaseMusic** from the terminal via Chrome DevTools Protocol (CDP/CEF).
 
-## Prerequisites
-
-Launch with remote debugging port:
-```bash
-/Applications/NeteaseMusic.app/Contents/MacOS/NeteaseMusic --remote-debugging-port=9234
-```
-
-## Setup
-
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9234"
-```
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `neteasemusic status` | Check CDP connection |
-| `neteasemusic playing` | Current song info (title, artist, album) |
-| `neteasemusic play` | Play / Pause toggle |
-| `neteasemusic next` | Skip to next song |
-| `neteasemusic prev` | Go to previous song |
-| `neteasemusic search "query"` | Search songs, artists |
-| `neteasemusic playlist` | Show current playback queue |
-| `neteasemusic like` | Like / unlike current song |
-| `neteasemusic lyrics` | Get lyrics of current song |
-| `neteasemusic volume [0-100]` | Get or set volume |
+📖 **Full documentation**: [docs/adapters/desktop/neteasemusic](../../../docs/adapters/desktop/neteasemusic.md)

package/src/clis/notion/README.md

@@ -1,29 +1,5 @@
-# Notion Desktop Adapter
+# Notion Adapter
 
 Control the **Notion Desktop App** from the terminal via Chrome DevTools Protocol (CDP).
 
-## Prerequisites
-
-Launch with remote debugging port:
-```bash
-/Applications/Notion.app/Contents/MacOS/Notion --remote-debugging-port=9230
-```
-
-## Setup
-
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9230"
-```
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `notion status` | Check CDP connection |
-| `notion search "query"` | Quick Find search (Cmd+P) |
-| `notion read` | Read the current page content |
-| `notion new "title"` | Create a new page (Cmd+N) |
-| `notion write "text"` | Append text to the current page |
-| `notion sidebar` | List pages from the sidebar |
-| `notion favorites` | List pages from the Favorites section |
-| `notion export` | Export page as Markdown |
+📖 **Full documentation**: [docs/adapters/desktop/notion](../../../docs/adapters/desktop/notion.md)

package/src/clis/sinafinance/news.ts

@@ -0,0 +1,76 @@
+/**
+ * Sina Finance 7x24 live news feed.
+ *
+ * Uses the public CJ API — no key or browser required.
+ * https://app.cj.sina.com.cn/api/news/pc
+ */
+
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+
+// User-facing type (0-9) → Sina API tag ID
+const TYPE_MAP = [
+  0,   // 0: 全部
+  10,  // 1: A股
+  1,   // 2: 宏观
+  3,   // 3: 公司
+  4,   // 4: 数据
+  5,   // 5: 市场
+  102, // 6: 国际
+  6,   // 7: 观点
+  6,   // 8: 央行
+  8,   // 9: 其它
+] as const;
+
+interface SinaNewsItem {
+  id?: string;
+  create_time?: string;
+  rich_text?: string;
+  view_num?: number;
+}
+
+function stripHtml(html: string): string {
+  return html.replace(/<[^>]+>/g, '').trim();
+}
+
+cli({
+  site: 'sinafinance',
+  name: 'news',
+  description: '新浪财经 7x24 小时实时快讯',
+  domain: 'app.cj.sina.com.cn',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: 'Max results (max 50)' },
+    { name: 'type', type: 'int', default: 0, help: 'News type: 0=全部 1=A股 2=宏观 3=公司 4=数据 5=市场 6=国际 7=观点 8=央行 9=其它' },
+  ],
+  columns: ['id', 'time', 'content', 'views'],
+  func: async (_page, args) => {
+    const limit = Math.max(1, Math.min(Number(args.limit), 50));
+    const apiTag = TYPE_MAP[args.type as number] ?? 0;
+
+    const params = new URLSearchParams({
+      page: '1',
+      size: String(limit),
+      tag: String(apiTag),
+    });
+
+    const res = await fetch(`https://app.cj.sina.com.cn/api/news/pc?${params}`);
+    if (!res.ok) {
+      throw new CliError('FETCH_ERROR', `Sina Finance API HTTP ${res.status}`, 'Check your network connection');
+    }
+    const json = await res.json() as { result?: { data?: { feed?: { list?: SinaNewsItem[] } } } };
+    const list = json?.result?.data?.feed?.list ?? [];
+
+    if (!list.length) {
+      throw new CliError('NOT_FOUND', 'No news found', 'Try a different type or increase limit');
+    }
+
+    return list.map((item) => ({
+      id: item.id ?? '',
+      time: item.create_time ?? '',
+      content: stripHtml(item.rich_text ?? ''),
+      views: item.view_num ?? 0,
+    }));
+  },
+});

package/src/clis/wechat/README.md

@@ -1,28 +1,5 @@
-# WeChat (微信) Desktop Adapter
+# WeChat (微信) Adapter
 
 Control **WeChat Mac Desktop** from the terminal via AppleScript + Accessibility API.
 
-> **Note:** WeChat is a native macOS app (not Electron), so CDP is not available. This adapter uses AppleScript keyboard simulation and clipboard operations.
-
-## Prerequisites
-
-1. WeChat must be running and logged in
-2. Terminal must have **Accessibility permission** (System Settings → Privacy & Security → Accessibility)
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `wechat status` | Check if WeChat is running |
-| `wechat send "msg"` | Send message in the active chat (clipboard paste + Enter) |
-| `wechat read` | Read current chat content (Cmd+A → Cmd+C) |
-| `wechat search "keyword"` | Open search and type a query (Cmd+F) |
-| `wechat chats` | Switch to Chats tab (Cmd+1) |
-| `wechat contacts` | Switch to Contacts tab (Cmd+2) |
-
-## Limitations
-
-- **No CDP support** — WeChat is native Cocoa, not Electron
-- `send` requires the correct conversation to be already open
-- `read` captures whatever is visible via select-all + copy
-- `search` types the query but cannot programmatically click results
+📖 **Full documentation**: [docs/adapters/desktop/wechat](../../../docs/adapters/desktop/wechat.md)

package/src/clis/wikipedia/search.ts

@@ -0,0 +1,32 @@
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+import { wikiFetch } from './utils.js';
+
+interface WikiSearchResult { title: string; snippet: string; }
+
+cli({
+  site: 'wikipedia',
+  name: 'search',
+  description: 'Search Wikipedia articles',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'keyword', positional: true, required: true, help: 'Search keyword' },
+    { name: 'limit', type: 'int', default: 10, help: 'Max results' },
+    { name: 'lang', default: 'en', help: 'Language code (e.g. en, zh, ja)' },
+  ],
+  columns: ['title', 'snippet', 'url'],
+  func: async (_page, args) => {
+    const limit = Math.max(1, Math.min(Number(args.limit), 50));
+    const lang = args.lang || 'en';
+    const q = encodeURIComponent(args.keyword);
+    const data = await wikiFetch(lang, `/w/api.php?action=query&list=search&srsearch=${q}&srlimit=${limit}&format=json&utf8=1`) as { query?: { search?: WikiSearchResult[] } };
+    const results = data?.query?.search;
+    if (!results?.length) throw new CliError('NOT_FOUND', 'No articles found', 'Try a different keyword');
+    return results.map((r) => ({
+      title: r.title,
+      snippet: r.snippet.replace(/<[^>]+>/g, '').slice(0, 120),
+      url: `https://${lang}.wikipedia.org/wiki/${encodeURIComponent(r.title.replace(/ /g, '_'))}`,
+    }));
+  },
+});

package/src/clis/wikipedia/summary.ts

@@ -0,0 +1,28 @@
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+import { wikiFetch } from './utils.js';
+
+cli({
+  site: 'wikipedia',
+  name: 'summary',
+  description: 'Get Wikipedia article summary',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'title', positional: true, required: true, help: 'Article title (e.g. "Transformer (machine learning model)")' },
+    { name: 'lang', default: 'en', help: 'Language code (e.g. en, zh, ja)' },
+  ],
+  columns: ['title', 'description', 'extract', 'url'],
+  func: async (_page, args) => {
+    const lang = args.lang || 'en';
+    const title = encodeURIComponent(args.title.replace(/ /g, '_'));
+    const data = await wikiFetch(lang, `/api/rest_v1/page/summary/${title}`) as { title?: string; description?: string; extract?: string; content_urls?: { desktop?: { page?: string } } };
+    if (!data?.title) throw new CliError('NOT_FOUND', `Article "${args.title}" not found`, 'Try searching first: opencli wikipedia search <keyword>');
+    return [{
+      title: data.title,
+      description: data.description ?? '-',
+      extract: (data.extract ?? '').slice(0, 300),
+      url: data.content_urls?.desktop?.page ?? `https://${lang}.wikipedia.org/wiki/${title}`,
+    }];
+  },
+});

package/src/clis/wikipedia/utils.ts

@@ -0,0 +1,20 @@
+/**
+ * Wikipedia adapter utilities.
+ *
+ * Uses the public MediaWiki REST API and Action API — no key required.
+ * REST API: https://en.wikipedia.org/api/rest_v1/
+ * Action API: https://en.wikipedia.org/w/api.php
+ */
+
+import { CliError } from '../../errors.js';
+
+export async function wikiFetch(lang: string, path: string): Promise<unknown> {
+  const url = `https://${lang}.wikipedia.org${path}`;
+  const resp = await fetch(url, {
+    headers: { 'User-Agent': 'opencli/1.0 (https://github.com/jackwener/opencli)' },
+  });
+  if (!resp.ok) {
+    throw new CliError('FETCH_ERROR', `Wikipedia API HTTP ${resp.status}`, `Check your title or search term`);
+  }
+  return resp.json();
+}