mirror of
https://github.com/jackwener/OpenCLI.git
synced 2026-09-14 18:25:42 +08:00
E2ern1ty
b262d8ffd5
* feat(chatgpt): support local image uploads * chore: refresh cli manifest * fix(chatgpt): harden image upload flow * fix(chatgpt): validate image uploads before navigation * fix(chatgpt): keep send fallback click in sync --------- Co-authored-by: jackwener <jakevingoo@gmail.com>
88 lines
3.8 KiB
Markdown
88 lines
3.8 KiB
Markdown
# ChatGPT Web
|
|
|
|
**Mode**: 🔐 Browser · **Domain**: `chatgpt.com`
|
|
|
|
## Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `opencli chatgpt ask <prompt>` | Send a prompt and wait for the visible response |
|
|
| `opencli chatgpt send <prompt>` | Send a prompt without waiting |
|
|
| `opencli chatgpt read` | Read the current conversation |
|
|
| `opencli chatgpt history` | List visible conversation history links from the sidebar |
|
|
| `opencli chatgpt detail <id-or-url>` | Open a conversation by `/c/<id>` and read it |
|
|
| `opencli chatgpt new` | Start a new conversation |
|
|
| `opencli chatgpt status` | Check page and login state |
|
|
| `opencli chatgpt image <prompt>` | Generate images in ChatGPT web and optionally save them locally |
|
|
|
|
## Usage Examples
|
|
|
|
```bash
|
|
# Ask and wait for the answer
|
|
opencli chatgpt ask "Summarize the tradeoffs of browser session reuse"
|
|
|
|
# Continue the same ChatGPT tab but do not wait for the answer
|
|
opencli chatgpt send "Now turn that into a checklist"
|
|
|
|
# Read the current conversation
|
|
opencli chatgpt read --markdown true
|
|
|
|
# List recent visible conversations and read one by id or URL
|
|
opencli chatgpt history --limit 10
|
|
opencli chatgpt detail "https://chatgpt.com/c/<conversation-id>"
|
|
|
|
# Start a fresh chat
|
|
opencli chatgpt new
|
|
|
|
# Generate an image and save it to the default directory
|
|
opencli chatgpt image "a cyberpunk city at night"
|
|
|
|
# Upload a local image, ask ChatGPT to edit it, and save the result
|
|
opencli chatgpt image "make the background blue" --image ./cat.png
|
|
|
|
# Upload multiple local images for a combined edit
|
|
opencli chatgpt image "combine these into a poster" --image ./cat.png,./logo.png
|
|
|
|
# Save to a custom output directory
|
|
opencli chatgpt image "a robot sketching on paper" --op ~/Downloads/chatgpt-images
|
|
|
|
# Only generate in ChatGPT and print the conversation link
|
|
opencli chatgpt image "a tiny watercolor fox" --sd true
|
|
```
|
|
|
|
## Options
|
|
|
|
| Option | Description |
|
|
|--------|-------------|
|
|
| `prompt` | Prompt to send (required for `ask`, `send`, and `image`) |
|
|
| `--timeout` | Max seconds for `ask` to wait for a response (default: `120`) |
|
|
| `--new` | Start a new conversation before `ask` / `send` |
|
|
| `--markdown` | Convert assistant message HTML to Markdown for `read` / `detail` |
|
|
| `--limit` | Max visible history conversations to return (default: `20`) |
|
|
| `--image` | Local image path to attach before prompting; comma-separated paths are supported |
|
|
| `--op` | Output directory for downloaded images (default: `~/Pictures/chatgpt`) |
|
|
| `--sd` | Skip download and only print the ChatGPT conversation link |
|
|
|
|
## Behavior
|
|
|
|
- ChatGPT web commands use persistent site sessions by default, so consecutive `ask` / `send` / `read` / `detail` commands continue in the same ChatGPT tab. Use `--site-session ephemeral` for one-shot isolated tabs.
|
|
- `ask` waits for the first stable assistant response after sending. `send` submits only and returns immediately.
|
|
- `history` reads visible `/c/<id>` links from the ChatGPT sidebar; it does not use private backend APIs.
|
|
- `image` opens a fresh `chatgpt.com/new` page before sending the image prompt.
|
|
- When `--image` is provided, local images are uploaded first and the prompt is sent as an image edit request.
|
|
- `image` output is plain `status / file / link`, not a markdown table.
|
|
- When `--sd` is enabled, the command does not download files and only prints the ChatGPT link.
|
|
- Downloaded files are named with a timestamp to avoid overwriting prior runs.
|
|
|
|
## Prerequisites
|
|
|
|
- Chrome is running
|
|
- You are already logged into `chatgpt.com`
|
|
- [Browser Bridge extension](/guide/browser-bridge) is installed
|
|
|
|
## Caveats
|
|
|
|
- This adapter targets the ChatGPT web UI, not the macOS desktop app.
|
|
- It depends on the current browser session and can fail if ChatGPT shows login, challenge, quota, or other gating UI.
|
|
- DOM or product changes on ChatGPT can break composer detection, image detection, or export behavior.
|