> ## 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.

# Logs

> Stream real-time logs from a running app

Stream logs for an app launched by FlowDeck. The identifier can be a short ID, full ID, or bundle ID.

```bash theme={null}
# Stream logs for an app ID
flowdeck logs <app-id>

# Stream logs for a bundle ID
flowdeck logs com.example.MyApp

# JSON output
flowdeck logs <app-id> --json

# Show usage examples
flowdeck logs --examples
```

## Arguments

| Argument       | Description                                      |
| -------------- | ------------------------------------------------ |
| `<identifier>` | App identifier (short ID, full ID, or bundle ID) |

## Options

| Option       | Short | Description           |
| ------------ | ----- | --------------------- |
| `--json`     | `-j`  | Output as JSON/NDJSON |
| `--examples` | `-e`  | Show usage examples   |

<Note>
  Logs are supported for simulator and macOS launches. Physical device logs require Console.app or Xcode.
</Note>

## JSON Output

When `--json` is set, log output is NDJSON (one JSON object per line).