CLI to chat with web AI agents (ChatGPT, Gemini, Claude, Grok, Perplexity, NotebookLM) and generate video (Flow/Veo, Dreamina/Seedance) via browser automation
Chat with web AI agents (ChatGPT, Gemini, Claude, Grok, Perplexity, NotebookLM) from your terminal via browser automation.
English | 繁體中文
10x-chat uses Playwright to automate browser sessions with persisted login profiles. Login once, then send prompts — bundled with file context — from your CLI or AI coding agent.
Paste this into your OpenClaw chat to install as a skill:
https://raw.githubusercontent.com/MikeChongCan/10x-chat/refs/heads/main/skills/10x-chat/SKILL.md
npx playwright install chromium # one-time browser setup
# 1. Login to a provider (opens a browser window)
npx 10x-chat@latest login chatgpt
# 2. Send a prompt
npx 10x-chat@latest chat -p "Explain this error" --provider chatgpt --file "src/**/*.ts"
# 3. View session history
npx 10x-chat@latest status
[!TIP] Use
bunx(bun.sh) instead ofnpxfor faster startup.
login <provider>Opens a headed browser for you to authenticate. The session persists across runs.
npx 10x-chat@latest login chatgpt # Login to ChatGPT
npx 10x-chat@latest login gemini # Login to Gemini
npx 10x-chat@latest login claude # Login to Claude
npx 10x-chat@latest login grok # Login to Grok
npx 10x-chat@latest login perplexity # Login to Perplexity
npx 10x-chat@latest login notebooklm # Login to NotebookLM
npx 10x-chat@latest login dreamina # Login to Dreamina (CapCut) for video
npx 10x-chat@latest login --status # Check login status for all providers
Google Flow (Veo) video uses your Google login — logging into Gemini covers it in shared-profile mode.
chatSend a prompt to an AI provider via browser automation.
npx 10x-chat@latest chat -p "Review this code for bugs" --provider chatgpt --file "src/**/*.ts"
npx 10x-chat@latest chat -p "Debug this error" --file "logs/error.log"
npx 10x-chat@latest chat -p "Explain this" --dry-run # Preview bundle without sending
npx 10x-chat@latest chat -p "Explain this" --copy # Copy bundle to clipboard
npx 10x-chat@latest chat -p "Long task" --timeout 600000 --headed # 10min timeout, visible browser
| Flag | Description |
|---|---|
-p, --prompt <text> | (required) The prompt to send |
--provider <name> | Provider: chatgpt, gemini, claude, grok, perplexity, notebooklm (default: config) |
--model <name> | Model/mode to select in the provider UI (e.g. Gemini: Fast, Thinking, Deep Think, Pro) |
-f, --file <paths...> | Files/globs to bundle as context |
--copy | Copy bundle to clipboard instead of sending |
--dry-run | Preview the bundle without sending |
--headed | Show browser window during chat |
--timeout <ms> | Response timeout in milliseconds (default: 300000) |
imageGenerate images via ChatGPT (DALL-E), Gemini (Imagen), or Grok with non-blocking polling.
npx 10x-chat@latest image -p "A fox astronaut in space, digital art" --provider chatgpt
npx 10x-chat@latest image -p "Watercolor landscape" --provider gemini --save-dir ./images
npx 10x-chat@latest image -p "Logo design" --provider grok --headed --timeout 120000
| Flag | Description |
|---|---|
-p, --prompt <text> | (required) The image generation prompt |
--provider <name> | Provider: chatgpt, gemini, grok (default: chatgpt) |
--headed | Show browser window |
--timeout <ms> | Generation timeout (default: 120000) |
--save-dir <dir> | Directory to save generated images |
researchDeep research via ChatGPT, Gemini, or Perplexity with non-blocking progress polling. Designed for long-running research tasks (5-10+ minutes).
npx 10x-chat@latest research -p "Latest breakthroughs in quantum computing" --provider gemini
npx 10x-chat@latest research -p "Hard technical research" --provider gemini --model "Deep Think"
npx 10x-chat@latest research -p "Market analysis of EVs" --provider chatgpt --timeout 600000
npx 10x-chat@latest research -p "Compare React vs Vue in 2026" --provider perplexity --save-dir ./reports
| Flag | Description |
|---|---|
-p, --prompt <text> | (required) The research query |
--provider <name> | Provider: chatgpt, gemini, perplexity (default: gemini) |
--model <name> | Optional model/mode to select before starting research |
--headed | Show browser window |
--timeout <ms> | Total timeout (default: 600000 / 10 min) |
--poll-interval <ms> | Progress check interval (default: 5000) |
--save-dir <dir> | Directory to save the research report |
videoGenerate video via browser automation — Google Flow (Veo) or Dreamina (Seedance).
# Google Flow / Veo (default) — uses your Google login (shared with Gemini)
npx 10x-chat@latest video -p "A drone shot over snowy mountains at sunrise" --provider flow
npx 10x-chat@latest video -p "Neon city street, rain" --provider flow --model "Omni Flash" --duration 10 --orientation portrait
npx 10x-chat@latest video -p "She walks forward" --provider flow --image ref.png # image-to-video
# Dreamina / Seedance (CapCut)
npx 10x-chat@latest login dreamina # one-time CapCut login
npx 10x-chat@latest video -p "A paper boat in a rain gutter, macro" --provider dreamina --aspect 9:16 --dreamina-duration 4
npx 10x-chat@latest video -p "The glowing orb pulses and floats up" --provider dreamina --image ref.png --ref-mode omni
Shared flags:
| Flag | Description |
|---|---|
-p, --prompt <text> | (required) The video generation prompt |
--provider <name> | flow (default) or dreamina |
--model <name> | Model (provider-specific — see below) |
--headed | Show browser window during generation |
--timeout <ms> | Generation timeout (default: 600000 / 10 min) |
--save-dir <dir> | Directory to save generated videos |
Flow (Veo) — models: Omni Flash (default), Veo 3.1 - Lite, Veo 3.1 - Fast, Veo 3.1 - Quality.
| Flag | Description |
|---|---|
--mode <mode> | ingredients (default) or frames |
--orientation <dir> | landscape (default) or portrait |
--count <n> | Simultaneous generations (1-4) |
--image <path> | Reference image for image-to-video (ingredients mode) |
--duration <secs> | Clip length in seconds: 4, 6, 8, 10 |
--start-frame <path> / --end-frame <path> | Keyframe images (frames mode) |
Dreamina (Seedance) — requires login dreamina (CapCut account). Models: Seedance 2.0 Fast (default, cheapest), Seedance 2.0; Seedance 1.5 Pro / 1.0 / 1.0 Fast may be locked depending on your plan/region.
| Flag | Description |
|---|---|
--aspect <ratio> | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
--resolution <res> | 720P (default) or 1080P (model-dependent) |
--dreamina-duration <secs> | Clip length in seconds (4-15) |
--ref-mode <mode> | Input-image mode: omni (default), frames, multiframes |
--image <path> | Reference/input image for image-to-video (repeatable, up to 12) |
historyList chat history visible in provider sidebars (ChatGPT, Gemini, Claude, Grok, Perplexity).
npx 10x-chat@latest history --provider gemini
npx 10x-chat@latest history --provider all --limit 10
npx 10x-chat@latest history --provider chatgpt --json
| Flag | Description |
|---|---|
--provider <name> | Provider: chatgpt, gemini, claude, grok, perplexity, or all (default: all) |
--limit <n> | Maximum items per provider (default: 20) |
--headed | Show browser window |
--json | Output JSON |
statusList local 10x-chat CLI sessions.
npx 10x-chat@latest status # Last 24 hours
npx 10x-chat@latest status --hours 72 # Last 3 days
session <id>View details of a specific session.
npx 10x-chat@latest session <id> --render # Pretty-print the response
configView or modify configuration.
npx 10x-chat@latest config show
npx 10x-chat@latest config set provider gemini
npx 10x-chat@latest config set timeout 600000
npx 10x-chat@latest config set headless false
skillManage the agent integration skill (for Codex, Claude Code, etc).
npx 10x-chat@latest skill install # Install SKILL.md to ~/.codex/skills/
npx 10x-chat@latest skill show # Display SKILL.md content
notebooklm (alias: nb)Manage NotebookLM notebooks and sources via RPC API.
npx 10x-chat@latest notebooklm list # List all notebooks
npx 10x-chat@latest notebooklm create "Research Topic" # Create a notebook
npx 10x-chat@latest notebooklm delete <notebookId> # Delete a notebook
npx 10x-chat@latest notebooklm sources <notebookId> # List sources in notebook
npx 10x-chat@latest notebooklm add-url <notebookId> <url> # Add URL source
npx 10x-chat@latest notebooklm add-url <notebookId> <url> --wait # Add URL and wait for processing
npx 10x-chat@latest notebooklm add-file <notebookId> ./paper.pdf # Upload file source
npx 10x-chat@latest notebooklm add-text <id> "Title" "Content" # Add pasted text source
npx 10x-chat@latest notebooklm summarize <notebookId> # AI summary + suggested topics
# Then chat with the notebook's sources:
npx 10x-chat@latest chat -p "Summarize key points" --provider notebooklm
migrateMerge older per-provider isolated browser profiles into the single shared profile used by default. Useful when upgrading from a version that stored a separate profile per provider.
npx 10x-chat@latest migrate --dry-run # Preview without making changes
npx 10x-chat@latest migrate # Auto-pick the largest profile as the base
npx 10x-chat@latest migrate --source chatgpt # Use a specific provider's profile as the base
npx 10x-chat@latest migrate --keep # Keep the old isolated profiles after migrating
The --file flag accepts globs. Files are assembled into a markdown bundle sent as the prompt:
npx 10x-chat@latest chat -p "Review these" --file "src/**/*.ts" "!src/**/*.test.ts"
Security-sensitive files (.env*, *.pem, *.key, etc.) are automatically excluded.
~/.10x-chat/
├── profiles/
│ ├── chatgpt/ # Playwright persistent browser profile
│ ├── gemini/
│ ├── claude/
│ ├── grok/
│ └── notebooklm/ # NotebookLM browser profile (shared Google auth)
├── sessions/
│ └── <uuid>/
│ ├── meta.json # Session metadata
│ ├── bundle.md # Prompt bundle sent
│ └── response.md # Captured response
└── config.json # User configuration
10x-chat includes a SKILL.md for AI coding agents. Install it with:
npx 10x-chat@latest skill install
This lets agents like Codex or Claude Code use 10x-chat to query other models for cross-validation, code review, or debugging help.
| Provider | Status | Models | URL |
|---|---|---|---|
| ChatGPT | ✅ chat + image | — | chatgpt.com |
| Gemini | ✅ chat + image | Fast, Thinking (default), Deep Think, Pro | gemini.google.com |
| Claude | ✅ chat | — | claude.ai |
| Grok | ✅ chat + image | — | grok.com |
| Perplexity | ✅ | — | perplexity.ai |
| NotebookLM | ✅ | — | notebooklm.google.com |
| Google Flow | ✅ video (Veo) | Omni Flash (default), Veo 3.1 Lite/Fast/Quality | labs.google/fx/tools/flow |
| Dreamina | ✅ video (Seedance) | Seedance 2.0 Fast/2.0 (1.x often plan-locked) | dreamina.capcut.com |
bun install
bun run dev login chatgpt # Run CLI in dev mode
bun run typecheck # Type check
bun run lint # Lint
bun run test # Run tests
bun run build # Build for production
Releases are automated via GitHub Actions. Push a version tag to publish:
npm version patch # or minor / major
git push --follow-tags
Requires NPM_TOKEN secret in the GitHub repository settings.
This project is provided for research and educational purposes only. It automates web interfaces that may be subject to the terms of service of the respective providers. You are solely responsible for how you use it, including compliance with any applicable terms, and you use it at your own risk.
MIT © Mike Chong — see LICENSE.
FAQs
CLI to chat with web AI agents (ChatGPT, Gemini, Claude, Grok, Perplexity, NotebookLM) and generate video (Flow/Veo, Dreamina/Seedance) via browser automation
We found that 10x-chat demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
pnpm 11.5 now recognizes npm staged publish approvals in release metadata, preventing those releases from being mistaken for lower-trust package publishes.
Security News
Federal audit finds NIST lacked a plan to clear the NVD backlog, wasted funds on duplicate work, and delayed use of CISA data.
Research
/Security News
A mini Shai-Hulud campaign compromised Red Hat Cloud Services npm packages to steal developer and CI/CD secrets during installation.