CLI command
fleetdeck worker
Run the scheduler worker that launches an external agent adapter.
Usage
bash
fleetdeck worker CONFIG.jsonExample
fleetdeck worker ./worker.jsonArguments
| Argument | Required | Description |
|---|---|---|
CONFIG.json | required | Path to the JSON configuration for the external agent executable. |
Supply FLEETDECK_API_KEY through the environment. See environment configuration.
Configuration fields
executablestringrequiredAgent adapter executable. Prefer an absolute path; a bare command is resolved with PATH. FleetDeck does not invoke a shell.
argsstring[]requiredArguments passed directly to the executable. Task instructions arrive on stdin, not through shell interpolation.
inheritEnvstring[]optionalAdditional 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.
