Context

Discover workspace, schemes, simulators, and build configs

Use context to inspect a project and output all available build options.

# Show project context (human readable)
flowdeck context

# JSON output for agents/automation
flowdeck context --json

# Point to a specific project directory
flowdeck context --project /path/to/project

Options

Option	Short	Description
--project <path>	-p	Project directory
--json	-j	Output as JSON
--examples	-e	Show usage examples

JSON Output

When the project has a saved workspace selection (via flowdeck config set), the top-level fields describe that workspace, and projects[] lists every discovered workspace inside the project root with its own schemes, configurations, and simulators.

{
  "schema": "flowdeck.context",
  "schemaVersion": "1.1.0",
  "workspace": "iOS/MyApp.xcodeproj",
  "schemes": [
    {
      "name": "MyApp",
      "category": "iOS",
      "platform": "iOS",
      "defaultConfiguration": "Debug",
      "actionConfigurations": ["Debug", "Release"],
      "availableConfigurations": ["Debug", "Release", "Staging"]
    }
  ],
  "buildConfigurations": ["Debug", "Release"],
  "derivedDataPath": "/Users/you/Library/Developer/FlowDeck/DerivedData/...",
  "simulators": [
    {"name": "iPhone 16", "udid": "...", "platform": "iOS", "osVersion": "18.0", "state": "Shutdown"}
  ],
  "projects": [
    {
      "workspace": "iOS/MyApp.xcodeproj",
      "schemes": [
        {
          "name": "MyApp",
          "category": "iOS",
          "platform": "iOS",
          "defaultConfiguration": "Debug",
          "actionConfigurations": ["Debug", "Release"],
          "availableConfigurations": ["Debug", "Release", "Staging"]
        }
      ],
      "buildConfigurations": ["Debug", "Release"],
      "derivedDataPath": "/Users/you/Library/Developer/FlowDeck/DerivedData/..."
    },
    {
      "workspace": "test/IntegrationTests.xcodeproj",
      "schemes": [
        {
          "name": "IntegrationTests",
          "category": "Tests",
          "platform": "iOS",
          "defaultConfiguration": "Debug",
          "actionConfigurations": ["Debug", "Release"],
          "availableConfigurations": ["Debug", "Release"]
        }
      ],
      "buildConfigurations": ["Debug", "Release"],
      "derivedDataPath": "/Users/you/Library/Developer/FlowDeck/DerivedData/..."
    }
  ]
}

When no saved workspace exists yet (discovery mode), the top-level workspace/schemes/buildConfigurations/simulators fields are absent and the response wraps the per-workspace list with onboarding metadata:

{
  "schema": "flowdeck.context",
  "schemaVersion": "1.1.0",
  "mode": "discovery",
  "projectPath": "/path/to/project",
  "requiresConfiguration": true,
  "multipleProjectsFound": true,
  "discoveredCount": 2,
  "message": "No saved config found. Multiple projects/workspaces were discovered (2)…",
  "projects": [
    {
      "workspace": "iOS/MyApp.xcodeproj",
      "schemes": [...],
      "buildConfigurations": [...],
      "simulators": [...],
      "derivedDataPath": "..."
    },
    {
      "workspace": "test/IntegrationTests.xcodeproj",
      "schemes": [...],
      "buildConfigurations": [...],
      "simulators": [...],
      "derivedDataPath": "..."
    }
  ]
}

The projects[] array is the canonical way to enumerate every workspace and its scheme list in a single call — useful for monorepos that ship multiple .xcodeproj / .xcworkspace bundles, and for tools (the FlowDeck macOS app, agents) that need to flip between workspaces without making a second CLI roundtrip.

The top-level response includes:

• schema: the output contract identifier, currently flowdeck.context
• schemaVersion: the version for that specific output contract, currently 1.1.0

Each scheme now exposes three configuration views:

• defaultConfiguration: the scheme’s LaunchAction.buildConfiguration
• actionConfigurations: the unique union of config names referenced by the scheme actions
• availableConfigurations: the ordered configuration list from the primary buildable target’s XCConfigurationList, which is the closest match to Xcode’s Edit Scheme picker