DeepSeek Harness for JetBrains IDEs

Bring DeepSeek Harness into JetBrains IDEs — chat with your code, review native diffs, and inspect every run.

English | 简体中文

Install plugin · Releases · Feedback · VS Code edition

An independent community plugin for IntelliJ IDEA, PyCharm, and other IntelliJ Platform IDEs. Explain unfamiliar code, investigate a bug, or review a change from the same place you write it.

Quick start

1. Install — in Settings → Plugins → Marketplace, search for DeepSeek Harness Integration, or open the Marketplace page. Restart the IDE if prompted.
2. Connect — open a project and the DSH tool window. For local startup, have Node.js and pnpm or npm/npx available. The plugin starts the Runtime automatically by default. Configure the launch command or an existing Runtime's Server URL in Settings → Tools → DeepSeek Harness.
3. Configure credentials — find DSH: Configure API Key via Find Action. Restart the local Runtime after changing the key so it receives the new value. An existing external Runtime uses its own credentials.
4. Try it — select a function, right-click DSH → Explain Selection, or ask a question in the chat. Inspect tool cards and proposed diffs when an approval is requested.

Requires: IntelliJ Platform 2024.3+ with JCEF (the embedded browser). The build targets IntelliJ IDEA Community and PyCharm Community 2024.3.6 for compatibility verification. Other IntelliJ Platform IDEs need the same platform APIs and JCEF support.

From question to reviewed change

Native diffs, even without Git

Review file edits in the IDE's own diff viewer. For supported tool diff cards, DSH reconstructs before/after content from session history, so the preview does not depend on a Git repository. Proposed edits can be previewed before approval. If later file changes make reconstruction unreliable, the plugin reports that instead of showing a misleading comparison.

Put the right context into the conversation

Use DSH: Ask About Selection for an open-ended question, or the DSH context menu for explain / fix / review / documentation tasks. The context picker also supports attaching the current unstaged Git diff. Editor context is bounded by the configurable byte limit.

Plan before implementing

Use the composer's Plan toggle or /plan to enter plan mode; /plan off leaves it. The toggle changes the session mode without sending a task or consuming attached IDE context. When the agent submits a plan for review, approve it or provide feedback with Continue planning. The subagent tree and preview show active and completed execution time when the Runtime supplies it.

Keep the Runtime close to your tools

The plugin manages local Runtime startup, shutdown, and restart, with pnpm, an installed dsh, and npx launch options. Package-manager launches use the configured Runtime version. You can also connect to an existing Runtime or open its Web UI in a browser.

API keys are stored in IntelliJ Password Safe and passed to a newly started local Runtime. The UI includes English and Simplified Chinese resources.

Configuration

Open Settings | Tools | DeepSeek Harness.

Troubleshooting

Install from a release or build locally

Download the plugin .zip from GitHub Releases, then choose Settings → Plugins → ⚙ → Install Plugin from Disk…. Select the archive without unpacking it.

To build from source, use JDK 21 and the included Gradle wrapper:

./gradlew format         # apply the repository's Java formatting rules
./gradlew lint           # verify formatting and run Checkstyle
./gradlew verifyPlugin   # structure and compatibility checks
./gradlew buildPlugin    # produce the installable zip

On Windows, use gradlew.bat. The first build downloads Gradle and the IntelliJ Platform dependencies.

Data use and privacy

The plugin does not collect telemetry. Prompts and attached context are sent through the DSH Runtime to your configured model provider; that provider's terms and privacy policy apply. API keys stored by the plugin remain in IntelliJ Password Safe and are passed to newly started local Runtime processes.

Feedback and contributing

Report a bug or suggest a feature. For bugs, include your IDE and plugin versions, OS, Runtime version, and reproduction steps. Remove API keys and private code from any logs you share. Documentation improvements and focused pull requests are welcome; see repository rules before contributing.

If DSH helps your workflow, a GitHub star helps others discover it. For release history and attribution, see Releases and Third-party notices.

This community project is not endorsed or maintained by DeepSeek or JetBrains. Licensed under MIT.