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 project selector dropdown in the top navigation bar
  2. Click New Project
  3. Browse to and select a directory on your filesystem
  4. Enter a name for your project
  5. Click Create — the project is now selected

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

Step 3: Create a Session

  1. Click New Session in the left sidebar
  2. Select your running agent from the agent dropdown
  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

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