10x-chat

Engineering Community

Repo stars 36
Author repo 10x-chat

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: Chat with web AI agents (ChatGPT, Gemini, Claude, Grok, Perplexity, NotebookLM) via browser automation. Use when stuck, need cro…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “Architecture (v0.9.0+)”, “Installation”, “When to use”, “Providers”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name 10x-chat directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “Architecture (v0.9.0+) / Installation / When to use” before expanding.

Boundaries And Review

Dependencies: It usually needs no extra API key, so start with a small validation task.
Permissions: Declared permissions include read / write; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

10x-chat — AI Agent Skill

Use 10x-chat to send prompts to web-based AI agents via automated browser sessions. Supports chat, image generation, deep research, and video generation. Sessions use a shared persisted profile by default.

Architecture (v0.9.0+)

10x-chat uses an HTTP browser daemon — a persistent local Node.js server wrapping Playwright:

One daemon, multiple sessions: parallel CLI runs share a single Chrome instance via HTTP RPC
Auto-start/stop: daemon launches on first use, shuts down after 30 min idle
Crash recovery: if daemon dies, next CLI run auto-restarts it
No zombie Chrome: proper tab ref-counting and graceful shutdown
State file: ~/.10x-chat/browser-daemon.json (port, PID, bearer token, chmod 600)

Installation

No install needed. Always use @latest:

npx 10x-chat@latest --version

Use npx (not bunx — symlink conflicts in parallel).

When to use

Stuck on a bug: ask another model for a fresh perspective
Code review: send PR diff to GPT / Claude / Gemini for cross-review
Cross-validation: compare answers from multiple models
Knowledge gaps: leverage a model with different training data
Image generation: DALL-E via ChatGPT or Imagen via Gemini
Deep research: long-form analysis via Perplexity, ChatGPT, or Gemini
Video generation: text/image-to-video via Google Flow (Veo) or Dreamina (Seedance)

Providers

Provider	Chat	Image	Research	Video	Models	Notes
chatgpt	✅	✅ (DALL-E)	✅	❌	—	Runs headed by default (anti-bot)
gemini	✅	✅ (Imagen)	✅	❌	Fast, Thinking (default), Deep Think (Ultra tool), Pro	`--model` switches mode
claude	✅	❌	❌	❌	—	Runs headed by default
grok	✅	✅	❌	❌	—	UI changes often, use `@latest`
perplexity	✅	❌	✅	❌	—	Best for research with citations
notebooklm	✅	❌	❌	❌	—	Add sources first, then chat
flow	❌	❌	❌	✅ (Veo)	Veo 3.1 Fast/Quality, Veo 2 Fast/Quality	Google login (shared with Gemini)
dreamina	❌	❌	❌	✅ (Seedance)	Seedance 2.0 Fast (default)/2.0; 1.x often plan-locked	`login dreamina` (CapCut); text + image-to-video

Commands

# Login (one-time per provider — opens browser for auth)
npx 10x-chat@latest login chatgpt
npx 10x-chat@latest login gemini
npx 10x-chat@latest login claude
npx 10x-chat@latest login grok
npx 10x-chat@latest login perplexity
npx 10x-chat@latest login notebooklm

# Chat
npx 10x-chat@latest chat -p "Review this code for bugs" --provider chatgpt --file "src/**/*.ts"
npx 10x-chat@latest chat --provider gemini --file "path/to/prompt.md" -p "Complete this task"
npx 10x-chat@latest chat --provider gemini --model Pro -p "Solve this math problem"
npx 10x-chat@latest chat --provider gemini --model "Deep Think" -p "Solve this hard problem"

# Image generation
npx 10x-chat@latest image -p "A fox astronaut in space" --provider chatgpt
npx 10x-chat@latest image -p "Watercolor landscape" --provider gemini --save-dir ./images

# Deep research (long-form, 5-10 min)
npx 10x-chat@latest research -p "Latest breakthroughs in quantum computing" --provider perplexity
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

# Video generation (Flow / Veo default, or Dreamina / Seedance)
npx 10x-chat@latest video -p "Drone shot over snowy peaks at sunrise" --provider flow
npx 10x-chat@latest video -p "Neon street, rain" --provider flow --model "Veo 3.1 - Quality" --orientation portrait
npx 10x-chat@latest login dreamina   # one-time CapCut login for Dreamina
npx 10x-chat@latest video -p "A paper boat in a rain gutter, macro" --provider dreamina --aspect 9:16 --duration 4
npx 10x-chat@latest video -p "The glowing orb floats up" --provider dreamina --image ref.png --ref-mode omni

# Dry run / clipboard
npx 10x-chat@latest chat --dry-run -p "Debug this error" --file src/
npx 10x-chat@latest chat --copy -p "Explain this" --file "src/**"

# Provider chat history + local session management
npx 10x-chat@latest history --provider gemini
npx 10x-chat@latest history --provider all --limit 10
npx 10x-chat@latest status
npx 10x-chat@latest session <id> --render

# NotebookLM
npx 10x-chat@latest notebooklm list
npx 10x-chat@latest notebooklm create "My Research"
npx 10x-chat@latest notebooklm add-url <id> https://...
npx 10x-chat@latest notebooklm add-file <id> ./paper.pdf
npx 10x-chat@latest notebooklm sources <id>
npx 10x-chat@latest notebooklm summarize <id>

