@jackwener/opencli 0.9.6 → 1.0.0

package/src/clis/notion/favorites.ts

@@ -0,0 +1,87 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const favoritesCommand = cli({
+  site: 'notion',
+  name: 'favorites',
+  description: 'List pages from the Notion Favorites section in the sidebar',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [],
+  columns: ['Index', 'Title', 'Icon'],
+  func: async (page: IPage) => {
+    const items = await page.evaluate(`
+      (function() {
+        const results = [];
+
+        // Strategy 1: Use Notion's own class 'notion-outliner-bookmarks-header-container'
+        const headerContainer = document.querySelector('.notion-outliner-bookmarks-header-container');
+        if (headerContainer) {
+          // Walk up to the section parent that wraps header + items
+          let section = headerContainer.parentElement;
+          if (section && section.children.length === 1) section = section.parentElement;
+
+          if (section) {
+            const treeItems = section.querySelectorAll('[role="treeitem"]');
+            treeItems.forEach((item) => {
+              // Title text is in a div.notranslate sibling of the icon area
+              const titleEl = item.querySelector('div.notranslate:not(.notion-record-icon)');
+              const title = titleEl
+                ? titleEl.textContent.trim()
+                : (item.textContent || '').trim().substring(0, 80);
+
+              // Icon/emoji is in the notion-record-icon element
+              const iconEl = item.querySelector('.notion-record-icon');
+              const icon = iconEl ? iconEl.textContent.trim().substring(0, 4) : '';
+
+              if (title && title.length > 0) {
+                results.push({ Index: results.length + 1, Title: title, Icon: icon || '📄' });
+              }
+            });
+          }
+        }
+
+        // Strategy 2: Fallback — find "Favorites" text node and walk DOM
+        if (results.length === 0) {
+          const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT, null);
+          let node;
+          let favEl = null;
+          while (node = walker.nextNode()) {
+            const text = node.textContent.trim();
+            if (text === 'Favorites' || text === '收藏' || text === '收藏夹') {
+              favEl = node.parentElement;
+              break;
+            }
+          }
+
+          if (favEl) {
+            let section = favEl;
+            for (let i = 0; i < 6; i++) {
+              const p = section.parentElement;
+              if (!p || p === document.body) break;
+              const treeItems = p.querySelectorAll(':scope > [role="treeitem"]');
+              if (treeItems.length > 0) { section = p; break; }
+              section = p;
+            }
+
+            const treeItems = section.querySelectorAll('[role="treeitem"]');
+            treeItems.forEach((item) => {
+              const text = (item.textContent || '').trim().substring(0, 120);
+              if (text && text.length > 1 && !text.match(/^(Favorites|收藏夹?)$/)) {
+                results.push({ Index: results.length + 1, Title: text, Icon: '📄' });
+              }
+            });
+          }
+        }
+
+        return results;
+      })()
+    `);
+
+    if (items.length === 0) {
+      return [{ Index: 0, Title: 'No favorites found. Make sure sidebar is visible and you have favorites.', Icon: '⚠️' }];
+    }
+    return items;
+  },
+});

package/src/clis/notion/new.ts

@@ -0,0 +1,39 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const newCommand = cli({
+  site: 'notion',
+  name: 'new',
+  description: 'Create a new page in Notion',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [
+    { name: 'title', required: false, positional: true, help: 'Page title (optional)' },
+  ],
+  columns: ['Status'],
+  func: async (page: IPage, kwargs: any) => {
+    const title = kwargs.title as string | undefined;
+
+    // Cmd+N creates a new page in Notion
+    const isMac = process.platform === 'darwin';
+    await page.pressKey(isMac ? 'Meta+N' : 'Control+N');
+    await page.wait(1);
+
+    // If title is provided, type it into the title field
+    if (title) {
+      await page.evaluate(`
+        (function(t) {
+          const titleEl = document.querySelector('[placeholder="Untitled"], [data-content-editable-leaf] [placeholder]');
+          if (titleEl) {
+            titleEl.focus();
+            document.execCommand('insertText', false, t);
+          }
+        })(${JSON.stringify(title)})
+      `);
+      await page.wait(0.5);
+    }
+
+    return [{ Status: title ? `Created page: ${title}` : 'New blank page created' }];
+  },
+});

