Skip to content

Latest commit

 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SeekFleet — Run agents like a fleet

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.

Live product page · AI installation contract · Agent Skill · Security

CI MIT License Node.js 20 or newer Last commit

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.

Language Product summary
简体中文 面向 DeepSeek Harness Agent 集群的跨平台控制平面,统一调度、监控、预算、策略与局域网控制台。
English A cross-platform control plane for routing, observing, budgeting, governing, and stopping DeepSeek Harness agent fleets.
日本語 DeepSeek Harness Agent艦隊をルーティング、監視、予算管理、制御するクロスプラットフォーム基盤。
한국어 DeepSeek Harness 에이전트 함대를 라우팅, 관찰, 예산 관리, 정책 적용, 중지하는 크로스 플랫폼 제어 플레인.
Español Un plano de control multiplataforma para enrutar, observar, presupuestar, gobernar y detener flotas de agentes DeepSeek Harness.

The 30-second version

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

Surface What it gives you
MCP server 20 structured tools with stable envelopes and annotations
SDK One TypeScript API for one-shot tasks, sessions, clusters, and DAGs
Control plane Routing, cache, circuit breakers, budgets, policies, and cancellation
LAN dashboard Live agents, requests, tokens, cost, failures, sessions, and protected controls
Agent Skill One deterministic install path for Codex, Claude, Cursor, Gemini, and .agents clients

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

Mode Best for Control surface
One-shot One bounded task dsh_run
Session Long-running, cancellable work dsh_session_*
Cluster Parallel or repeated tasks dsh_cluster_*
DAG Dependent task graphs dsh_dag_run

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

Variable Default Purpose
DSH_MODULE_ROOT auto-detected Installed DeepSeek Harness package
DSH_HOME ~/.dsh Profiles and persistent runtime state
CODEX_HOME ~/.codex Codex configuration root
SEEKFLEET_DASHBOARD 0 Start the dashboard with MCP when set to 1
SEEKFLEET_DASHBOARD_HOST 127.0.0.1 Dashboard bind host
SEEKFLEET_DASHBOARD_PORT 8787 Dashboard TCP port
SEEKFLEET_DASHBOARD_TOKEN random Fixed dashboard bearer token

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.

About

Cross-platform AI agent fleet control plane with MCP, LAN dashboard, metrics, policies, and session management.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages