repowisedeepseek-ai/deepseek-harness

Architecture of deepseek-ai/deepseek-harness

deepseek-ai/deepseek-harness is 17,318 source files holding 48,698 symbols across 11 modules, written mainly in TypeScript, JavaScript, Python. The largest module is packages, with 5,107 files, and 380 files are entry points into the dependency graph.

How deepseek-harness fits together

Input enters through one of the front ends: the CLI entry point at apps/cli/src/bin.ts, the desktop app started from apps/desktop/src/main.ts, or the Web UI started with the dsh web command. The core work happens in the agent loop defined in packages/core/agent-loop/src/agent.ts, which calls DeepSeek models and sandboxed tools for each session. The packages directory is the largest part of the repository, with 5107 files, and holds the core modules and extensions that the loop and the front ends build on. Because everything is a plugin, features are added as plugins built on Cordis. The scripts directory holds the scripts that generate, check and verify the documentation and packaged output, reading the source tree and writing catalog pages or reporting violations. Each session ends with persisted conversations, file deliverables and session logs.

Largest modules

  • packages: 5,107 files and 894,938 lines of code
  • apps: 779 files and 116,993 lines of code
  • scripts: 366 files and 70,268 lines of code
  • snapshots: 53 files and 4,323 lines of code
  • benchmarks: 34 files and 5,031 lines of code
  • python: 29 files and 4,772 lines of code
  • native: 23 files and 2,064 lines of code
  • website: 18 files and 3,084 lines of code

Languages

By file count: TypeScript 6,158 files, JavaScript 145 files, Python 54 files, Swift 50 files, C++ 14 files, Shell 9 files.

Documentation

Repowise documents deepseek-harness in 5,212 pages generated from the source, 45 of them written explanations of the repository and its modules. Module guides include:

  • packages/api: Api Packages (9)
  • packages/api/session-controller: Api Session Controller
  • root: Application Root

More on deepseek-harness: summary and FAQ, codebase overview, code health.

Related guide: Best dependency graph tools for monorepos