package/src/clis/notion/read.ts

@@ -0,0 +1,33 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const readCommand = cli({
+  site: 'notion',
+  name: 'read',
+  description: 'Read the content of the currently open Notion page',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [],
+  columns: ['Title', 'Content'],
+  func: async (page: IPage) => {
+    const result = await page.evaluate(`
+      (function() {
+        // Get the page title
+        const titleEl = document.querySelector('[data-block-id] [placeholder="Untitled"], .notion-page-block .notranslate, h1.notion-title, [class*="title"]');
+        const title = titleEl ? (titleEl.textContent || '').trim() : document.title;
+        
+        // Get the page content — Notion renders blocks in a frame
+        const frame = document.querySelector('.notion-page-content, [class*="page-content"], .layout-content, main');
+        const content = frame ? (frame.innerText || frame.textContent || '').trim() : '';
+        
+        return { title, content };
+      })()
+    `);
+
+    return [{
+      Title: result.title || 'Untitled',
+      Content: result.content || '(empty page)',
+    }];
+  },
+});

package/src/clis/notion/search.ts

@@ -0,0 +1,54 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const searchCommand = cli({
+  site: 'notion',
+  name: 'search',
+  description: 'Search pages and databases in Notion via Quick Find (Cmd+P)',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [{ name: 'query', required: true, positional: true, help: 'Search query' }],
+  columns: ['Index', 'Title'],
+  func: async (page: IPage, kwargs: any) => {
+    const query = kwargs.query as string;
+
+    // Open Quick Find
+    const isMac = process.platform === 'darwin';
+    await page.pressKey(isMac ? 'Meta+P' : 'Control+P');
+    await page.wait(0.5);
+
+    // Type the search query
+    await page.evaluate(`
+      (function(q) {
+        const input = document.querySelector('input[placeholder*="Search"], input[type="text"]');
+        if (input) {
+          const setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value').set;
+          setter.call(input, q);
+          input.dispatchEvent(new Event('input', { bubbles: true }));
+        }
+      })(${JSON.stringify(query)})
+    `);
+
+    await page.wait(1.5);
+
+    // Scrape results
+    const results = await page.evaluate(`
+      (function() {
+        const items = document.querySelectorAll('[role="option"], [class*="searchResult"], [class*="quick-find"] [role="button"]');
+        return Array.from(items).slice(0, 20).map((item, i) => ({
+          Index: i + 1,
+          Title: (item.textContent || '').trim().substring(0, 120),
+        }));
+      })()
+    `);
+
+    // Close Quick Find
+    await page.pressKey('Escape');
+
+    if (results.length === 0) {
+      return [{ Index: 0, Title: `No results for "${query}"` }];
+    }
+    return results;
+  },
+});

package/src/clis/notion/sidebar.ts

@@ -0,0 +1,44 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const sidebarCommand = cli({
+  site: 'notion',
+  name: 'sidebar',
+  description: 'List pages and databases from the Notion sidebar',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [],
+  columns: ['Index', 'Title'],
+  func: async (page: IPage) => {
+    const items = await page.evaluate(`
+      (function() {
+        const results = [];
+        // Notion sidebar items
+        const selectors = [
+          '[class*="sidebar"] [role="treeitem"]',
+          '[class*="sidebar"] a',
+          '.notion-sidebar [role="button"]',
+          'nav [role="treeitem"]',
+        ];
+        
+        for (const sel of selectors) {
+          const nodes = document.querySelectorAll(sel);
+          if (nodes.length > 0) {
+            nodes.forEach((n, i) => {
+              const text = (n.textContent || '').trim().substring(0, 100);
+              if (text && text.length > 1) results.push({ Index: i + 1, Title: text });
+            });
+            break;
+          }
+        }
+        return results;
+      })()
+    `);
+
+    if (items.length === 0) {
+      return [{ Index: 0, Title: 'No sidebar items found. Toggle the sidebar first.' }];
+    }
+    return items;
+  },
+});

package/src/clis/notion/status.ts

