> ## Documentation Index
> Fetch the complete documentation index at: https://kasava.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get up and running with Kasava in 5 minutes

Welcome to Kasava! This guide will walk you through setting up your first Product and connecting your development workflow.

## Prerequisites

* A GitHub account

<Tip>
  Want to explore first? Try [Demo Mode](/docs/demo-mode) to see all features with sample data before connecting your own repositories.
</Tip>

## Step 1: Create Your Account

<Steps>
  <Step title="Visit Kasava">
    Go to [app.kasava.dev](https://app.kasava.dev)
  </Step>

  <Step title="Sign in with GitHub">
    Click "Sign in with GitHub" to authenticate using your GitHub account
  </Step>

  <Step title="Authorize Kasava">
    Grant Kasava access to your GitHub repositories. You can choose specific repositories or grant access to all.
  </Step>
</Steps>

<Info>
  Kasava uses GitHub OAuth for authentication. We only request the permissions necessary to read your repositories and manage issues.
</Info>

## Step 2: Complete the Onboarding Wizard

After signing in, Kasava will guide you through a quick setup wizard:

<Steps>
  <Step title="Create Your First Product">
    Give your product a name - this is typically your project or application name (e.g., "Mobile App", "API Platform", "Marketing Site").
  </Step>

  <Step title="Install the GitHub App">
    Click "Install GitHub App" to connect Kasava to your GitHub organization. Select which repositories you want Kasava to access.
  </Step>

  <Step title="Link Repositories">
    Choose which repositories to link to your Product. These will be indexed for code search and AI features.
  </Step>

  <Step title="Connect Your Tools (Optional)">
    Add integrations for Linear, Jira, or Asana to bring in all your work items. You can skip this and add them later.
  </Step>
</Steps>

<Note>
  You can skip any step during onboarding and complete it later from Settings. You can also click "Try Demo Mode" to explore with sample data first.
</Note>

## Step 3: Explore Your Dashboard

After onboarding, you'll land on your Dashboard - your daily hub for staying on top of work.

### Dashboard Panels

* **Recent Updates** - AI-generated summary of wins, risks, and progress across your products
* **My Work** - Items that need your attention, prioritized by urgency

### Quick Stats

The dashboard header shows key metrics at a glance:

* Open Issues
* Open PRs
* Open Bugs
* Wins and Risks from recent activity

## Step 4: Navigate Your Product

Click on your Product in the sidebar to see all its features organized by tabs:

### Work

* **Issues** - View and manage issues from all connected platforms
* **Pull Requests** - Track PRs across your repositories

### Plan

* **Plans** - Product Requirements Documents with AI enhancement
* **Prototypes** - Link Figma or v0 designs
* **Code Search** - Semantic search across your codebase
* **Roadmap** - Plan your product direction

### Monitor

* **Documentation** - Auto-generated code documentation
* **Timeline** - Activity history across all platforms
* **Bug Reports** - Bugs captured via Chrome extension
* **Support** - Customer feedback and support tickets
* **Knowledge** - Knowledge base and documentation

### Analysis

* **Updates** - AI-generated product digests
* **Goals** - Track objectives and progress
* **Decisions** - Document key product decisions
* **Insights** - AI-generated observations and recommendations

## Step 5: Try Semantic Code Search

Once your repository is indexed, try the powerful code search:

<Steps>
  <Step title="Open Code Search">
    Navigate to your Product and click "Code Search" in the Plan section
  </Step>

  <Step title="Enter a Natural Language Query">
    Type what you're looking for in plain English:

    * "authentication middleware"
    * "database connection handling"
    * "error logging functions"
    * "user profile validation"
  </Step>

  <Step title="View Results">
    Results are ranked by semantic relevance - Kasava finds code that matches your intent, not just keywords
  </Step>
</Steps>

## Step 6: Ask the AI Assistant

Click "Chat" in the sidebar to open the AI assistant:

<Steps>
  <Step title="Start a Conversation">
    Ask questions about your codebase:

    * "How does the authentication flow work?"
    * "Where are database queries defined?"
    * "Explain the error handling pattern in this project"
  </Step>

  <Step title="Get Contextual Answers">
    The AI understands your actual code and provides relevant, accurate answers with code references
  </Step>
</Steps>

## What's Next?

Now that you're set up, explore more of what Kasava can do:

<CardGroup cols={2}>
  <Card title="Products Deep Dive" icon="layer-group" href="/docs/features/products">
    Learn about unified project management
  </Card>

  <Card title="Code Intelligence" icon="brain" href="/docs/features/code-intelligence">
    Master semantic search and indexing
  </Card>

  <Card title="AI Chat" icon="comments" href="/docs/features/ai-chat">
    Get the most out of AI assistance
  </Card>

  <Card title="Integrations" icon="plug" href="/docs/integrations/overview">
    Connect Linear, Jira, and Asana
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Repository indexing seems stuck">
    Large repositories can take several minutes. Check the indexing status on the repository detail page. Small repos (under 100 files) typically complete in under 10 seconds, while larger repos (10,000+ files) may take 2-5 minutes. If it's been more than 10 minutes for a moderate-sized repository, try refreshing or re-triggering indexing.
  </Accordion>

  <Accordion title="I don't see all my repositories">
    Make sure you've granted Kasava access to the repositories you want to use. You can update permissions by re-installing the GitHub App from Settings > Integrations > GitHub.
  </Accordion>

  <Accordion title="Search isn't returning expected results">
    Ensure the repository has finished indexing (check for a green "Indexed" status). Semantic search works best with natural language queries describing what you're looking for, rather than exact code snippets.
  </Accordion>

  <Accordion title="I want to start over with Demo Mode">
    Click the "Demo Mode" toggle in the sidebar footer to switch to demo mode. This shows sample data so you can explore all features without affecting your real data.
  </Accordion>
</AccordionGroup>

<Info>
  Need more help? Contact us at [support@kasava.io](mailto:support@kasava.io)
</Info>