Command line
CLI setup and exits
A JSON-first CLI for direct control, MCP stdio, native bridges and the scheduler worker.
Install
bash
npm install -g https://fleetdeck.co/downloads/fleetdeck-cli-0.1.1.tgz
fleetdeck --helpRequires Node.js 22 or newer.
Environment
| Variable | Meaning |
|---|---|
FLEETDECK_API_KEY | Required Bearer key. Supply through a protected process environment; never add it to command arguments or config files. |
FLEETDECK_BASE_URL | Optional API origin. Defaults to https://fleetdeck.co. |
FLEETDECK_DEVICE_ID | Injected into scheduled child processes for the claimed device. |
Exit meanings
| Exit | Meaning |
|---|---|
0 | Command completed. For an action this means status=completed; it does not prove the intended visible effect. |
1 | Usage, parse, validation, transport or API failure; or action status failed, unknown or cancelled. |
2 | action returned queued or running. Save the request ID and use status; do not submit a second physical action. |
Error output
Usage, validation, transport and API exceptions write one JSON object to stderr: {"error":"Invalid request","code":"VALIDATION","status":422}. Client-only failures omit status. Validation failures can include issue paths; retryAfterSeconds is present only when supplied by an HTTP response. The action command keeps terminal failed, unknown or cancelled records on stdout and sets exit 1; it does not duplicate them on stderr.
Commands
fleetdeck helpPrint command usage and configuration shapes.fleetdeck devicesList phones granted to the current key.fleetdeck capabilitiesDiscover the current driver, commands, native tools and limitations.fleetdeck acquireAcquire an exclusive automation session.fleetdeck heartbeatRenew an active session.fleetdeck releaseClose a session and cancel its queued work.fleetdeck actionSubmit any of the 18 action payloads and wait for its outcome.fleetdeck statusRead an existing action without executing it again.fleetdeck screenshotCapture a screenshot and create a private local file.fleetdeck mediaUpload media in ordered one MiB chunks.fleetdeck scheduleCreate one future agent job.fleetdeck jobsList up to 100 jobs owned by this key.fleetdeck cancelCancel queued work or ask a running worker to stop.fleetdeck meCheck the current key and show its scopes.fleetdeck sequencesList saved touch sequences and library sequences for a phone.fleetdeck run-sequenceRun a saved sequence now through the touch scheduler.fleetdeck touch-schedulesList touch schedules and whether the scheduler is online.fleetdeck touch-scheduleCreate a recurring or one-time touch schedule.fleetdeck touch-schedule-updatePause, resume or move a touch schedule.fleetdeck touch-schedule-deleteDelete a touch schedule and keep its run history.fleetdeck runsShow touch run history, or write it as CSV.fleetdeck mcpRun the FleetDeck MCP server over stdio.fleetdeck bridgeExpose a private native driver to FleetDeck.fleetdeck workerRun the scheduler worker that launches an external agent adapter.