@@ -0,0 +1,18 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const statusCommand = cli({
+  site: 'notion',
+  name: 'status',
+  description: 'Check active CDP connection to Notion Desktop',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [],
+  columns: ['Status', 'Url', 'Title'],
+  func: async (page: IPage) => {
+    const url = await page.evaluate('window.location.href');
+    const title = await page.evaluate('document.title');
+    return [{ Status: 'Connected', Url: url, Title: title }];
+  },
+});

package/src/clis/notion/write.ts

@@ -0,0 +1,45 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const writeCommand = cli({
+  site: 'notion',
+  name: 'write',
+  description: 'Append text content to the currently open Notion page',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [{ name: 'text', required: true, positional: true, help: 'Text to append to the page' }],
+  columns: ['Status'],
+  func: async (page: IPage, kwargs: any) => {
+    const text = kwargs.text as string;
+
+    // Focus the page body and move to the end
+    await page.evaluate(`
+      (function(text) {
+        // Find the editable area in Notion
+        const editables = document.querySelectorAll('.notion-page-content [contenteditable="true"], [class*="page-content"] [contenteditable="true"]');
+        let target = editables.length > 0 ? editables[editables.length - 1] : null;
+        
+        if (!target) {
+          // Fallback: just find any contenteditable
+          const all = document.querySelectorAll('[contenteditable="true"]');
+          target = all.length > 0 ? all[all.length - 1] : null;
+        }
+        
+        if (!target) throw new Error('Could not find editable area in Notion page');
+        
+        target.focus();
+        // Move to end
+        const sel = window.getSelection();
+        sel.selectAllChildren(target);
+        sel.collapseToEnd();
+        
+        document.execCommand('insertText', false, text);
+      })(${JSON.stringify(text)})
+    `);
+
+    await page.wait(0.5);
+
+    return [{ Status: 'Text appended successfully' }];
+  },
+});

package/src/clis/twitter/download.ts

