# AI use cases for DeepSeek Harness (deepseek-ai/deepseek-harness) Repo: [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) | Use cases: 4 | Page: https://dedupedai.com/use-cases/deepseek-ai-deepseek-harness/ DeepSeek Harness (dsh) is an open-source agent harness built on an everything-is-a-plugin architecture using Cordis, with a local Web UI. This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL. - Start the DeepSeek Harness Web UI with one command: https://dedupedai.com/use-cases/deepseek-ai-deepseek-harness/run-dsh-web-ui-locally/ - Build and run the harness from a git checkout: https://dedupedai.com/use-cases/deepseek-ai-deepseek-harness/run-dsh-from-source-checkout/ - Have a coding agent make a change under the repo's rules: https://dedupedai.com/use-cases/deepseek-ai-deepseek-harness/contribute-changes-with-agent-rules/ - Write a plugin for the everything-is-a-plugin harness: https://dedupedai.com/use-cases/deepseek-ai-deepseek-harness/build-plugin-for-dsh/ ## How to start the DeepSeek Harness Web UI with one command with DeepSeek Harness Repo: [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) | Difficulty: Beginner | Time: 15 minutes | Basis: From the README Launch the dsh Web UI on your own machine with a single npx command. **Who it is for:** A developer or operator who wants to try the agent harness locally without setting up a repository. **The problem:** Setting up an agent harness usually means cloning code and building it before anything runs. **The outcome:** The Web UI runs at http://127.0.0.1:3080 on your machine and you can open it in a browser. ### Steps 1. Install Node.js. 2. Read SAFETY.md in the repository and confirm you accept the safety notice. 3. Run `npx @deepseek-ai/dsh web` 4. If you do not want a browser window to open, run `npx @deepseek-ai/dsh web --no-open` and open http://127.0.0.1:3080 yourself. (inferred, check the README) ### Prompt to paste into your agent ```text In the deepseek-harness project, run `npx @deepseek-ai/dsh web --no-open` on and report the local URL the server prints. Verify that http://127.0.0.1:3080 returns the Web UI page before reporting success. ``` ### Caveat The project is in developer preview and the README warns that compatibility-breaking changes will happen. Risk, remote script: npx downloads and runs the published @deepseek-ai/dsh package, so read SAFETY.md before running it. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/deepseek-ai-deepseek-harness/run-dsh-web-ui-locally/ ## How to build and run the harness from a git checkout with DeepSeek Harness Repo: [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README Clone the repository, install dependencies, build the artifacts, and start the Web UI from source. **Who it is for:** A developer who wants to read, modify, or debug the harness code instead of using the published package. **The problem:** The npm launch hides the source, so changes to the harness need a local build from the repository. **The outcome:** The Web UI runs from your own build of the repository. ### Steps 1. Install Node.js and pnpm. 2. Run `git clone https://github.com/deepseek-ai/deepseek-harness.git` and then `cd deepseek-harness`. 3. Run `pnpm install`, then `pnpm run build`. 4. Run `pnpm dsh web` to start the Web UI using the built artifacts. ### Prompt to paste into your agent ```text Clone https://github.com/deepseek-ai/deepseek-harness into , run `pnpm install` and `pnpm run build`, then `pnpm dsh web`. Report whether the build finished without errors and the URL the Web UI is served on. ``` ### Caveat The README says `pnpm dsh web` uses existing build artifacts without rebuilding, so run `pnpm run build` again after source changes. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/deepseek-ai-deepseek-harness/run-dsh-from-source-checkout/ ## How to have a coding agent make a change under the repo's rules with DeepSeek Harness Repo: [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) | Difficulty: Advanced | Time: 45 minutes | Basis: From the README Point an agent at AGENTS.md and CONTRIBUTING.md so its edits follow project guidance. **Who it is for:** A maintainer or contributor who wants an AI coding agent to make a scoped change to the harness. **The problem:** An agent working in an unfamiliar repository may skip project conventions, build steps, or contribution rules. **The outcome:** The agent makes a change that follows AGENTS.md, and you can check it with the build and the dev watch command. ### Steps 1. Clone the repository and run `pnpm install`. 2. Read AGENTS.md and CONTRIBUTING.md before asking the agent to edit code. 3. Ask the agent to make the change described in your task, then run `pnpm run build`. 4. Run `pnpm run dev:web` to rebuild client bundles on source edits while you check the Web UI. ### Prompt to paste into your agent ```text In the deepseek-harness repository, read AGENTS.md and CONTRIBUTING.md first, then make without touching unrelated files. Run `pnpm run build` and report the result and the files changed. ``` ### Caveat The README says there will be compatibility-breaking changes, so an agent's change may need rework after upstream updates. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/deepseek-ai-deepseek-harness/contribute-changes-with-agent-rules/ ## How to write a plugin for the everything-is-a-plugin harness with DeepSeek Harness Repo: [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) | Difficulty: Advanced | Time: 90 minutes | Basis: From the README Build a plugin on the harness architecture and publish it with the dsh-plugin topic. **Who it is for:** A developer who wants to add a capability to DeepSeek Harness and share it with other users. **The problem:** Extending an agent harness usually means forking it, while this one is designed around plugins. **The outcome:** A plugin repository that is discoverable through the dsh-plugin GitHub topic. ### Steps 1. Read the architecture documentation in docs/architecture.md. 2. Read the development guide in docs/development.md. 3. Clone the repository, run `pnpm install`, and run `pnpm run build` to confirm the base project works. 4. Create your plugin repository on GitHub and add the `dsh-plugin` topic to it. ### Prompt to paste into your agent ```text Using docs/architecture.md and docs/development.md in the deepseek-harness repository, draft a plugin in that . Run `pnpm run build` in the base repo and report whether the plugin loads without errors. ``` ### Caveat The README does not document a plugin API, so the architecture and development docs are the only source for plugin details. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/deepseek-ai-deepseek-harness/build-plugin-for-dsh/