FleetDeckDocs

CLI command

fleetdeck worker

Run the scheduler worker that launches an external agent adapter.

Usage

bash
fleetdeck worker CONFIG.json
Example
fleetdeck worker ./worker.json

Arguments

ArgumentRequiredDescription
CONFIG.jsonrequiredPath to the JSON configuration for the external agent executable.

Supply FLEETDECK_API_KEY through the environment. See environment configuration.

Configuration fields

executablestringrequired

Agent adapter executable. Prefer an absolute path; a bare command is resolved with PATH. FleetDeck does not invoke a shell.

argsstring[]required

Arguments passed directly to the executable. Task instructions arrive on stdin, not through shell interpolation.

inheritEnvstring[]optional

Additional environment variable names to pass to the child, for example OPENAI_API_KEY. PATH, HOME, TMPDIR, LANG and TERM are inherited automatically.

worker.json
{
  "executable": "/absolute/path/to/agent-adapter",
  "args": [],
  "inheritEnv": [
    "OPENAI_API_KEY"
  ]
}

Behavior

  • Config requires an executable and an args array. Prefer an absolute executable path; a bare command is resolved through PATH. Task text is sent on stdin; FleetDeck does not invoke a shell.
  • The child receives a device-bound short-lived key. The worker heartbeats every 4 seconds with a 5-second HTTP bound and extends active child sessions while the agent is thinking.
  • Child stdout and stderr are consumed and capped at 8 MiB. Cancellation sends TERM, then KILL after two seconds.

Output and exit

Long-running process. A child exit 0 records process completion only; the child must retain screenshot or inspect evidence for the app outcome.

See all exit codes and error recovery.