dsh-chatgpt-web

English | 中文

Zero-cost conversational AI model provider for DeepSeek Harness powered by free ChatGPT Web (GPT-6 Luna).

---

Table of Contents

• Overview
• Requirements
• Quick Start
• Diagnostics & Health Check
• Troubleshooting
• Notes & Limitations
• Related Documentation

---

Overview

dsh-chatgpt-web turns your local browser session of ChatGPT into a seamless, $0.00 API-free conversational model provider directly inside DeepSeek Harness (DSH).

It connects via headless or visible Chrome/Chromium browser automation to chatgpt.com, streaming real-time Markdown responses, code solutions, explanations, and reasoning back to your DSH chats without consuming API credits.

Why Pure Chat?

Small conversational web models (like GPT-6 Luna) excel at explanations, dialogue, Q&A, brainstorming, code snippet generation, and side-assistant tasks. By running in Pure Chat Mode, the bridge eliminates prompt overhead, tool hallucinations, and syntax errors of autonomous multi-tool execution loops, providing a fast, rock-solid, zero-cost LLM provider.

Key Features

• 100% Free ($0.00 Cost): Uses your existing free ChatGPT Web session. No OpenAI API keys or credit cards needed.
• Cordis Plugin-First Lifecycle: Managed by DSH via ctx.effect. DeepSeek Harness starts the background sidecar automatically on launch and shuts it down on exit.
• Dynamic Model Auto-Detection: Automatically detects your ChatGPT tier:
  • Free Accounts: Defaults to chatgpt-web/luna (gpt-5-6-luna) and chatgpt-web/think.
  • Plus / Team Accounts: Automatically detects and exposes GPT-6 (chatgpt-web/gpt-6-light, medium, high) and GPT-5.6 Sol (chatgpt-web/light, medium, high), plus Pro tiers when available.
• Full Streaming Markdown & Code Blocks: Delivers tokens in real time directly to the DSH Web UI or CLI.
• Portable, Validated Artifacts: The published tarball is validated by CI (clean install, runtime smoke test, dependency resolution, no build-environment path contamination) before it can reach the registries.

---

Requirements

• Runtime: Node.js >=22.19.0 or Bun >=1.3.0 (both are supported; the CLI runs on either).
• DeepSeek Harness: >=0.2.0-rc.2.
• Browser: Chrome or Chromium on your machine (used for the one-time sign-in and for serving).

---

Quick Start

1. Installation

Install the plugin directly from this GitHub repository:

# Via npm registry (recommended):
dsh plugin --profile <profile> add @wlv-zedd/dsh-chatgpt-web

# Or directly from GitHub:
dsh plugin --profile <profile> add github:WLV-ZEDD/dsh-chatgpt-web

This registers the plugin in the profile's package.json bundles, so its Cordis entries are composed automatically — no manual insert is needed.

2. One-Time Browser Sign-In

Authenticate your ChatGPT account once. The plugin binary lives in the profile's node_modules/.bin:

~/.dsh/profiles/<profile>/node_modules/.bin/dsh-chatgpt-web setup --dsh

…