DeepSeek Harness on GitHub: Why the Minimal Mode Wins

I will be honest about my first reaction. When I saw DeepSeek Harness (DSH) trending on GitHub, I assumed it was another AI repository riding a wave of hype.

GitHub star counts can mean several different things. Sometimes they reflect respect for the founder. Sometimes people bookmark a repo to read later and then forget it exists. And sometimes, probably most often, they reflect genuine appreciation for the results.

With DSH, though, I think people were reacting to something stranger than any of that.

Consider the situation. DeepSeek already ships V4-Flash, which performs remarkably well at 300 billion plus parameters while staying cheap and posting a strong cache hit rate. The company is in a strong position. If all it wanted was solid benchmark numbers, it could have taken the safe route: more post-training in the style of Codex or Claude Code. That would have been perfectly respectable.

It did not take that route.

Instead, DeepSeek built a harness with four distinct modes, and the gap between those modes is dramatic.

If the word harness is new to you, the simplest translation is this. The harness is the rig that surrounds the model. The model is the engine. The harness is the steering, the pedals, and the dashboard. Same engine, very different driving experience depending on what you bolt around it.

The minimal mode that beats the fancy one

There is Minimal Mode, which is bare bones: persistent Bash and a str_replace_editor. That is the entire toolset. Two tools. And in some environments, DeepSeek-V4-Pro actually performs best in this stripped-down configuration.

Wait, what?

That flips the usual assumption on its head. More tools equal better, right? That has been the prevailing logic. But when the model itself is already strong, adding tools means more choices, more complex decisions, and more opportunities to go wrong. Sometimes less really is more.

The mode that builds its own tools

Then there is Creative Mode, which pushes all the way to the opposite extreme.

In Creative Mode, the agent can create, modify, and uninstall its own plugins on the fly. It can invent a tool it needs, adjust it when it falls short, or discard it entirely. Need a hammer? Build one. The hammer is not working? Change it, or scrap it and start over.

That is not the standard arrangement. The old model was simple: humans build the tools, models learn to use them. The new model is different: give the model a goal, let it work out which tools it needs, build them, use them, and throw them away when the task is finished.

The part that gets me is the hot-swappable nature of it. Flexibility over structure. Freedom over predictability.

The detail I keep returning to is this: a plugin the agent writes for itself runs with the agent’s permissions. That quietly shifts the security question from “did we review the tools?” to “do we trust the thing that made the tools?” That is not a reason to avoid the approach. It is simply the part I would want spelled out before I let one loose on a repository I care about.

Because flexibility also means chaos. And chaos is the one thing large language models have historically handled poorly. That is exactly why most agents get trained inside structured environments like Codex or Claude Code. Stability matters. Predictability matters.

DeepSeek appears to be asking the opposite question: how much freedom should we grant these models?

The fact that V4-Pro behaves differently across modes tells me the team is probably still working that answer out themselves. This is not a polished product. It reads like an experiment.

Which is why I think the real story here is not the benchmark scores. Benchmarks are temporary. They move every week. The interesting part is the question beneath them: once the model is already this capable, do we still need to dictate how it gets things done? Or should we hand over more control and let it find the path?

If agents eventually move past merely using tools that humans prepared in advance, if they can create, modify, and discard tools based on the task in front of them, then we are no longer building better assistants. We are building something that works things out on its own.

That is a different kind of leap.

I went into more detail on why the agent architecture matters here if you want the longer version.

There is a practical takeaway here for anyone who builds with AI tools. The Minimal Mode result suggests that handing a model every available capability is not automatically better. If your own workflows feel flaky, the fix might be fewer tools and tighter constraints rather than more of them. The teams getting the strongest results from these systems tend to be the ones who trimmed the toolset down to what the task actually requires.

The open-source release changes the calculus as well. Anyone can read how the modes are wired, borrow the parts that work, and ignore the parts that don’t. That is DeepSeek’s real advantage in this case, more than any single score: it invites the rest of us to run the same experiment and reach our own conclusions instead of trusting a vendor’s headline.

If you want a single thing to watch, it is whether V4-Pro’s preference for Minimal Mode holds up outside DeepSeek’s own tests. Reproducibility is the difference between a real finding and a demo, and that is the part still missing.

I am not certain this approach wins out. There is a reason structured agents are the default. They are safer, more reliable, and easier to debug. But watching DeepSeek test the boundary like this makes me wonder if we have been too conservative in how we think about agent design.

One caveat worth stating plainly: I have not actually run DSH myself yet. I am going off what I have read and what people are saying. I could be wrong about parts of it. The direction, though, seems clear enough.

I will keep an eye on where this goes. I might try it next week, and if I do, I will write up what I actually experience rather than what the demos promised.