# Install bundled skill to coding agent
npx 10x-chat@latest skill install

Parallel sessions (v0.9.0+)

HTTP daemon makes parallel runs stable. All providers share one Chrome:

# Login all once
npx 10x-chat@latest login gemini
npx 10x-chat@latest login claude
npx 10x-chat@latest login chatgpt

# Run concurrently — each opens a tab in the shared daemon
npx 10x-chat@latest chat --provider gemini -p "Your prompt" --file context.md &
npx 10x-chat@latest chat --provider claude -p "Your prompt" --file context.md &
npx 10x-chat@latest chat --provider chatgpt -p "Your prompt" --file context.md &
wait

Browser mode

Headless (default for gemini, grok, perplexity): no visible window
Headed (default for chatgpt, claude): visible Chrome window (anti-bot protection)
Force headed: --headed flag on any provider

The daemon stores the headless/headed mode in its state file. If you switch modes, the daemon restarts automatically.

Profile modes

Shared (default): One browser profile, all providers share cookies. Login once per Google account covers Gemini + NotebookLM.

Isolated: Separate profile per provider (backward compat): --isolated-profile

# Migrate from isolated to shared
npx 10x-chat@latest migrate

Daemon management

# Check daemon state
cat ~/.10x-chat/browser-daemon.json

# Force stop daemon
# (CLI calls stopDaemon() on Ctrl+C automatically)
kill $(cat ~/.10x-chat/browser-daemon.json | python3 -c "import sys,json; print(json.load(sys.stdin)['pid'])")

Tips

Always use @latest: ensures newest fixes
Login first: login <provider> once per provider. Sessions persist in ~/.10x-chat/profiles/
Use --headed if a provider is flaky (Grok especially)
Keep file sets small: fewer files + focused prompt = better answers
Research needs longer timeouts: --timeout 600000 for 10-min research jobs
Image gen can take 1-2 min: use --timeout 120000 when needed
Video gen can take 1-5 min: Dreamina queues generations; keep the default 10-min timeout. For image-to-video, pass --image (Dreamina) or --start-frame/--end-frame with --mode frames (Flow)
Dreamina models are plan-gated: Seedance 2.0 Fast (cheapest) and 2.0 are generally available; the CLI errors clearly if a requested model is locked
Use --dry-run to preview what will be sent

Known issues

Grok: UI changes frequently. Always use @latest. Use --headed for best reliability
ChatGPT/Grok sessions expire quickly: login again if you get "Not logged in" errors
Some provider UIs are flaky under automation: retry with --headed before assuming a hard failure

Safety

Never include credentials, API keys, or tokens in the bundled files
The tool opens a real browser with real login state. Treat it like your own browser session

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: Engineering
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 88 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @MikeChongCan · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Plug-and-play
External API key: No requirement detected
Detected OS requirements: macOS · Linux · Windows
Runtime requirements: Node.js
Detected file/system behavior: Read-only
Write / modify
Detected network behavior: Local-only
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview 10x-chat.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# 10x-chat — AI Agent Skill

Use 10x-chat to send prompts to web-based AI agents via automated browser sessions. Supports chat, image generation, deep research, and video generation. Sessions use a shared persisted profile by default.

## Architecture (v0.9.0+)

10x-chat uses an **HTTP browser daemon** — a persistent local Node.js server wrapping Playwright:

- **One daemon, multiple sessions**: parallel CLI runs share a single Chrome instance via HTTP RPC
- **Auto-start/stop**: daemon launches on first use, shuts down after 30 min idle
- **Crash recovery**: if daemon dies, next CLI run auto-restarts it
- **No zombie Chrome**: proper tab ref-counting and graceful shutdown
- **State file**: `~/.10x-chat/browser-daemon.json` (port, PID, bearer token, chmod 600)

## Installation

No install needed. Always use `@latest`:

```bash
npx 10x-chat@latest --version
```

Use `npx` (not `bunx` — symlink conflicts in parallel).

## When to use

- **Stuck on a bug**: ask another model for a fresh perspective
- **Code review**: send PR diff to GPT / Claude / Gemini for cross-review
- **Cross-validation**: compare answers from multiple models
- **Knowledge gaps**: leverage a model with different training data
- **Image generation**: DALL-E via ChatGPT or Imagen via Gemini
- **Deep research**: long-form analysis via Perplexity, ChatGPT, or Gemini
- **Video generation**: text/image-to-video via Google Flow (Veo) or Dreamina (Seedance)

## Providers

| Provider | Chat | Image | Research | Video | Models | Notes |
|----------|------|-------|----------|-------|--------|-------|
| chatgpt | ✅ | ✅ (DALL-E) | ✅ | ❌ | — | Runs headed by default (anti-bot) |
| gemini | ✅ | ✅ (Imagen) | ✅ | ❌ | Fast, **Thinking** (default), Deep Think (Ultra tool), Pro | `--model` switches mode |

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> Architecture (v0.9.0+) → Installation → When to use → Providers → Commands → Parallel sessions (v0.9.0+)
terms    -> HTTP browser daemon · One daemon, multiple sessions · Auto-start/stop · Crash recovery · No zombie Chrome · State file · Stuck on a bug · Code review
files/cmd -> ~/.10x-chat/browser-daemon.json · @latest · npx · bunx · --model · login dreamina · --headed · --isolated-profile
body sha256 -> db9508946f1f