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

# Clean

> Clean scheme artifacts, FlowDeck Derived Data, and Xcode cache

Use `clean` to remove build artifacts and caches. With no flags, it cleans scheme build artifacts using your saved project settings.

```bash theme={null}
# Clean scheme artifacts (after config set)
flowdeck clean

# Clean FlowDeck/Xcode Derived Data or Xcode cache
flowdeck clean --derived-data
flowdeck clean --xcode-derived-data
flowdeck clean --xcode-cache

# Clean everything
flowdeck clean --all

# Show usage examples
flowdeck clean --examples
```

## Options

| Option                       | Short | Description                                                                    |
| ---------------------------- | ----- | ------------------------------------------------------------------------------ |
| `--derived-data`             |       | Delete all FlowDeck Derived Data                                               |
| `--xcode-derived-data`       |       | Delete all Xcode Derived Data                                                  |
| `--xcode-cache`              |       | Delete Xcode cache                                                             |
| `--all`                      |       | Clean scheme artifacts, FlowDeck/Xcode Derived Data, and cache                 |
| `--project <path>`           | `-p`  | Project directory                                                              |
| `--workspace <path>`         | `-w`  | Path to workspace (.xcworkspace) or project (.xcodeproj)                       |
| `--scheme <name>`            | `-s`  | Scheme name                                                                    |
| `--derived-data-path <path>` | `-d`  | Custom derived data path (default: `~/Library/Developer/FlowDeck/DerivedData`) |
| `--config <path>`            | `-c`  | Load settings from an explicit command config file                             |
| `--json`                     | `-j`  | Output JSON/NDJSON events                                                      |
| `--verbose`                  | `-v`  | Show clean output                                                              |
| `--examples`                 | `-e`  | Show usage examples                                                            |

## JSON Output

When `--json` is set, clean emits NDJSON events and a final result event.