English | δΈζ
# DSH with ChatGPT
**Say goodbye to copy-pasting and DSH Token anxiety. Let ChatGPT on the web connect directly to your local project, code on its own, and hand complex tasks to DSH for sustained execution.**
[](https://www.npmjs.com/package/@beforewave/dsh-with-chatgpt)
[](#-quick-start)
[](./LICENSE)
Try
Agent Helm Extensions Β· ChatGPT + local agents
|
Agent Helm Β· local runtime
---
## π‘ Why DSH with ChatGPT?
ChatGPT on the web has strong models, but it normally cannot access your local project, files, or terminal.
DSH can operate directly on your codebase, but a large amount of Token usage can go into reading the project, understanding context, analyzing the problem, and repeatedly confirming details.
**DSH with ChatGPT** connects both sides:
* **Let ChatGPT code directly:** Read and modify local files, run terminal commands, inspect Diagnostics and Git state, and execute builds and tests.
* **Reduce DSH Token usage:** Let ChatGPT handle project understanding, problem analysis, small changes, and result review, leaving DSH Tokens for tasks that truly need sustained execution.
* **Hand complex tasks directly to DSH:** ChatGPT can send an already-understood task directly into a native DSH Session, without making DSH start from the beginning.
* **Review after execution:** When DSH finishes, ChatGPT can inspect the real code, Diff, and test results again.
* **Native Sessions, ready for takeover:** Tasks created by ChatGPT are normal DSH Sessions that you can inspect, continue, or take over directly in DSH Web.
---
## β‘ Quick Start
### 1. Install the Plugin
**Stable npm release:**
```bash
dsh plugin --profile web add @beforewave/dsh-with-chatgpt
```
> Install a specific version:
> `dsh plugin --profile web add @beforewave/dsh-with-chatgpt@0.1.4`
**macOS / Linux:**
```bash
curl -fsSL https://raw.githubusercontent.com/BeforeWave/dsh-with-chatgpt/main/install.sh | sh
```
> Install a specific version:
> `curl -fsSL https://raw.githubusercontent.com/BeforeWave/dsh-with-chatgpt/main/install.sh | sh -s -- 0.1.4`
**Windows x64:**
```powershell
irm https://raw.githubusercontent.com/BeforeWave/dsh-with-chatgpt/main/install.ps1 | iex
```
> Install a specific version:
> `& ([scriptblock]::Create((irm https://raw.githubusercontent.com/BeforeWave/dsh-with-chatgpt/main/install.ps1))) -Version 0.1.4`
The GitHub installer checks for DSH, downloads and verifies the matching Release Plugin package, then installs it through `dsh plugin add`.
---
### 2. Start DSH
```bash
dsh web
```
---
### 3. Complete Setup
On first run, DSH with ChatGPT checks the current environment and uses the **Setup Guide** to walk you through the required installation, ChatGPT Tunnel, and permission setup.
Once setup is complete, return to `chatgpt.com` and start working directly with your local project.
---
## π οΈ Workflow & Core Features
### 1. Let ChatGPT Work Directly on Local Projects
Through Agent Helm, ChatGPT can directly:
* Understand the project structure
* Find and read code
* Modify local files
* Run terminal commands and development tools
* Inspect Diagnostics and Git state
* Run builds and tests
* Check real execution results
Small changes, bug investigation, code understanding, and verification can be handled directly by ChatGPT.
### 2. Hand Heavy Tasks to DSH
When a task requires extensive edits, builds, tests, or sustained execution, ChatGPT can create a native DSH Session directly.
```text
ChatGPT
β
βββ Understand Project
βββ Analyze Problem
βββ Edit & Verify Directly
β
βββ Complex Task βββΊ DSH Session
β
Edit Β· Run Β· Test
β
βΌ
ChatGPT Review
```
DSH receives a task and working context that have already been clarified, leaving more Tokens for actual execution.
### 3. Native DSH Sessions, Ready for Takeover
Tasks created through ChatGPT remain full DSH Sessions.
From DSH Web, you can directly:
* Inspect the Agent's current execution status
* Review activity and results
* Continue interacting with DSH
* Edit code manually
* Take over the Session at any time
ChatGPT and DSH stay connected to the same real piece of work.
---
## π View ChatGPT Work Inside DSH
DSH with ChatGPT adds a lightweight entry inside DSH for viewing the local work associated with ChatGPT:
* ChatGPT Conversation
* Project / Worktree
* Local actions performed by ChatGPT
* Current work status
* Recent execution activity
* Associated DSH Session
This entry is used to view and manage ChatGPT's local work without changing how native DSH Sessions work.
---
## π Work History
Work performed by ChatGPT and DSH is retained in Work History:
* Associated ChatGPT Conversation
* Project / Worktree
* Local actions performed by ChatGPT
* DSH Session
* Current or final status
* Recent execution activity
Even after leaving the original Conversation, you can return later and find the work again.
---
## π Local Projects & Security
Your projects and actual execution environment remain on your local machine:
* **Permission control:** Which projects ChatGPT can access and which operations it can perform are determined by the permissions and capabilities granted to the current Workspace.
* **Sandbox:** When ChatGPT performs local operations directly, it runs under Agent Helm permissions and Sandbox protection.
* **Native DSH permissions:** Once a task is handed to DSH, it runs under the permissions and Sandbox configuration of the corresponding DSH Session.
---
## π Related Projects
| Project | Relationship to this project |
| ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Agent Helm](https://github.com/BeforeWave/agent-helm) | The local runtime used by this project, providing ChatGPT with code intelligence, file and command operations, Sandbox protection, and DSH Session collaboration. |
| [Agent Helm Extensions](https://github.com/BeforeWave/agent-helm-extensions) | Agent Helm's Chrome Extension, letting ChatGPT use local projects and Coding Agents directly from the browser. |
---
## π Project Status
DSH with ChatGPT is under active development and iteration. Issues and Pull Requests are welcome.