🚀. Socket Launch Week Day 3:Socket Firewall Now Blocks Malicious VS Code and Open VSX Extensions.Learn more
Sign In

@daomar/agentfleet

Package Overview
Dependencies
Maintainers
1
Versions
9
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install
Potential malware was recently detected in this package.

Affected versions:

2.0.02.0.12.0.23.0.03.1.0
+4 more

@daomar/agentfleet

Distributed agent orchestration, without a control plane.

Source
npmnpm
Version
3.0.0
Version published
Weekly downloads
13
-61.76%
Maintainers
1
Weekly downloads
 
Created
Source

AgentFleet

Distributed agent orchestration, without a control plane.

Fan out coding tasks across all your machines — no servers, no config, no infrastructure.

npm version build status npm downloads license

English | 简体中文

Demo GIF coming soon — see Quick Start to try it now

Why AgentFleet?

Most distributed task systems need servers, brokers, or cloud infrastructure. AgentFleet needs none of that — it uses OneDrive sync as the coordination layer.

AgentFleetSSH ScriptsAnsibleCloud CI
InfrastructureNone (OneDrive)SSH server per machineControl node + SSHCloud provider account
NetworkNo inbound connectionsOpen SSH portsOpen SSH portsInternet access
SecurityInherits M365 policiesKey managementKey managementCloud IAM
Setup Time< 1 minuteHoursHoursMinutes to hours
AI Agent SupportBuilt-in (any CLI agent)Manual scriptingCustom playbooksCustom pipelines
Works Behind FirewallsYesNoNoDepends

Value Propositions

Zero Servers — No schedulers, no brokers, no databases. OneDrive is the only moving part.

Zero Config — Run one command and you're live. AgentFleet auto-detects OneDrive and sets up everything.

Enterprise Security — No tunnels, no open ports, no data leaves your Microsoft 365 tenant. Your IT policies already cover it.

Quick Start

# 1. Start AgentFleet on each machine (auto-detects OneDrive)
npx -y @daomar/agentfleet run

# 2. Submit a task from any machine
agentfleet submit --prompt "Add error handling to all API endpoints" --title "Error handling"

# 3. Results appear on every machine — check them
agentfleet status

That's it. Every machine running agentfleet run picks up the task, executes it with its locally installed coding agent, and writes back results.

How It Works

  Machine A                    Machine B                    Machine C
  ┌──────────┐                ┌──────────┐                ┌──────────┐
  │agentfleet│                │agentfleet│                │agentfleet│
  │   run    │                │   run    │                │   run    │
  └────┬─────┘                └────┬─────┘                └────┬─────┘
       │                           │                           │
       └───────────┐    ┌──────────┘    ┌──────────────────────┘
                   ▼    ▼              ▼
              ┌─────────────────────────────┐
              │     OneDrive Sync Layer     │
              │  ┌───────┐   ┌──────────┐  │
              │  │tasks/ │   │ output/  │  │
              │  └───────┘   └──────────┘  │
              └─────────────────────────────┘
  • Your machines share a synced OneDrive workspace.
  • AgentFleet exposes stable local paths under ~/.agentfleet/.
  • Any machine can create a task in the shared tasks/ directory.
  • Every machine running agentfleet run picks up that task independently.
  • Results land in output/ with hostname-prefixed files — no collisions.

Use Cases

Multi-Machine Code Review

Run the same coding agent prompt on a project across all your development machines simultaneously. Each machine applies its own agent (Claude Code, GitHub Copilot CLI, Cursor, etc.) and writes independent results, so you can compare outputs side by side.

agentfleet submit \
  --prompt "Review this codebase for security vulnerabilities and suggest fixes" \
  --title "Security audit" \
  --working-dir /path/to/project

Distributed Refactoring

Fan out a large refactoring task across multiple machines, each working on its own local clone of the project. Useful when you have multiple workstations or want to try different agent configurations in parallel.

agentfleet submit \
  --prompt "Migrate all class components to functional components with hooks" \
  --title "React migration" \
  --working-dir /path/to/project

Web Dashboard

A browser-based dashboard at agentfleet.daomar.dev lets you submit tasks, monitor nodes, and view results from any device — including mobile (installable as PWA).

Security & Compliance

  • No tunnels — Machines never open inbound connections. Nothing to attack.
  • No exposed ports — No listening services, no attack surface.
  • No data movement — Data stays in your own OneDrive. Never leaves the M365 tenant boundary.
  • No central server — Coordination through OneDrive sync, already approved by your IT.
  • Web dashboard — Microsoft Entra ID auth with PKCE, delegated permissions only.

Full Documentation

Installation options
npx -y @daomar/agentfleet run

On first run, AgentFleet creates an agentfleet shortcut in your npm global directory.

Global install

npm install -g @daomar/agentfleet
agentfleet run
CLI reference

Run

Start AgentFleet on this machine:

agentfleet run

