10x-chat 0.8.3 → 0.9.1

package/skills/10x-chat/SKILL.md

@@ -1,33 +1,56 @@
 ---
 name: 10x-chat
-description: Chat with web AI agents (ChatGPT, Gemini, Claude, Grok, Perplexity, NotebookLM) via browser automation, plus image generation and deep research workflows. Use when stuck on a bug, need cross-validation, want a second-model review, need browser-only model access, want long-form research, or need image generation from web AI tools.
+description: Chat with web AI agents (ChatGPT, Gemini, Claude, Grok, Perplexity, NotebookLM) via browser automation. Use when stuck, need cross-validation, want a second-model review, need image generation, or want deep research from web AI tools.
 ---
 
 # 10x-chat — AI Agent Skill
 
-Use 10x-chat to send prompts to web-based AI agents (ChatGPT, Gemini, Claude, Grok, Perplexity, NotebookLM) via automated browser sessions. It also supports image generation and deep research flows. Sessions use the shared persisted profile by default, so the user usually only needs to log in once per provider.
+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` to get the newest version:
+No install needed. Always use `@latest`:
 
 ```bash
-npx 10x-chat@latest --version    # check current version
+npx 10x-chat@latest --version
 ```
 
-Prefer `npx` over `bunx` — `bunx` has symlink conflicts when running multiple providers in parallel.
+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 / reasoning.
+- **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
+
+## Providers
+
+| Provider | Chat | Image | Research | Notes |
+|----------|------|-------|----------|-------|
+| chatgpt | ✅ | ✅ (DALL-E) | ✅ | Runs headed by default (anti-bot) |
+| gemini | ✅ | ✅ (Imagen) | ✅ | |
+| claude | ✅ | ❌ | ❌ | Runs headed by default |
+| grok | ✅ | ❌ | ❌ | UI changes often, use `@latest` |
+| perplexity | ✅ | ❌ | ✅ | Best for research with citations |
+| notebooklm | ✅ | ❌ | ❌ | Add sources first, then chat |
 
 ## Commands
 
 ```bash
-# Login (one-time per provider — opens browser for user to authenticate)
+# 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
@@ -35,82 +58,102 @@ npx 10x-chat@latest login grok
 npx 10x-chat@latest login perplexity
 npx 10x-chat@latest login notebooklm
 
-# Chat with a single provider
+# Chat
 npx 10x-chat@latest chat -p "Review this code for bugs" --provider chatgpt --file "src/**/*.ts"
-
-# Chat with file context
 npx 10x-chat@latest chat --provider gemini --file "path/to/prompt.md" -p "Complete this task"
 
-# Generate images
-npx 10x-chat@latest image -p "A fox astronaut in space, digital art" --provider chatgpt
+# 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
 
-# Run deep research
+# 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 "Market analysis of EVs" --provider chatgpt --timeout 600000
 
-# Dry run (preview the prompt bundle without sending)
+# Dry run / clipboard
 npx 10x-chat@latest chat --dry-run -p "Debug this error" --file src/
-
-# Copy bundle to clipboard (manual paste fallback)
 npx 10x-chat@latest chat --copy -p "Explain this" --file "src/**"
 
-# Check recent sessions
+# Session management
 npx 10x-chat@latest status
-
-# View a session's response
 npx 10x-chat@latest session <id> --render
 
-# Install bundled skill to ~/.codex/skills/
-npx 10x-chat@latest skill install
+# 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>
 
-# NotebookLM — manage notebooks & sources
-npx 10x-chat@latest notebooklm list                         # List notebooks
-npx 10x-chat@latest notebooklm create "My Research"         # Create notebook
-npx 10x-chat@latest notebooklm add-url <id> https://...     # Add URL source
-npx 10x-chat@latest notebooklm add-file <id> ./paper.pdf    # Upload file source
-npx 10x-chat@latest notebooklm sources <id>                 # List sources
-npx 10x-chat@latest notebooklm summarize <id>               # AI summary
-npx 10x-chat@latest chat -p "Summarize" --provider notebooklm
+# Install bundled skill to coding agent
+npx 10x-chat@latest skill install
 ```
 
-## Multi-provider workflow
+## Parallel sessions (v0.9.0+)
 
-Prefer `npx 10x-chat@latest`. Shared profile mode is the default, so parallel runs are supported more reliably than before, but sequential runs are still the safest choice when debugging flaky provider UIs.
+HTTP daemon makes parallel runs stable. All providers share one Chrome:
 
 ```bash
-# Login all providers first
+# Login all once
 npx 10x-chat@latest login gemini
 npx 10x-chat@latest login claude
 npx 10x-chat@latest login chatgpt
-npx 10x-chat@latest login grok
 
-# Safer sequential review flow
-npx 10x-chat@latest chat --provider gemini --headed -p "Your prompt" --file context.md
-npx 10x-chat@latest chat --provider claude --headed -p "Your prompt" --file context.md
-npx 10x-chat@latest chat --provider chatgpt --headed -p "Your prompt" --file context.md
-npx 10x-chat@latest chat --provider grok --headed -p "Your prompt" --file context.md
+# 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`
+
+```bash
+# Migrate from isolated to shared
+npx 10x-chat@latest migrate
+```
+
+## Daemon management
+
+```bash
+# 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 you get the newest fixes.
-- **Use `--headed`** for Grok and ChatGPT when reliability matters.
-- **Login first**: Run `npx 10x-chat@latest login <provider>` once per provider. Sessions persist in `~/.10x-chat/profiles/`.
-- **Deep research needs longer timeouts**: use `research --timeout 600000` for long jobs.
-- **Image generation can take 1–2 minutes**: use `image --timeout 120000` when needed.
-- **Keep file sets small**: fewer files + a focused prompt = better answers.
-- **Don't send secrets**: exclude `.env`, key files, auth tokens from `--file` patterns.
-- **Use `--dry-run`** to preview what will be sent before committing to a run.
-- **NotebookLM**: add sources first, then chat with `--provider notebooklm`.
+- **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
+- **Use `--dry-run`** to preview what will be sent
 
 ## Known issues
 
-- **Grok**: UI changes frequently. If response capture fails, selectors may need updating.
-- **ChatGPT/Grok sessions expire quickly**: log in again if you get "Not logged in" errors.
-- **Some provider UIs are flaky under automation**: retry with `--headed` before assuming a hard failure.
+- **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.
+- 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