@@ -0,0 +1,227 @@
+/**
+ * Twitter/X download — download images and videos from tweets.
+ *
+ * Usage:
+ *   opencli twitter download --username elonmusk --limit 10 --output ./twitter
+ *   opencli twitter download --tweet-url https://x.com/xxx/status/123 --output ./twitter
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { cli, Strategy } from '../../registry.js';
+import {
+  httpDownload,
+  ytdlpDownload,
+  checkYtdlp,
+  sanitizeFilename,
+  getTempDir,
+  exportCookiesToNetscape,
+} from '../../download/index.js';
+import { DownloadProgressTracker, formatBytes } from '../../download/progress.js';
+
+cli({
+  site: 'twitter',
+  name: 'download',
+  description: '下载 Twitter/X 媒体（图片和视频）',
+  domain: 'x.com',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'username', help: 'Twitter username (downloads from media tab)' },
+    { name: 'tweet-url', help: 'Single tweet URL to download' },
+    { name: 'limit', type: 'int', default: 10, help: 'Number of tweets to scan' },
+    { name: 'output', default: './twitter-downloads', help: 'Output directory' },
+  ],
+  columns: ['index', 'type', 'status', 'size'],
+  func: async (page, kwargs) => {
+    const username = kwargs.username;
+    const tweetUrl = kwargs['tweet-url'];
+    const limit = kwargs.limit;
+    const output = kwargs.output;
+
+    if (!username && !tweetUrl) {
+      return [{
+        index: 0,
+        type: '-',
+        status: 'failed',
+        size: 'Must provide --username or --tweet-url',
+      }];
+    }
+
+    // Navigate to the appropriate page
+    if (tweetUrl) {
+      await page.goto(tweetUrl);
+    } else {
+      await page.goto(`https://x.com/${username}/media`);
+    }
+    await page.wait(3);
+
+    // Scroll to load more content
+    if (!tweetUrl) {
+      await page.autoScroll({ times: Math.ceil(limit / 5) });
+    }
+
+    // Extract media URLs
+    const data = await page.evaluate(`
+      (() => {
+        const media = [];
+
+        // Find images (high quality)
+        document.querySelectorAll('img[src*="pbs.twimg.com/media"]').forEach(img => {
+          let src = img.src || '';
+          // Get large version
+          src = src.replace(/&name=\\w+$/, '&name=large');
+          src = src.replace(/\\?format=/, '?format=');
+          if (!src.includes('&name=')) {
+            src = src + '&name=large';
+          }
+          media.push({ type: 'image', url: src });
+        });
+
+        // Find videos
+        document.querySelectorAll('video').forEach(video => {
+          const src = video.src || '';
+          if (src) {
+            media.push({ type: 'video', url: src, poster: video.poster || '' });
+          }
+        });
+
+        // Find video tweets (for yt-dlp)
+        document.querySelectorAll('[data-testid="videoPlayer"]').forEach(player => {
+          const tweetLink = player.closest('article')?.querySelector('a[href*="/status/"]');
+          const href = tweetLink?.getAttribute('href') || '';
+          if (href) {
+            const tweetUrl = 'https://x.com' + href;
+            media.push({ type: 'video-tweet', url: tweetUrl });
+          }
+        });
+
+        return media;
+      })()
+    `);
+
+    if (!data || data.length === 0) {
+      return [{
+        index: 0,
+        type: '-',
+        status: 'failed',
+        size: 'No media found',
+      }];
+    }
+
+    // Extract cookies
+    const cookieString = await page.evaluate(`(() => document.cookie)()`);
+
+    // Create output directory
+    const outputDir = tweetUrl
+      ? path.join(output, 'tweets')
+      : path.join(output, username || 'media');
+    fs.mkdirSync(outputDir, { recursive: true });
+
+    // Export cookies for yt-dlp
+    let cookiesFile: string | undefined;
+    if (typeof cookieString === 'string' && cookieString) {
+      const tempDir = getTempDir();
+      fs.mkdirSync(tempDir, { recursive: true });
+      cookiesFile = path.join(tempDir, `twitter_cookies_${Date.now()}.txt`);
+
+      const cookies = cookieString.split(';').map((c) => {
+        const [name, ...rest] = c.trim().split('=');
+        return {
+          name: name || '',
+          value: rest.join('=') || '',
+          domain: '.x.com',
+          path: '/',
+          secure: true,
+          httpOnly: false,
+        };
+      }).filter((c) => c.name);
+
+      exportCookiesToNetscape(cookies, cookiesFile);
+    }
+
+    // Deduplicate media
+    const seen = new Set<string>();
+    const uniqueMedia = data.filter((m: any) => {
+      if (seen.has(m.url)) return false;
+      seen.add(m.url);
+      return true;
+    }).slice(0, limit);
+
+    const tracker = new DownloadProgressTracker(uniqueMedia.length, true);
+    const results: any[] = [];
+
+    for (let i = 0; i < uniqueMedia.length; i++) {
+      const media = uniqueMedia[i];
+      const ext = media.type === 'image' ? 'jpg' : 'mp4';
+      const filename = `${username || 'tweet'}_${i + 1}.${ext}`;
+      const destPath = path.join(outputDir, filename);
+
+      const progressBar = tracker.onFileStart(filename, i);
+
+      try {
+        let result: { success: boolean; size: number; error?: string };
+
+        if (media.type === 'video-tweet' && checkYtdlp()) {
+          // Use yt-dlp for video tweets
+          result = await ytdlpDownload(media.url, destPath, {
+            cookiesFile,
+            extraArgs: ['--merge-output-format', 'mp4'],
+            onProgress: (percent) => {
+              if (progressBar) progressBar.update(percent, 100);
+            },
+          });
+        } else if (media.type === 'image') {
+          // Direct HTTP download for images
+          result = await httpDownload(media.url, destPath, {
+            cookies: typeof cookieString === 'string' ? cookieString : '',
+            timeout: 30000,
+            onProgress: (received, total) => {
+              if (progressBar) progressBar.update(received, total);
+            },
+          });
+        } else {
+          // Direct HTTP download for direct video URLs
+          result = await httpDownload(media.url, destPath, {
+            cookies: typeof cookieString === 'string' ? cookieString : '',
+            timeout: 60000,
+            onProgress: (received, total) => {
+              if (progressBar) progressBar.update(received, total);
+            },
+          });
+        }
+
+        if (progressBar) {
+          progressBar.complete(result.success, result.success ? formatBytes(result.size) : undefined);
+        }
+
+        tracker.onFileComplete(result.success);
+
+        results.push({
+          index: i + 1,
+          type: media.type === 'video-tweet' ? 'video' : media.type,
+          status: result.success ? 'success' : 'failed',
+          size: result.success ? formatBytes(result.size) : (result.error || 'unknown error'),
+        });
+      } catch (err: any) {
+        if (progressBar) progressBar.fail(err.message);
+        tracker.onFileComplete(false);
+
+        results.push({
+          index: i + 1,
+          type: media.type,
+          status: 'failed',
+          size: err.message,
+        });
+      }
+    }
+
+    tracker.finish();
+
+    // Cleanup cookies file
+    if (cookiesFile && fs.existsSync(cookiesFile)) {
+      fs.unlinkSync(cookiesFile);
+    }
+
+    return results;
+  },
+});

package/src/clis/wechat/README.md

@@ -0,0 +1,28 @@
+# WeChat (微信) Desktop 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

package/src/clis/wechat/README.zh-CN.md

@@ -0,0 +1,28 @@
+# 微信桌面端适配器
+
+通过 AppleScript + Accessibility API 在终端中控制**微信 Mac 桌面端**。
+
+> **注意：** 微信是原生 macOS 应用（非 Electron），因此无法使用 CDP。此适配器使用 AppleScript 键盘模拟和剪贴板操作。
+
+## 前置条件
+
+1. 微信必须正在运行且已登录
+2. Terminal 需要 **辅助功能权限**（系统设置 → 隐私与安全性 → 辅助功能）
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `wechat status` | 检查微信是否在运行 |
+| `wechat send "消息"` | 发送消息（剪贴板粘贴 + 回车） |
+| `wechat read` | 读取当前聊天内容（Cmd+A → Cmd+C） |
+| `wechat search "关键词"` | 打开搜索并输入关键词（Cmd+F） |
+| `wechat chats` | 切换到聊天列表（Cmd+1） |
+| `wechat contacts` | 切换到通讯录（Cmd+2） |
+
+## 限制
+
+- **不支持 CDP** — 微信是原生 Cocoa 应用
+- `send` 需要先手动打开正确的会话
+- `read` 通过全选+复制来获取可见内容
+- `search` 可以输入关键词但无法自动点击结果

package/src/clis/wechat/chats.ts

@@ -0,0 +1,33 @@
+import { execSync } from 'node:child_process';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const chatsCommand = cli({
+  site: 'wechat',
+  name: 'chats',
+  description: 'Open the WeChat chats panel (conversation list)',
+  domain: 'localhost',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [],
+  columns: ['Status'],
+  func: async (page: IPage | null) => {
+    try {
+      // Activate WeChat
+      execSync("osascript -e 'tell application \"WeChat\" to activate'");
+      execSync("osascript -e 'delay 0.3'");
+
+      // Cmd+1 switches to Chats tab in WeChat Mac
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'keystroke \"1\" using command down' " +
+        "-e 'end tell'"
+      );
+
+      return [{ Status: 'Chats panel opened (Cmd+1)' }];
+    } catch (err: any) {
+      return [{ Status: 'Error: ' + err.message }];
+    }
+  },
+});

package/src/clis/wechat/contacts.ts

@@ -0,0 +1,33 @@
+import { execSync } from 'node:child_process';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const contactsCommand = cli({
+  site: 'wechat',
+  name: 'contacts',
+  description: 'Open the WeChat contacts panel',
+  domain: 'localhost',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [],
+  columns: ['Status'],
+  func: async (page: IPage | null) => {
+    try {
+      // Activate WeChat
+      execSync("osascript -e 'tell application \"WeChat\" to activate'");
+      execSync("osascript -e 'delay 0.3'");
+
+      // Cmd+2 switches to Contacts tab in WeChat Mac
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'keystroke \"2\" using command down' " +
+        "-e 'end tell'"
+      );
+
+      return [{ Status: 'Contacts panel opened (Cmd+2)' }];
+    } catch (err: any) {
+      return [{ Status: 'Error: ' + err.message }];
+    }
+  },
+});