Options:

  • --poll-interval <seconds> — Polling interval (default: 10)
  • --concurrency <number> — Max concurrent agent processes (default: 1)
  • --daemon or -d — Run as background daemon
  • --log-file <path> — Log file path for daemon mode (default: ~/.agentfleet/agentfleet.log)

Daemon Mode

agentfleet run --daemon

Spawns a detached process, writes PID to ~/.agentfleet/agentfleet.pid. Only one instance allowed at a time.

Auto-Start on Login

npx -y @daomar/agentfleet install    # Install auto-start
npx -y @daomar/agentfleet uninstall  # Remove auto-start
  • Windows: Scheduled Task named AgentFleet, triggers on login and wake
  • macOS: LaunchAgent named dev.daomar.agentfleet

Submit

agentfleet submit --prompt "..." --title "..." --working-dir /path

Options:

  • --prompt <text> — Instruction for the coding agent (required)
  • --title <text> — Short task title
  • --working-dir <path> — Working directory (default: cwd)
  • --agent <command> — Override agent command template

Status

agentfleet status                        # Overview of all tasks
agentfleet status task-20260402-abc123   # Detail for one task

Stop

agentfleet stop
Architecture details
~/.agentfleet/
├── config.json          # Local machine config (not synced)
├── processed.json       # IDs of tasks already executed on this machine
├── agentfleet.pid       # PID file (present when running)
├── agentfleet.log       # Log file (daemon and auto-start modes)
├── tasks/ → OneDrive    # Symlink to <OneDrive>\AgentFleet\tasks
│   ├── task-001.json
│   └── task-002.json
└── output/ → OneDrive   # Symlink to <OneDrive>\AgentFleet\output
    ├── task-001/
    │   ├── DESKTOP-A-result.json
    │   ├── DESKTOP-A-stdout.log
    │   └── LAPTOP-B-result.json
    └── task-002/
        └── ...

Platform-specific auto-start files:

  • Windows: ~/.agentfleet/start-agentfleet.vbs
  • macOS: ~/Library/LaunchAgents/dev.daomar.agentfleet.plist

Task File Format

{
  "id": "task-20260402120000-abc123",
  "title": "Add error handling",
  "prompt": "Add try-catch blocks to all API route handlers...",
  "workingDirectory": "C:\\work\\myproject",
  "createdAt": "2026-04-02T12:00:00Z",
  "createdBy": "DESKTOP-A"
}

Task files are immutable once written. Only tasks arriving after the daemon starts are processed.

Prerequisites

  • Windows with PowerShell, or macOS
  • Node.js >= 18
  • OneDrive installed and syncing
  • A coding agent CLI (e.g., Claude Code, GitHub Copilot CLI, Cursor)

OneDrive Detection

AgentFleet checks both OneDrive for Business and personal accounts:

  • If one account is available, it is used automatically.
  • If both are available, the first detected is used.
  • On macOS, ~/Library/CloudStorage/OneDrive* is checked first, then ~/OneDrive*.
Web dashboard details

Features

  • Submit tasks to all machines from any browser
  • Monitor nodes — active machines, last activity, task counts
  • Browse task history — paginated with status indicators
  • View results — per-machine exit codes, duration, timestamps
  • PWA — installable on iOS and Android

Access

Sign in at agentfleet.daomar.dev with the Microsoft account that owns the OneDrive.

Security

  • Auth: Microsoft Entra ID with PKCE — no secrets in the browser
  • Tokens: MSAL.js manages tokens in localStorage
  • Permissions: Files.Read, Files.ReadWrite, User.Read (delegated)
  • Input sanitization: Shell metacharacters stripped from prompts
  • CSP: Enforced via HTTP header
  • No backend: Browser → Microsoft Graph directly

Entra ID App Registration

PropertyValue
Client IDb94f9687-adcf-48ea-9861-c4ce4b5c01a0
Tenant91dde955-43a9-40a9-a406-694cffb04f28 (multi-tenant)
Sign-in audienceAzureAD and personal Microsoft accounts
Redirect URIshttps://agentfleet.daomar.dev/, http://localhost:5173/
PermissionsFiles.Read, Files.ReadWrite, User.Read (delegated)

Mobile Install (PWA)

iOS: Safari → Share → Add to Home Screen
Android: Chrome → ⋮ → Add to Home Screen

Local Development

cd web
npm install
npm run dev        # Dev server at http://localhost:5173
npm run build      # Production build to web/dist/
npm test           # Unit tests (Vitest)
Development
npm run build      # Build CLI
npm test           # Run CLI tests
cd web && npm test # Run web tests

See CONTRIBUTING.md for full development setup.

Star History

Star History Chart

Support

AgentFleet is free and open-source. If it helps your workflow, consider supporting the project:

PayPal
(international)
WeChat Pay
(国内用户)
PayPal QR CodeWeChat Pay QR Code

Supporters

@hjunxu
hjunxu

License

ISC

Keywords

agent

FAQs

Package last updated on 25 Apr 2026

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts