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

# Troubleshooting

> Built-in help, CLI options, and common issues

## In Interactive Mode

Press `H` at any time to open Support, including quick access to online documentation. Press `?` to display the Build, Run & Test help.

## Command Line Help

```bash theme={null}
# Show all CLI options
flowdeck --help
```

## Common Issues

<AccordionGroup>
  <Accordion title="Setup assistant keeps appearing">
    The setup assistant runs when FlowDeck can't find a valid workspace or scheme. Make sure your project has a `.xcworkspace` or `.xcodeproj` file and run the setup again with `S` to select a scheme.
  </Accordion>

  <Accordion title="Keyboard shortcuts not working">
    Make sure the terminal window is focused and no command is currently running. Some shortcuts are disabled during builds or tests.
  </Accordion>

  <Accordion title="Logs not appearing">
    Press `L` to open the log viewer. Logs only appear when an app is running on a simulator. Physical device logs require Console.app.
  </Accordion>

  <Accordion title="Build fails with signing errors">
    Run `flowdeck build` outside interactive mode to see full error output, or check your Xcode signing settings.
  </Accordion>
</AccordionGroup>

## Documentation

* [CLI Command Overview](/cli/commands/overview) - Full list of CLI commands
* [Building](/cli/building) - Build configuration options
* [Testing](/cli/testing) - Test execution options
* [FlowDeck for AI Agents](/cli/ai-agents) - Recommended AI workflows