Your first session
After completing the initial setup, follow this guide to open your first session, configure model authentication, and interact with your project.
-
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.
-
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_DIRexport when using custom paths). Authentication states are scoped per project, with the Settings view displaying current status (ready,auth required, orno provider configured). -
Send your first prompt. 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
Escto halt the active turn. When requesting feature implementations, Claude will gather context, define specifications, and present an execution plan before modifying files. This workflow is powered by the pre-installed superpowers plugin, included in the Built-in skills and plugins suite. See the Default development workflow for detailed lifecycle stages. -
Review history and next steps. Open the conversations panel (
Cmd+B/Ctrl+Bor the menu icon in the chat header) to navigate previous sessions, and review Projects and sessions for workspace management guidance.