Skip to content
Speedwave

Your first session

After completing the initial setup, follow this guide to open your first session, configure model authentication, and interact with your project.

  1. Open the project workspace. In the Desktop application, select your target workspace from the project switcher in the upper-right corner. The chat composer at the bottom of the window is ready for input.

  2. Authenticate with a model provider. If you have not yet configured credentials for this project, open Settings → LLM providers, select the anthropic provider, and choose subscription (oauth) or api key. For OAuth authentication, click Open terminal and log in: Speedwave launches your terminal emulator and starts the authorization flow. Follow the displayed URL to complete authorization in your browser and paste the returned verification code back into the terminal. Alternatively, copy the generated terminal command from the Settings panel (which automatically prefixes the correct SPEEDWAVE_DATA_DIR export when using custom paths). Authentication states are scoped per project, with the Settings view displaying current status (ready, auth required, or no provider configured).

  3. Pick a model and send your first prompt. The model badge in the composer shows the model the session will use; click it to choose another, and use the effort control next to it to set how long Claude reasons (see LLM providers). Type your instruction into the composer and submit it. Speedwave executes Claude Code within the project container, streaming responses in real time. While Claude generates a response, you can queue subsequent messages or press Esc to halt the active turn. For larger features, start with /speedwave-grill-with-docs or ask /speedwave-ask which flow fits; the Default development workflow walks through the steps.

  4. Review history and next steps. Open the conversations panel (Cmd+B / Ctrl+B or the menu icon in the chat header) to navigate previous sessions, and review Projects and sessions for workspace management guidance.

Projects and sessions Understanding workspace isolation boundaries and multi-project workflows.