Skip to main content

Documentation Index

Fetch the complete documentation index at: https://flowdeck.studio/docs/llms.txt

Use this file to discover all available pages before exploring further.

List apps that were launched by FlowDeck, including their status and identifiers. 
# List running apps
flowdeck apps

# Include stopped, crashed, and exited apps
flowdeck apps --all

# Validate and prune stale entries
flowdeck apps --prune

# JSON output
flowdeck apps --json

# Show usage examples
flowdeck apps --examples

​
Options

OptionShortDescription
--examples-eShow usage examples
--json-jOutput JSON/NDJSON events
--all-aShow all apps, including stopped, crashed, and exited
--pruneValidate and prune stale entries

​
Status icons

Each row in the text output is prefixed with a status icon. The default mode (flowdeck apps) only lists running apps, so you’ll only see the running icon there. The other icons appear when you pass --all.
IconStatusMeaning
🟢runningApp process is active
🔴stoppedTerminated via flowdeck stop
💥crashedProcess exited unexpectedly
⚪exitedProcess exited normally (user closed the app)
⏸️waitingForDebuggerLaunched with --wait-for-debugger, not yet attached
❓unknownState could not be determined

​
Registry lifecycle

FlowDeck records every app it launches and keeps the entry until the registry is pruned. Stopped, crashed, and exited entries persist so you can still reference them by ID (for example, to fetch logs with flowdeck logs <app-id>). Run flowdeck apps --prune to remove non-running entries from the registry.

​
JSON Output

When --json is set, apps emits an NDJSON event with type app_list. The payload includes totals and the app list under data.apps.