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

​
Prerequisites

  • A GitHub account
Want to explore first? Try Demo Mode to see all features with sample data before connecting your own repositories.

​
Step 1: Create Your Account

1

Visit Kasava

Go to app.kasava.io
2

Sign in with GitHub

Click “Sign in with GitHub” to authenticate using your GitHub accountLogin page with GitHub sign-in button
3

Authorize Kasava

Grant Kasava access to your GitHub repositories. You can choose specific repositories or grant access to all.GitHub OAuth authorization screen
Kasava uses GitHub OAuth for authentication. We only request the permissions necessary to read your repositories and manage issues.

​
Step 2: Complete the Onboarding Wizard

After signing in, Kasava will guide you through a quick setup wizard: Onboarding wizard welcome screen
1

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”).Create product step in onboarding
2

Install the GitHub App

Click “Install GitHub App” to connect Kasava to your GitHub organization. Select which repositories you want Kasava to access.GitHub App installation prompt
3

Link Repositories

Choose which repositories to link to your Product. These will be indexed for code search and AI features.Repository selection
4

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.Integration connection step
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.

​
Step 3: Explore Your Dashboard

After onboarding, you’ll land on your Dashboard - your daily hub for staying on top of work. Dashboard with Recent Updates and My Work panels

​
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: Product sidebar navigation expanded

​
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
Once your repository is indexed, try the powerful code search:
1

Open Code Search

Navigate to your Product and click “Code Search” in the Plan section
2

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” Code search with results
3

View Results

Results are ranked by semantic relevance - Kasava finds code that matches your intent, not just keywords

​
Step 6: Ask the AI Assistant

Click “Chat” in the sidebar to open the AI assistant:
1

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” AI chat conversation
2

Get Contextual Answers

The AI understands your actual code and provides relevant, accurate answers with code references

​
What’s Next?

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

Products Deep Dive

Learn about unified project management

Code Intelligence

Master semantic search and indexing

AI Chat

Get the most out of AI assistance

Integrations

Connect Linear, Jira, and Asana

​
Troubleshooting

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.
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.
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.
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.
Need more help? Contact us at support@kasava.io