dsh-with-chatgpt

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.

Supports macOS, Windows x64, and Linux: Agent Helm runs local commands natively on Windows without WSL2; delegation still requires DSH to be installed locally.

💡 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:

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:

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:

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

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.

Refresh ChatGPT Connector Tools After Upgrading

This MCP Server Integration release changes Agent Helm Core's MCP Tool Schema, replacing external_mcp_search_tools with external_mcp_list_tools. After upgrading and restarting Core, select Refresh Tools in your ChatGPT Custom Connector.

If a tool is missing or its parameters or contract no longer match, verify the Core version and refresh. See the Agent Helm upgrade guide. Refreshing does not remove imported servers or revoke approvals.

🛠️ 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.

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.

🔌 MCP Server Integration

The MCP Servers view in DSH with ChatGPT lets you reuse MCP servers configured in Codex or Claude:

• Manually Scan and Import under Discover MCPs.
• Enable or disable imported servers in My MCP Servers.
• Configure required environment values, HTTP credentials and supported authentication, and inspect connection or discovery failure states.

DSH shares the production management component with Chrome and reads authoritative Agent Helm Core MCP state. ChatGPT uses approved upstream tools through Agent Helm without connecting each server separately.

🔒 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 Status

DSH with ChatGPT is under active development and iteration. Issues and Pull Requests are welcome.