/ docs / adapters / browser / chatgpt.md
chatgpt.md
 1  # ChatGPT Web
 2  
 3  **Mode**: ๐Ÿ” Browser ยท **Domain**: `chatgpt.com`
 4  
 5  ## Commands
 6  
 7  | Command | Description |
 8  |---------|-------------|
 9  | `opencli chatgpt image <prompt>` | Generate images in ChatGPT web and optionally save them locally |
10  
11  ## Usage Examples
12  
13  ```bash
14  # Generate an image and save it to the default directory
15  opencli chatgpt image "a cyberpunk city at night"
16  
17  # Save to a custom output directory
18  opencli chatgpt image "a robot sketching on paper" --op ~/Downloads/chatgpt-images
19  
20  # Only generate in ChatGPT and print the conversation link
21  opencli chatgpt image "a tiny watercolor fox" --sd true
22  ```
23  
24  ## Options
25  
26  | Option | Description |
27  |--------|-------------|
28  | `prompt` | Image prompt to send (required positional argument) |
29  | `--op` | Output directory for downloaded images (default: `~/Pictures/chatgpt`) |
30  | `--sd` | Skip download and only print the ChatGPT conversation link |
31  
32  ## Behavior
33  
34  - The command opens a fresh `chatgpt.com/new` page before sending the prompt.
35  - Output is plain `status / file / link`, not a markdown table.
36  - When `--sd` is enabled, the command does not download files and only prints the ChatGPT link.
37  - Downloaded files are named with a timestamp to avoid overwriting prior runs.
38  
39  ## Prerequisites
40  
41  - Chrome is running
42  - You are already logged into `chatgpt.com`
43  - [Browser Bridge extension](/guide/browser-bridge) is installed
44  
45  ## Caveats
46  
47  - This adapter targets the ChatGPT web UI, not the macOS desktop app.
48  - It depends on the current browser session and can fail if ChatGPT shows login, challenge, quota, or other gating UI.
49  - DOM or product changes on ChatGPT can break composer detection, image detection, or export behavior.