linconz/agentduel-dsh

AgentDuel DSH

中文 | English

AgentDuel is a code-based combat game. Put simply, you write Agent code yourself (or have AI help you write it), submit that code to AgentDuel, start matches, watch replays, identify problems, and keep improving your code on your way to the top of the ranked ladder.

AgentDuel is not about who can improvise the best prompts. It is about who can build the smarter Agent.

Once a match begins, both players' code runs in identical sandbox environments. Based on what their Agents can see and the state of the game, they decide how to move, attack, cast abilities, or capture the flag. Every match produces a complete replay, so you can see what your Agent saw and decided each turn, and understand how a match was won or lost.

How AgentDuel and DeepSeek Harness work together

When AgentDuel first launched, the website already offered prompts that could be copied with one click into autonomous Agent tools such as Codex, Claude Code, and WorkBuddy. Those tools could read the rules, write code, and submit it, but the overall workflow still felt fragmented.

You had to view characters and matches in AgentDuel, copy a prompt into another tool, wait for AI to revise the code, then return to the website to submit it and start a match. After the match, you also had to open the replay, assemble the match information, and switch back to the AI tool for further analysis. Each tool could do its part, but you had to keep passing information between them.

DeepSeek Harness makes this workflow feel more natural. Built on an everything-is-a-plugin architecture, the AgentDuel DSH plugin connects AgentDuel's game features with DSH's code Agent capabilities.

Their responsibilities are clear:

• AgentDuel is the arena. It handles game rules, code execution, opponent matchmaking, match results, ranked ratings, and replays.
• DeepSeek Harness is the Agent's workspace. It reads code directories, invokes models, changes code strategies, runs tests, and preserves the optimization process.
• The AgentDuel DSH plugin bridges the two. It lets you manage characters and teams, start matches, watch replays, and have AI continue optimizing your code based on real match results, all within DeepSeek Harness.

AgentDuel does not depend on DeepSeek Harness to run, and DeepSeek Harness does not simulate battles. Once the plugin is installed, AgentDuel becomes a native capability in DeepSeek Harness, bringing tasks that were previously split between the website and coding tools into one interface.

How to play

The first time you use it, sign in to AgentDuel to create an App Key, then configure it in the plugin. You can then get started with the following workflow:

1. Create a character or team

   Choose a 1v1 deathmatch character or build a 2v2 capture-the-flag team, then set its class, name, and entry information.

2. Prepare your Agent code

   In DSH, select the workspace where your Agent code is stored. You can write the code yourself, or start an optimization conversation and let DSH read the AgentDuel rules and produce an initial strategy.

3. Submit your code

   Once the code passes validation, submit it for the selected character or team. From then on, that code becomes the character's decision-making brain in battle.

4. Start a match

   You can begin with a random practice match or search for and challenge a specific opponent. Once your strategy is stable, enter ranked matches to compete for rating and rank.

5. Watch the replay and keep optimizing

   After a match ends, open the replay in the plugin to inspect the map, action log, and key turns. If you are not sure what went wrong, create a DSH conversation and have AI analyze the match, then update and test the code in your current workspace.

The full loop is:

Create a character or team → write and submit code → start a match → watch the replay → analyze the problem → optimize the code → battle again

This is where much of AgentDuel's appeal lies. What you submit is not a program that is finished once written, but an Agent that grows stronger through real matches. Losing a match is not the end; it provides a new test result for the next revision.

Installation

This version targets DeepSeek Harness dsh-v0.1.2-alpha.4 and later.

Install from source

git clone https://github.com/linconz/agentduel-dsh.git
cd agentduel-dsh
pnpm install
pnpm run build
dsh plugin --profile web add .

Install from the npm registry

dsh plugin --profile web install @agentduel/agentduel-dsh@0.1.5

Start DSH

dsh web

Remove the local plugin:

dsh plugin --profile web remove @agentduel/agentduel-dsh

Community

Join our QQ group to discuss gameplay and competitive strategies: 1070277746, or join the Discord community.