cli-web-chatgpt

CLI for ChatGPT web interface. Ask questions, generate images, download images, manage conversations.

Quick Start

# Ask a question
cli-web-chatgpt chat ask "What is the capital of France?" --json

# Generate an image and save it
cli-web-chatgpt chat image "A sunset over mountains" -o sunset.png --json

# List recent conversations
cli-web-chatgpt conversations list --limit 10 --json

Commands

chat ask

Ask ChatGPT a question and get a text response.

cli-web-chatgpt chat ask "Explain quantum computing in 3 sentences" --json
cli-web-chatgpt chat ask "What is 100+200?" --json
cli-web-chatgpt chat ask "Translate hello to Spanish" --conversation <id> --json

Options: --model <slug>, --conversation <id>, --json Output: {"success": true, "data": {"text": "...", "conversation_id": "...", "model": "auto"}}

chat image

Generate an image with ChatGPT's DALL-E.

cli-web-chatgpt chat image "A cute cat wearing a hat" --json
cli-web-chatgpt chat image "Logo for a coffee shop" -o logo.png --json

Options: --style <name>, --output/-o <path>, --conversation <id>, --json Output: {"success": true, "data": {"file_id": "...", "download_url": "...", "conversation_id": "...", "saved_to": "..."}}

conversations list

List recent conversations.

cli-web-chatgpt conversations list --limit 20 --json
cli-web-chatgpt conversations list --archived --json
cli-web-chatgpt conversations list --starred --json

Options: --limit/-n <N>, --archived, --starred, --json

conversations get

View a conversation's messages.

cli-web-chatgpt conversations get 69ca710b-5ef8-8397-a242-c5123470d7f8 --json

images list

List recently generated images.

cli-web-chatgpt images list --limit 10 --json

images download <file_id>

Download a generated image.

cli-web-chatgpt images download file_00000000xxx -c <conversation_id> -o image.png --json

Options: --conversation/-c <id> (required), --output/-o <path>, --json

images styles

List available image styles.

cli-web-chatgpt images styles --json

models

List available ChatGPT models.

cli-web-chatgpt models --json

me

Show current user profile.

cli-web-chatgpt me --json

auth login / status / logout

Manage authentication.

cli-web-chatgpt auth login    # Opens browser for OpenAI SSO
cli-web-chatgpt auth status   # Check if logged in
cli-web-chatgpt auth logout   # Remove credentials

Architecture Notes

• Read-only commands (conversations, models, me, images) use curl_cffi — instant, no browser
• Chat and image generation use Camoufox (stealth Firefox) — fully headless, bypasses Cloudflare
• Auth requires browser login via playwright to capture session cookies
• Access tokens obtained from /api/auth/session endpoint using session cookies