{"_id":"@beforewave/dsh-with-chatgpt","_rev":"4-7c6888e63b6823141d45fd3d11c98139","name":"@beforewave/dsh-with-chatgpt","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.2":{"name":"@beforewave/dsh-with-chatgpt","version":"0.1.2","keywords":["chatgpt","mcp","dsh","deepseek","coding-agent"],"license":"MIT","_id":"@beforewave/dsh-with-chatgpt@0.1.2","maintainers":[{"name":"tonyzhu","email":"zhutaoisme@gmail.com"}],"homepage":"https://github.com/beforewave/dsh-chatgpt-helm#readme","bugs":{"url":"https://github.com/beforewave/agent-chatgpt-helm/issues"},"dsh":{"bundle":{"patch":"./cordis.patch.yml"},"client":{"inject":["@deepseek-ai/dsh-client-runtime","@deepseek-ai/dsh-client-ui-sidebar","@deepseek-ai/dsh-client-locale","@deepseek-ai/dsh-client-ui-primitives"],"platform":"web"}},"dist":{"shasum":"a4772016b63addaaf77be22a44ea9eec43918234","tarball":"https://registry.npmjs.org/@beforewave/dsh-with-chatgpt/-/dsh-with-chatgpt-0.1.2.tgz","fileCount":14,"integrity":"sha512-25+DNQJv8HvhADmwgSp7B44XAlL2/UJ+eR2d9gMxvYJ+tTlaV9e/NDqsBhtWGjGkKBHDvGFSS9pv7gal8VM7mg==","signatures":[{"sig":"MEYCIQDZRyLo3+fdxgrL6hWxfe7ABK4OPLgwS6/ljgP46U4nQQIhALd5mtunh/O1jtKtnXmN5JoIqaGylhC3xVUwFnPUIKzH","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":98393},"main":"./lib/index.js","type":"module","types":"./lib/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./lib/index.d.ts","default":"./lib/index.js"},"./client":{"types":"./lib/client.d.ts","default":"./lib/client.js"},"./package.json":"./package.json"},"gitHead":"bc84cef8bfae0f5b001005af8122de1604f14976","scripts":{"build":"npm run clean && tsc -p tsconfig.json --emitDeclarationOnly && esbuild src/index.ts --bundle --platform=node --format=esm --target=node22 --minify --outfile=lib/index.js --external:@deepseek-ai/* --external:@beforewave/agent-helm && node scripts/build-client.mjs","clean":"node --input-type=module -e \"import {rmSync} from 'node:fs'; rmSync('lib',{recursive:true,force:true})\"","typecheck":"tsc -p tsconfig.json --noEmit","postinstall":"node ./preflight.mjs"},"_npmUser":{"name":"tonyzhu","email":"zhutaoisme@gmail.com"},"repository":{"url":"git+https://github.com/beforewave/agent-chatgpt-helm.git","type":"git","directory":"packages/dsh-with-chatgpt"},"_npmVersion":"11.17.0","description":"Primary DSH entry for using ChatGPT with local code, Agent Helm engineering capabilities, and native DSH sessions.","directories":{},"_nodeVersion":"26.5.0","dependencies":{"@beforewave/agent-helm":"0.1.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"react":"^18.2.0","esbuild":"^0.25.0","react-dom":"^18.2.0","typescript":"^5.9.0","@types/node":"^24.0.0","@types/react":"~18.3.1","@deepseek-ai/cordis":">=4.0.1 <5","@deepseek-ai/dsh-llm":"^0.1.1-rc.2","@deepseek-ai/dsh-agent":"^0.1.1-rc.2","@deepseek-ai/dsh-session":"^0.1.1-rc.2","@deepseek-ai/schemastery":">=3.18.1 <4","@deepseek-ai/dsh-workspace":"^0.1.1-rc.2","@deepseek-ai/dsh-mcp-client":"^0.1.1-rc.2","@deepseek-ai/dsh-agent-presets":"^0.1.1-rc.2","@deepseek-ai/dsh-client-locale":"^0.1.1-rc.2","@deepseek-ai/dsh-session-title":"^0.1.1-rc.2","@deepseek-ai/dsh-client-runtime":"^0.1.1-rc.2","@deepseek-ai/dsh-host-webserver":"^0.1.1-rc.2","@deepseek-ai/dsh-client-ui-slots":"^0.1.1-rc.2","@deepseek-ai/dsh-client-ui-sidebar":"^0.1.1-rc.2","@deepseek-ai/dsh-agent-default-model":"^0.1.1-rc.2","@deepseek-ai/dsh-session-persistence":"^0.1.1-rc.2","@deepseek-ai/dsh-client-ui-primitives":"^0.1.1-rc.2"},"peerDependencies":{"@deepseek-ai/cordis":">=4.0.1 <5","@deepseek-ai/dsh-llm":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/dsh-agent":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/dsh-session":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/schemastery":">=3.18.1 <4","@deepseek-ai/dsh-workspace":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/dsh-mcp-client":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-agent-presets":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/dsh-client-locale":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-session-title":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/dsh-client-runtime":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-host-webserver":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-client-ui-sidebar":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-agent-default-model":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/dsh-session-persistence":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/dsh-client-ui-primitives":">=0.1.1-rc.2 <0.2.0"},"_npmOperationalInternal":{"tmp":"tmp/dsh-with-chatgpt_0.1.2_1787500603116_0.2367580966213101","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@beforewave/dsh-with-chatgpt","version":"0.1.3","keywords":["chatgpt","mcp","dsh","deepseek","coding-agent"],"license":"MIT","_id":"@beforewave/dsh-with-chatgpt@0.1.3","maintainers":[{"name":"tonyzhu","email":"zhutaoisme@gmail.com"}],"homepage":"https://github.com/BeforeWave/dsh-with-chatgpt#readme","bugs":{"url":"https://github.com/BeforeWave/dsh-with-chatgpt/issues"},"bin":{"dsh-with-chatgpt":"lib/cli.js"},"dsh":{"bundle":{"patch":"./cordis.patch.yml"},"client":{"inject":["@deepseek-ai/dsh-client-runtime","@deepseek-ai/dsh-client-ui-sidebar","@deepseek-ai/dsh-client-locale","@deepseek-ai/dsh-client-ui-primitives"],"platform":"web"}},"dist":{"shasum":"776a802d28354cbfd3faf786b46f3abf688dcd7d","tarball":"https://registry.npmjs.org/@beforewave/dsh-with-chatgpt/-/dsh-with-chatgpt-0.1.3.tgz","fileCount":37,"integrity":"sha512-TCXtM1/rEF7akx8M1ILioyEWiLfmZrSqR3zF7HoTkwQXWwc1aFhaJfAnq4GXl7Q3Ax4A7NA6C02V+WUZQdyRqQ==","signatures":[{"sig":"MEQCIG1rrWk+om+bE9/hjmOMEDhtuScMLDaGLmtscWbdY0QHAiBuuyMofoD9pJx2wfjnnCZF09FvllhxAU17aAytr7f+nw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":5329831},"main":"./lib/index.js","type":"module","types":"./lib/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./lib/index.d.ts","default":"./lib/index.js"},"./client":{"types":"./lib/client.d.ts","default":"./lib/client.js"},"./runtime":{"types":"./lib/runtime/index.d.ts","default":"./lib/runtime/index.js"},"./package.json":"./package.json"},"gitHead":"d3880b69e4eb4dc038149074db3c82edf4ec0d8f","scripts":{"test":"node --test tests/*.test.mjs","build":"npm run clean && tsc -p tsconfig.json --emitDeclarationOnly && esbuild src/index.ts --bundle --platform=node --format=esm --target=node22 --minify --outfile=lib/index.js --external:@deepseek-ai/* --external:@beforewave/agent-helm && esbuild src/runtime/index.ts --bundle --platform=node --format=esm --target=node22 --minify --outfile=lib/runtime/index.js --external:@beforewave/agent-helm && esbuild src/standalone/plugin.ts --bundle --platform=node --format=esm --target=node22 --minify --outfile=lib/standalone-host.js --external:@deepseek-ai/* --external:@beforewave/agent-helm && esbuild src/standalone/cli.ts --bundle --platform=node --format=esm --target=node22 --minify --outfile=lib/cli.js && node scripts/build-client.mjs && node scripts/build-standalone.mjs","clean":"node --input-type=module -e \"import {rmSync} from 'node:fs'; rmSync('lib',{recursive:true,force:true})\"","pretest":"npm run build","typecheck":"tsc -p tsconfig.json --noEmit","standalone":"node lib/cli.js standalone"},"_npmUser":{"name":"tonyzhu","email":"zhutaoisme@gmail.com"},"agentHelm":{"ownership":"integration"},"deprecated":"Broken release. Please upgrade to a newer version.","repository":{"url":"git+https://github.com/BeforeWave/dsh-with-chatgpt.git","type":"git"},"_npmVersion":"10.9.8","description":"Primary DSH entry for using ChatGPT with local code, Agent Helm engineering capabilities, and native DSH sessions.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@beforewave/agent-helm":"0.1.3","@beforewave/agent-helm-ui-contract":"0.1.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"react":"^18.2.0","esbuild":"^0.25.0","react-dom":"^18.2.0","typescript":"^5.9.0","@types/node":"^24.0.0","@types/react":"~18.3.1","@deepseek-ai/cordis":">=4.0.1 <5","@deepseek-ai/dsh-llm":"^0.1.1-rc.2","@deepseek-ai/dsh-agent":"^0.1.1-rc.2","@deepseek-ai/dsh-tools":"^0.1.1-rc.2","@deepseek-ai/dsh-session":"^0.1.1-rc.2","@deepseek-ai/schemastery":">=3.18.1 <4","@deepseek-ai/dsh-workspace":"^0.1.1-rc.2","@deepseek-ai/dsh-mcp-client":"^0.1.1-rc.2","@deepseek-ai/dsh-agent-presets":"^0.1.1-rc.2","@deepseek-ai/dsh-client-locale":"^0.1.1-rc.2","@deepseek-ai/dsh-session-title":"^0.1.1-rc.2","@deepseek-ai/dsh-system-prompt":"^0.1.1-rc.2","@deepseek-ai/dsh-client-runtime":"^0.1.1-rc.2","@deepseek-ai/dsh-host-webserver":"^0.1.1-rc.2","@deepseek-ai/dsh-client-ui-slots":"^0.1.1-rc.2","@deepseek-ai/dsh-client-ui-theme":"^0.1.1-rc.2","@deepseek-ai/dsh-client-ui-sidebar":"^0.1.1-rc.2","@deepseek-ai/dsh-agent-default-model":"^0.1.1-rc.2","@deepseek-ai/dsh-session-persistence":"^0.1.1-rc.2","@deepseek-ai/dsh-client-ui-primitives":"^0.1.1-rc.2"},"peerDependencies":{"@deepseek-ai/cordis":">=4.0.1 <5","@deepseek-ai/dsh-llm":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/dsh-agent":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/dsh-tools":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-session":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/schemastery":">=3.18.1 <4","@deepseek-ai/dsh-workspace":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/dsh-mcp-client":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-agent-presets":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/dsh-client-locale":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-session-title":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/dsh-system-prompt":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-client-runtime":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-host-webserver":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-client-ui-sidebar":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-agent-default-model":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/dsh-session-persistence":">=0.1.0-rc.6 <0.2.0","@deepseek-ai/dsh-client-ui-primitives":">=0.1.1-rc.2 <0.2.0"},"_npmOperationalInternal":{"tmp":"tmp/dsh-with-chatgpt_0.1.3_1788271381065_0.7816755573416372","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@beforewave/dsh-with-chatgpt","version":"0.1.4","description":"Primary DSH entry for using ChatGPT with local code, Agent Helm engineering capabilities, and native DSH sessions.","license":"MIT","repository":{"type":"git","url":"git+https://github.com/BeforeWave/dsh-with-chatgpt.git"},"homepage":"https://github.com/BeforeWave/dsh-with-chatgpt#readme","bugs":{"url":"https://github.com/BeforeWave/dsh-with-chatgpt/issues"},"keywords":["chatgpt","mcp","dsh","deepseek","coding-agent"],"type":"module","main":"./lib/index.js","types":"./lib/index.d.ts","exports":{".":{"types":"./lib/index.d.ts","default":"./lib/index.js"},"./package.json":"./package.json","./client":{"types":"./lib/client.d.ts","default":"./lib/client.js"},"./runtime":{"types":"./lib/runtime/index.d.ts","default":"./lib/runtime/index.js"}},"publishConfig":{"access":"public"},"dsh":{"bundle":{"patch":"./cordis.patch.yml"},"client":{"inject":["@deepseek-ai/dsh-client-runtime","@deepseek-ai/dsh-client-ui-sidebar","@deepseek-ai/dsh-client-locale","@deepseek-ai/dsh-client-ui-primitives"],"platform":"web"}},"dependencies":{"@beforewave/agent-helm":"0.1.4","@beforewave/agent-helm-ui-contract":"0.1.4","@anthropic-ai/sandbox-runtime":"^0.0.74","@modelcontextprotocol/sdk":"1.30.0"},"peerDependencies":{"@deepseek-ai/cordis":">=4.0.1 <5","@deepseek-ai/dsh-agent":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-agent-default-model":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-agent-presets":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-llm":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-session":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-session-persistence":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-session-title":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-workspace":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/schemastery":">=3.18.1 <4","@deepseek-ai/dsh-host-webserver":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-mcp-client":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-client-runtime":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-client-ui-sidebar":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-client-locale":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-client-ui-primitives":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-system-prompt":">=0.1.1-rc.2 <0.2.0","@deepseek-ai/dsh-tools":">=0.1.1-rc.2 <0.2.0"},"engines":{"node":">=22"},"agentHelm":{"ownership":"integration"},"peerDependenciesMeta":{"@deepseek-ai/cordis":{"optional":true},"@deepseek-ai/dsh-agent":{"optional":true},"@deepseek-ai/dsh-agent-default-model":{"optional":true},"@deepseek-ai/dsh-agent-presets":{"optional":true},"@deepseek-ai/dsh-llm":{"optional":true},"@deepseek-ai/dsh-session":{"optional":true},"@deepseek-ai/dsh-session-persistence":{"optional":true},"@deepseek-ai/dsh-session-title":{"optional":true},"@deepseek-ai/dsh-workspace":{"optional":true},"@deepseek-ai/schemastery":{"optional":true},"@deepseek-ai/dsh-host-webserver":{"optional":true},"@deepseek-ai/dsh-mcp-client":{"optional":true},"@deepseek-ai/dsh-client-runtime":{"optional":true},"@deepseek-ai/dsh-client-ui-sidebar":{"optional":true},"@deepseek-ai/dsh-client-locale":{"optional":true},"@deepseek-ai/dsh-client-ui-primitives":{"optional":true},"@deepseek-ai/dsh-system-prompt":{"optional":true},"@deepseek-ai/dsh-tools":{"optional":true}},"gypfile":false,"_id":"@beforewave/dsh-with-chatgpt@0.1.4","gitHead":"4551263092ea8f26c83a1286e752df34e2f88da8","_integrity":"sha512-05J6shh1UFCsYbPRJiTeXh2OmAbmwBk0TREoOb/J+mzADo3dkORx9856EcWMK/WUkSSUCma/5pjMGNulisK5Lw==","_resolved":"/Users/tonyzhu/Workspace/AIGC/beforewave/agent-chatgpt-helm/agent-chatgpt-helm/.project-env/release/workspace/dist/release-formal-0.1.4/npm/beforewave-dsh-with-chatgpt-0.1.4.tgz","_from":"file:/Users/tonyzhu/Workspace/AIGC/beforewave/agent-chatgpt-helm/agent-chatgpt-helm/.project-env/release/workspace/dist/release-formal-0.1.4/npm/beforewave-dsh-with-chatgpt-0.1.4.tgz","_nodeVersion":"22.23.2","_npmVersion":"10.9.8","dist":{"integrity":"sha512-05J6shh1UFCsYbPRJiTeXh2OmAbmwBk0TREoOb/J+mzADo3dkORx9856EcWMK/WUkSSUCma/5pjMGNulisK5Lw==","shasum":"cee11a88c829ddaef33c0d76bc4541334b33800a","tarball":"https://registry.npmjs.org/@beforewave/dsh-with-chatgpt/-/dsh-with-chatgpt-0.1.4.tgz","fileCount":18,"unpackedSize":238592,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIC+9I6/RH1wqzItHiw9rSyUWriS4zuz6Ea3uRo9vHVXeAiAdnMFnHmz/1rkqeyfG+3Es2MYmfxp74BRhIdJn1jdo3Q=="}]},"_npmUser":{"name":"tonyzhu","email":"zhutaoisme@gmail.com"},"directories":{},"maintainers":[{"name":"tonyzhu","email":"zhutaoisme@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/dsh-with-chatgpt_0.1.4_1789024150439_0.9085250801555027"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-23T15:56:42.955Z","modified":"2026-09-10T07:09:10.767Z","0.1.2":"2026-08-23T15:56:43.285Z","0.1.3":"2026-09-01T14:03:01.227Z","0.1.4":"2026-09-10T07:09:10.563Z"},"bugs":{"url":"https://github.com/BeforeWave/dsh-with-chatgpt/issues"},"license":"MIT","homepage":"https://github.com/BeforeWave/dsh-with-chatgpt#readme","keywords":["chatgpt","mcp","dsh","deepseek","coding-agent"],"repository":{"type":"git","url":"git+https://github.com/BeforeWave/dsh-with-chatgpt.git"},"description":"Primary DSH entry for using ChatGPT with local code, Agent Helm engineering capabilities, and native DSH sessions.","maintainers":[{"name":"tonyzhu","email":"zhutaoisme@gmail.com"}],"readme":"<p align=\"right\">\n  <a href=\"./README.md\"><b>English</b></a> | <a href=\"./README.zh-CN.md\">中文</a>\n</p>\n\n# DSH with ChatGPT\n\n> **Bring ChatGPT's reasoning into your local codebase: resolve small tasks instantly, delegate large executions to DSH.**\n\n**DSH with ChatGPT** bridges ChatGPT directly to your local workspace and native DeepSeek Harness (DSH) execution sessions.\n\nInstead of pasting raw snippets into chat boxes, ChatGPT gains full awareness of your actual project context—reading repository structures, tracing symbols and references, inspecting diagnostics, and performing deep architectural reasoning.\n\nFor targeted, scoped modifications, ChatGPT acts directly. For heavy, iteration-dense workflows, ChatGPT analyzes the context, Formulates an execution plan, hands off implementation to DSH, and independently reviews the results upon completion.\n\n```text\n                         ChatGPT\n               Understand · Reason · Review\n                            │\n                  Secure MCP Tunnel\n                            │\n                            ▼\n                        Agent Helm\n                       /          \\\n                      /            \\\n            Work Directly       Delegate\n                 │                 │\n                 ▼                 ▼\n           Local Codebase          DSH\n                 ▲          Edit · Run · Test\n                 │          (Take over anytime)\n                 └─────────────────┘\n\n```\n\n---\n\n## Key Features\n\n* **Deep Codebase Understanding:** Reads actual repository structures, symbols, cross-file references, and build diagnostics directly without manual code copying.\n* **Direct Scoped Execution:** Handles quick fixes, refactoring, and code validation directly without overhead.\n* **Smart Delegation & Instant Takeover:** Offloads build, test, and multi-file editing loops to native DSH sessions—**which you can jump in, steering, or fully take over at any second**.\n* **Independent Code Review:** Performs post-execution reviews against raw git diffs and edited files to detect missing edge cases, regressions, or test gaps.\n\n---\n\n## How It Works\n\n**Focused & Scoped Tasks:**\n\n```text\nChatGPT ──► Agent Helm ──► Inspect · Reason · Edit · Verify\n\n```\n\n**Complex & Sustained Tasks:**\n\n```text\nChatGPT ──► Inspect & Plan ──► Delegate to DSH ──► Native DSH Session ──► ChatGPT Review\n                                                        ▲\n                                              (You can take over anytime)\n\n```\n\n---\n\n## Prerequisites\n\nDSH with ChatGPT relies on the following runtime components:\n\n* **Node.js**: v22+\n* **DeepSeek Harness**: (`dsh`)\n* **Serena**: Code intelligence provider\n* **OpenAI Tunnel Client**: `tunnel-client`\n\n> **Note:** Manual installation of these dependencies is not required up front. DSH with ChatGPT automatically inspects your environment, prompts for missing dependencies, and offers one-click setup where supported. For manual configuration details, refer to the [Setup Guide](https://gist.github.com/tonyzhu/d7ad8c84a90ea04e5c853a3cfe4df099#file-readme-zh-cn-md).\n\n---\n\n## Installation\n\nStable npm release:\n\n```bash\ndsh plugin --profile web add @beforewave/dsh-with-chatgpt\n```\n\nTo install a specific stable npm version:\n\n```bash\ndsh plugin --profile web add @beforewave/dsh-with-chatgpt@0.1.4\n```\n\nGitHub bootstrap:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/BeforeWave/dsh-with-chatgpt/main/install.sh | sh\n```\n\nSpecific version:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/BeforeWave/dsh-with-chatgpt/main/install.sh | sh -s -- 0.1.4\n```\n\nThe GitHub bootstrap first checks that `dsh` is installed. It then resolves the selected GitHub Release, downloads and SHA-256 verifies that Release's DSH tgz, and installs the local tgz with `dsh plugin --profile web add`. This GitHub path never queries npm; the npm command above is a separate stable channel.\n\nThe GitHub tgz bundles the exact `@beforewave/agent-helm` and `@beforewave/agent-helm-ui-contract` versions declared by the plugin. Third-party dependencies continue to resolve from the normal registry.\n\nStart DSH:\n\n```bash\ndsh web\n```\n\nUpon launch, the plugin verifies the environment and guides you through remaining initializations.\n\n---\n\n## Connecting ChatGPT\n\nThe plugin uses **OpenAI Secure MCP Tunnel** to connect ChatGPT securely to your local `Agent Helm` runtime.\n\n```text\nChatGPT ──► Secure MCP Tunnel ──► tunnel-client ──► Agent Helm ──► Local Workspace / DSH\n\n```\n\n### Configuration Steps\n\n1. Obtain your OpenAI Secure MCP Tunnel details:\n* **Tunnel ID**\n* **Runtime API Key** (with `Tunnels Read` and `Tunnels Use` permissions)\n\n\n2. Set credentials in your environment:\n```bash\nexport CONTROL_PLANE_TUNNEL_ID=\"tunnel_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\nexport CONTROL_PLANE_API_KEY=\"sk-...\"\n\n```\n\n\n3. Configure ChatGPT:\n* Enable **Developer Mode** in ChatGPT.\n* Navigate to **Settings** -> **Apps / Connectors** -> **Add Custom Connector**.\n* Select **Tunnel** as the connection type.\n* Choose the corresponding Secure MCP Tunnel instance.\n\n\n\n---\n\n## Usage Examples\n\n### 1. Direct Troubleshooting & Quick Fixes\n\n```text\nInvestigate why this authentication flow occasionally refreshes twice.\nTrace the relevant execution paths in the real codebase, explain the root cause,\nand then directly fix and verify it.\n\n```\n\n### 2. Delegating Complex Features to DSH\n\n```text\nRead the current implementation and analyze how to integrate this feature.\nOnce you understand the architecture, hand off the implementation to DSH.\nPerform an independent review after DSH completes the task.\n\n```\n\n### 3. Post-Execution Review\n\n```text\nReview the changes DSH just completed.\nInspect the actual modified files and git diff independently to check for\ncorrectness, regressions, missing edge cases, and test coverage.\n\n```\n\n---\n\n## Native DSH Integration: Full Control & Instant Takeover\n\nDelegating tasks to DSH never means losing visibility or control. Every delegated task runs inside a **first-class, native DeepSeek Harness session**.\n\n> **⚡ Take Over Anytime:** DSH is not a hidden background black box. You can jump into the DSH Web UI at any second to watch live execution, edit code manually, steer the agent, or take full manual control of the session without breaking context.\n\nThrough the DSH Web UI, you can:\n\n* **Live Monitoring & Steering:** Track real-time agent logs and interrupt or redirect execution whenever necessary.\n* **Instant Manual Takeover:** Jump directly into the interactive terminal/session and take control at any point.\n* **Preserve Full Context:** Retain complete DSH state, session history, and workspace modifications seamlessly.\n\n---\n\n## Underlying Architecture: Agent Helm\n\n[`@beforewave/agent-helm`](https://www.npmjs.com/package/@beforewave/agent-helm) serves as the local capability layer powering the plugin. It exposes the following tools to ChatGPT:\n\n* File system and repository inspection\n* Symbol and reference navigation\n* Code intelligence and diagnostics (powered by **Serena**)\n* Scoped file editing and command execution\n* Local agent session delegation\n\n*Agent Helm can run as a standalone local capability layer or be managed automatically by the DSH plugin.*\n\n---\n\n## Packages\n\n| Package | Role |\n| --- | --- |\n| **`@beforewave/dsh-with-chatgpt`** | DSH plugin integration and user experience layer |\n| **`@beforewave/agent-helm`** | Core local capability engine for code navigation, execution, and agent bridge |\n\n---\n\n## Project Status\n\nDSH with ChatGPT and Agent Helm are under active development.\n\n> **Let ChatGPT understand the real project, work directly when appropriate, and bring that reasoning to DSH when larger execution is needed.**\n","readmeFilename":"README.md"}