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

# Config

> Show, save, and reset project settings for streamlined CLI usage

Use `config` to manage saved runtime project selection state (workspace, scheme, target, configuration).

<Note>
  `flowdeck config set` is not the same as editing `.flowdeck/config.json` or `.flowdeck/config.local.json`. The `config` command saves per-project runtime defaults, while the `.flowdeck/config*.json` files are the shared project settings format.
</Note>

## Read Saved Settings

`flowdeck config` shows command help. Use `flowdeck config get` to read saved settings for the current project folder.

```bash theme={null}
# Show config command help and subcommands
flowdeck config

# Read saved config for current folder
flowdeck config get

# Read from a different project folder
flowdeck config get -p /path/to/project

# JSON output
flowdeck config get --json
```

## Save Settings

Use `flowdeck config set` to store workspace/scheme/target defaults:

```bash theme={null}
# iOS Simulator
flowdeck config set -w App.xcworkspace -s MyApp -S "iPhone 16"

# macOS target
flowdeck config set -w App.xcworkspace -s MyApp -D "My Mac"

# Physical device
flowdeck config set -w App.xcworkspace -s MyApp -D "John's iPhone"

# Build configuration
flowdeck config set -w App.xcworkspace -s MyApp -S "iPhone 16" -C Release

# Overwrite existing config
flowdeck config set -w App.xcworkspace -s MyApp -S "iPhone 16" --force

# JSON output
flowdeck config set -w App.xcworkspace -s MyApp -S "iPhone 16" --json
```

## Reset Saved Settings

Use `flowdeck config reset` to clear saved settings for a project folder:

```bash theme={null}
# Clear saved config for current folder
flowdeck config reset

# Clear saved config for another project folder
flowdeck config reset -p /path/to/project

# JSON output
flowdeck config reset --json
```

## Options (`config get`)

| Option             | Short | Description                             |
| ------------------ | ----- | --------------------------------------- |
| `--project <path>` | `-p`  | Project directory (defaults to current) |
| `--json`           | `-j`  | Output as JSON                          |
| `--examples`       | `-e`  | Show usage examples                     |

## Options (`config set`)

| Option                   | Short | Description                                   |
| ------------------------ | ----- | --------------------------------------------- |
| `--project <path>`       | `-p`  | Project directory (defaults to current)       |
| `--workspace <path>`     | `-w`  | Path to .xcworkspace or .xcodeproj (required) |
| `--scheme <name>`        | `-s`  | Scheme name                                   |
| `--configuration <name>` | `-C`  | Build configuration (Debug/Release)           |
| `--simulator <name>`     | `-S`  | Simulator name or UDID                        |
| `--device <name>`        | `-D`  | Device name or UDID (use "My Mac" for macOS)  |
| `--force`                | `-f`  | Overwrite an existing saved config            |
| `--json`                 | `-j`  | Output as JSON                                |
| `--examples`             | `-e`  | Show usage examples                           |

## Options (`config reset`)

| Option             | Short | Description                             |
| ------------------ | ----- | --------------------------------------- |
| `--project <path>` | `-p`  | Project directory (defaults to current) |
| `--json`           | `-j`  | Output as JSON                          |
| `--examples`       | `-e`  | Show usage examples                     |

## JSON Output (`config set`)

```json theme={null}
{
  "schema": "flowdeck.config",
  "schemaVersion": "1.0.0",
  "success": true,
  "message": "Project configuration saved",
  "workspace": "App.xcworkspace",
  "scheme": "MyApp",
  "target": "iPhone 16",
  "targetType": "simulator",
  "configuration": "Debug"
}
```

## JSON Output (`config reset`)

```json theme={null}
{
  "schema": "flowdeck.config",
  "schemaVersion": "1.0.0",
  "success": true,
  "message": "Project configuration reset",
  "projectPath": "/path/to/project",
  "cleared": true
}
```