Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -22,3 +22,5 @@ docs/.vitepress/cache

# Database files
*.db
autoresearch/results/
extension/dist/
18 changes: 18 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,6 +84,24 @@ opencli hackernews top --limit 5 # Public API, no browser needed
opencli bilibili hot --limit 5 # Browser command (requires Extension)
```

### 4. Browser Automation — Make Websites Accessible for AI Agents

#### AI Agent Quickstart (1 step)

Point your AI agent (Claude Code, Cursor) to [`skills/opencli-operate/SKILL.md`](./skills/opencli-operate/SKILL.md). It has everything needed.

#### Human Quickstart (3 steps)

```bash
opencli operate open https://news.ycombinator.com # 1. Open a page
opencli operate state # 2. See interactive elements
opencli operate eval "document.title" # 3. Extract data
```

More commands: `click`, `type`, `select`, `keys`, `wait`, `get`, `screenshot`, `scroll`, `back`, `close`.

See [`skills/opencli-operate/SKILL.md`](./skills/opencli-operate/SKILL.md) for full documentation.

### Update

```bash
Expand Down
59 changes: 59 additions & 0 deletions SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
name: opencli
description: "OpenCLI — Make any website or Electron App your CLI. Zero risk, AI-powered, reuse Chrome login."
version: 1.5.6
author: jackwener
tags: [cli, browser, web, chrome-extension, cdp, AI, agent, operate]
---

# OpenCLI

> Make any website or Electron App your CLI. Reuse Chrome login, zero risk, AI-powered.

## Skills

OpenCLI has three specialized skills. Use the one that matches your task:

### 1. CLI Commands (`skills/cli/SKILL.md`)
Use existing CLI commands to fetch data, interact with websites and desktop apps.
```bash
opencli twitter trending --limit 10
opencli hackernews top --limit 5
opencli bilibili hot
```

### 2. Browser Automation (`skills/opencli-operate/SKILL.md`)
Make websites accessible for AI agents. Navigate, click, type, extract, wait — with existing Chrome login sessions. No LLM API key needed.
```bash
opencli operate open https://example.com
opencli operate state # See interactive elements with [N] indices
opencli operate click 3 # Click element [3]
opencli operate network # Discover APIs
opencli operate init site/cmd # Generate adapter scaffold
opencli operate verify site/cmd # Test the adapter
```

### 3. Adapter Development (`skills/adapter-dev/SKILL.md`)
Create new CLI commands from websites. Explore APIs, record traffic, write TypeScript adapters.
```bash
opencli explore https://example.com
opencli record https://example.com
opencli generate https://example.com --goal "hot"
```

## Quick Setup

```bash
npm install -g @jackwener/opencli
opencli doctor # Verify Chrome extension + daemon
```

## Configuration

```bash
# For AI agent (opencli operate)
export OPENCLI_PROVIDER=anthropic # or openai
export OPENCLI_MODEL=sonnet # model alias
export OPENCLI_API_KEY=sk-ant-... # API key
export OPENCLI_BASE_URL=https://... # optional proxy
```
1 change: 1 addition & 0 deletions autoresearch/baseline-browse.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
56/59
1 change: 1 addition & 0 deletions autoresearch/baseline-skill.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
31/31
Loading
Loading