Config

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

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.

Read Saved Settings

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

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

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

# 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 get`)

{
  "schema": "flowdeck.config",
  "schemaVersion": "1.0.0",
  "success": true,
  "projectPath": "/path/to/project",
  "workspace": "/path/to/project/App.xcworkspace",
  "scheme": "MyApp",
  "configuration": "Debug",
  "target": "iPhone 16",
  "targetType": "simulator",
  "simulator": {
    "name": "iPhone 16",
    "udid": "12345678-1234-1234-1234-123456789012",
    "platform": "iOS",
    "os": "iOS 18.0"
  }
}

When the saved target is a device (or a virtual macOS target), the response carries a device object instead of simulator:

{
  "schema": "flowdeck.config",
  "schemaVersion": "1.0.0",
  "success": true,
  "projectPath": "/path/to/project",
  "workspace": "/path/to/project/App.xcworkspace",
  "scheme": "MyApp",
  "configuration": "Debug",
  "target": "My Mac",
  "targetType": "macOS",
  "device": {
    "name": "My Mac",
    "udid": "00000000-0000-0000-0000-000000000001",
    "platform": "macOS"
  }
}

JSON Output (`config set`)

{
  "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`)

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

Overview

FlowDeck for AI

Interactive Mode (TUI)

Core Features

Command Reference

Advanced

Support

Read Saved Settings

Save Settings

Reset Saved Settings

Options (`config get`)

Options (`config set`)

Options (`config reset`)

JSON Output (`config get`)

JSON Output (`config set`)

JSON Output (`config reset`)

​Read Saved Settings

​Save Settings

​Reset Saved Settings

​Options (config get)

​Options (config set)

​Options (config reset)

​JSON Output (config get)

​JSON Output (config set)

​JSON Output (config reset)

Read Saved Settings

Save Settings

Reset Saved Settings

Options (`config get`)

Options (`config set`)

Options (`config reset`)

JSON Output (`config get`)

JSON Output (`config set`)

JSON Output (`config reset`)