Quick Start

This guide walks you through creating a project, starting an agent, and running your first session.

Step 1: Create a Project

  1. Click the + button at the end of the project tab bar in the top navigation
  2. Browse to and select a directory on your filesystem
  3. Enter a name for your project
  4. Click Create — the project is now selected
Start a project

Step 2: Start an Agent

  1. Click the gear icon in the top-right to open Settings
  2. Go to the Agents section
  3. Find an agent you want to use and toggle it on
  4. Wait for the agent to download (if needed) and start — its status will change to Running
  5. Close the Settings panel
Enabling your first agent

Step 3: Create a Session

  1. Click New Session in the left sidebar
  2. Select your running agent (or persona) from the dropdown in the prompt toolbar
  3. The session is created and ready for prompts

Step 4: Send a Prompt

  1. Type your prompt in the input area at the bottom
  2. Press Enter or click the send button
  3. Watch as the agent responds in real time — you'll see:
    • Chat messages rendered as markdown
    • Tool calls showing what the agent is executing
    • Permission requests if the agent needs approval for certain actions
A running session showing streamed responses and tool calls
A running session showing streamed responses and tool calls

Step 5: Continue the Conversation

You can continue sending prompts in the same session. The agent maintains context from previous messages. To start a new conversation, create another session from the sidebar.

What's Next

  • Learn about Projects and how they organize your work
  • Understand Sessions and their lifecycle
  • Set up GitHub Integration to attach issues or pull requests to sessions
  • Explore the Terminal for command-line access alongside your agent