SeekFleet

Run agents like a fleet.

Cross-platform control plane for DeepSeek Harness agent fleets — with MCP, durable sessions, adaptive routing, policy gates, token budgets, and a phone-friendly LAN dashboard.

Give an AI the repository URL. It can install the Skill, configure MCP, verify the runtime, and explain exactly what changed.

International overview

The product page includes a persistent language switcher with five localized experiences: 简体中文, English, 日本語, 한국어, and Español. The page detects the browser language automatically, accepts a direct ?lang= link, and remembers the visitor's choice.

The 30-second version

SeekFleet turns DeepSeek Harness from a collection of processes into an observable, governable fleet:

Give this repository to an AI

Copy this prompt as-is:

Install SeekFleet from https://github.com/cndoin/seekfleet.
Read INSTALL.md first, install it for this AI client, configure its MCP server,
and verify the installation without exposing credentials.

The machine-readable contract lives in INSTALL.md. It includes Windows PowerShell, Linux, and macOS paths, user/project Skill scopes, verification, update, and rollback behavior.

Install from source

Requirements: Node.js 20+, npm 10+, and @deepseek-ai/dsh or an explicit DSH_MODULE_ROOT.

git clone https://github.com/cndoin/seekfleet seekfleet
cd seekfleet
npm ci
npm run build
node dist/bin/seekfleet.js skill install --target auto
node dist/bin/seekfleet.js inspect

Install the Skill into every supported AI client:

node dist/bin/seekfleet.js skill install --target all --force

For a project-local Skill, use --scope project; it installs into .agents/skills/seekfleet without changing the user profile.

Start the fleet

node dist/bin/seekfleet.js serve-mcp

Run MCP and the phone dashboard together on a trusted LAN:

node dist/bin/seekfleet.js serve-mcp \
  --dashboard \
  --dashboard-host 0.0.0.0 \
  --dashboard-port 8787

Open the printed URL on a phone connected to the same network. The dashboard is bearer-token protected; do not expose it directly to the public internet.

SDK at a glance

import { SeekFleet } from "seekfleet";

const fleet = new SeekFleet();

const review = await fleet.run("Review this module for race conditions");
console.log(review.answer);

const clusterId = fleet.cluster({
  routing: "adaptive",
  instances: [
    { label: "code-a", tags: ["code"] },
    { label: "code-b", tags: ["code"] },
    { label: "review", tags: ["review"] },
  ],
});

const result = await fleet.clusterRoute(clusterId, {
  task: "Audit the authentication flow",
  tags: ["review"],
  timeoutMs: 120_000,
});

await fleet.clusterShutdown(clusterId);

DshPlugin remains available as a deprecated source-compatibility alias. MCP tool names retain the dsh_* prefix so existing integrations keep working.

Choose your execution mode

Routing strategies include least-loaded, round-robin, tag, adaptive, and random.

Architecture

AI client (Codex / Claude / Cursor / Gemini / Hermes / OpenClaw)
                              │
                         MCP or SDK
                              │
                         SeekFleet
          ┌───────────────────┼───────────────────┐
          │                   │                   │
    Durable sessions     Agent clusters      Policy gate
          │          routing · cache · DAG         │
          └───────────────────┼───────────────────┘
                              │
                     DeepSeek Harness
                              │
                tools · models · subprocesses

Cross-platform configuration

PowerShell:

$env:DSH_MODULE_ROOT = "C:\Tools\deepseek-harness"
$env:DSH_HOME = "$env:USERPROFILE\.dsh"
npm run serve-lan

Bash or zsh:

export DSH_MODULE_ROOT=/opt/deepseek-harness
export DSH_HOME="$HOME/.dsh"
npm run serve-lan

Use OS-native absolute paths. Do not copy Windows drive paths into Linux or macOS configuration.

Environment variables

The previous DSH_DASHBOARD* names remain accepted as compatibility aliases.

Project map

• src/ — SDK, routing, sessions, policies, metrics, dashboard, and MCP server

• bin/seekfleet.ts — cross-platform CLI entry point

• SKILL.md — compact AI operating instructions

• agents/openai.yaml — AI client discovery metadata

• docs/ — GitHub Pages product site and social preview asset

• examples/ — MCP, SDK, adapter, and cluster examples

• tests/ — 94 behavior and integration tests

Development

npm ci
npm run format:check
npm run typecheck
npm run lint
npm test
npm run build

CI runs on Windows, Ubuntu, and macOS with Node.js 20, 22, and 24. The live product page is published from docs/ by GitHub Pages.

Security

SeekFleet executes real agent tools and subprocesses. Configure policies, budgets, finite timeouts, and restricted workspaces before autonomous use. See SECURITY.md for the threat model and disclosure process.

License

MIT — see LICENSE.