Skip to main content
Products are the central organizing concept in Kasava. A Product represents a software project or initiative, bringing together issues, pull requests, documentation, goals, and insights in one place.

​
What is a Product?

A Product in Kasava is your command center for a software project. It provides:
  • Unified work tracking - View issues and PRs from GitHub in one place
  • AI-powered insights - Automated digests, goal tracking, and decision logging
  • Documentation hub - PRDs, prototypes, and generated documentation
  • Code intelligence - Semantic search across linked repositories
  • Activity timeline - Historical view of all product activity

​
Accessing Products

Click “Products” in the sidebar to view your products. Kasava automatically opens your most recent product, or shows the product list if you have multiple. The URL structure is: /products/[productId]/[section]

​
Creating a Product

1

Navigate to Products

Click “Products” in the sidebar navigation, or use the keyboard shortcut
2

Open Create Sheet

Click the “New Product” button, or navigate to /products?action=new
3

Enter Product Details

  • Name (required) - A clear name for your product
  • Description (optional) - Brief description of what this product is about
4

Create

Click “Create Product” to save. You’ll be taken to your new product’s summary page.

​
Product Navigation

Products use a sidebar navigation system with the following sections:

​
Work Sections

  • Summary - Product overview with context rail showing quick stats and actions
  • Issues - GitHub issues linked to this product
  • PRs - Pull requests from linked repositories

​
Plan Sections

  • Prototypes - Design prototypes and mockups
  • PRDs - Product Requirements Documents
  • Code Search - Semantic search across linked repositories
  • Roadmap - Product roadmap and milestones

​
Monitor Sections

  • Documentation - Generated code documentation
  • Timeline - Activity history across the product
  • Bug Reports - Bug reports associated with this product
  • Support - Customer support dashboard

​
Analysis Section

The Analysis section (/products/[id]/analysis) contains four tabs:
  • Updates - AI-generated weekly digests and summaries
  • Goals - Track objectives with progress metrics
  • Decisions - Log and track important product decisions
  • Insights - AI-powered analysis, risks, and research
All analysis items can be embedded in Plans using slash commands (/goal, /update, /decision, /insight). See Plan Editor for details.

​
Configuration

  • Repositories - Link and manage associated repositories
  • Knowledge - AI-powered feature discovery and codebase understanding

​
Summary Page

The Summary page is your product’s home, showing:
  • Product identity - Icon, name, and tagline
  • Quick actions - Common operations like generating a digest
  • Health status - Goals progress, sprint status, and risk indicators
  • Attention items - Issues needing review
  • Integration insights - Summaries from connected tools
  • Linked repositories - Associated code repositories with status
  • Connected platforms - Integration status
  • Team access - Team members and roles

​
Issues Dashboard

The Issues section provides a dashboard view of GitHub issues:
  • View all issues linked to this product
  • Filter by status, assignee, and labels
  • Click any issue to view details
  • Navigate directly to GitHub when needed

​
Pull Requests

The PRs section shows pull requests from linked repositories:
  • Open, merged, and closed PRs
  • Review status indicators
  • Author and assignee information
  • Direct links to GitHub

​
Goals

Track high-level objectives for your Product in the Goals section. Navigate to /products/[id]/analysis?analysisTab=goals.

​
Goals List

The Goals tab displays all your product goals in a compact list format:
  • Status indicator - Color-coded dot showing goal health
  • Title - Goal name (click to view details)
  • Progress bar - Visual indicator with percentage complete
  • Metrics summary - Shows how many metrics are on track
  • Days remaining - Time until target date (or days overdue)
  • Status badge - Current goal status

​
Creating a Goal

1

Open Goals Section

Navigate to your product and click the “Analysis” section, then select the “Goals” tab
2

Click Add Goal

Click the “Add Goal” button in the top right
3

Enter Goal Details

  • Title - Clear, measurable objective
  • Description - Additional context
  • Target Date - When this goal should be achieved
4

Save

Click “Create Goal” to save your new goal

​
Goal Detail View

Click any goal to open the detail dialog where you can:
  • View full goal description and progress
  • See all linked metrics with current values
  • Add or remove metric connections
  • Update goal status
  • Edit goal details

​
Goal Filters

Filter goals by status using the tabs at the top:
  • All Goals - Every goal regardless of status (with count)
  • Active - Currently in progress
  • At Risk - Goals that may miss their deadline (includes both at-risk and delayed)
  • Completed - Successfully achieved goals

​
Goal Status

​
Linking Metrics

Goals can automatically pull metrics from connected data sources to track progress:
1

Open Goal Detail

Click on a goal to open the detail dialog
2

Add Metric

Click “Add Metric” in the metrics section
3

Select Data Source

Choose from your connected integrations
4

Configure Query

Set up the metric query based on the data source type

​
Supported Metric Sources

Connect data sources in Settings > Integrations before linking them to goals.
Embed goals in Plans - Use the /goal slash command in the Plan editor to embed a goal widget. This displays goal progress and status directly in your PRDs and planning documents.

​
Updates (Digests)

The Updates section shows AI-generated weekly summaries of product activity. Navigate to /products/[id]/analysis?analysisTab=updates.

​
Layout

The Updates tab uses a sidebar/detail layout:
  • Left sidebar - List of weekly periods with accomplishment and risk counts
  • Right panel - Detailed view of the selected update

​
Viewing Updates

  1. The list shows all generated digests, sorted by date with the latest first
  2. Each row displays:
    • Period label (e.g., “Week of Jan 20”)
    • “Latest” badge for the most recent digest
    • “Partial” badge if some source data is unavailable
    • Accomplishment count (green checkmark)
    • Risk count (yellow/red warning icon)
  3. Click any row to view the full digest in the detail panel

​
Generating a Digest

1

Open Updates

Navigate to your product and click the “Analysis” section, then select the “Updates” tab
2

Click Generate

Click the “Generate” button in the sidebar header
3

Configure Options

In the dialog, select:
  • Time period - Choose from 7, 14, 30, 60, or 90 days
  • The dialog shows estimated credit usage for each period
4

Generate

Click “Generate Update” and wait for the AI to analyze your commits, PRs, issues, and decisions

​
Digest Contents

Each digest includes:
  • Executive Summary - High-level overview of the period in markdown format
  • Metrics - Clickable counts of commits, PRs, issues closed, and bugs fixed
    • Click any metric to view a detailed list of the underlying items
  • Accomplishments - Expandable list of completed work with source references
  • Risks & Blockers - Issues requiring attention, color-coded by severity (critical/high in red, medium/low in yellow)
  • Upcoming Milestones - Scheduled deadlines with dates

​
Sharing and Exporting

From the digest detail view, click the menu button (three dots) to access:
  • Export as PDF - Download a formatted PDF document
  • Export as Word - Download as a .docx file
  • Share Link - Generate a shareable public URL
  • Send via Email - Open an email dialog to send the digest to team members
Embed updates in Plans - Use the /update slash command in the Plan editor to embed a status update widget. This displays the period summary, accomplishments, and risk indicators directly in your planning documents.

​
Decisions

Document and track important product decisions in the Decisions section. Navigate to /products/[id]/analysis?analysisTab=decisions.

​
Decisions List

The Decisions tab displays all logged decisions with:
  • Status indicator - Color-coded dot showing outcome status
  • Summary - Brief decision description (click to view details)
  • Decision maker - Who made the final decision
  • Alternatives count - Number of alternatives considered
  • Type badge - Category of decision
  • AI indicator - Robot icon if extracted automatically by AI
  • Status badge - Current outcome status
  • Time - When the decision was made

​
Search and Filter

Use the toolbar to find specific decisions:
  • Search - Type to search decision summaries
  • Type filter - Filter by decision category
  • Stats - View average implementation time

​
Logging a Decision

1

Open Decisions

Navigate to your product and click the “Analysis” section, then select the “Decisions” tab
2

Click Log Decision

Click the “Log Decision” button in the top right
3

Select Type

Choose the decision category:
  • Architecture - System design and structure decisions
  • Technology - Tool, framework, or library choices
  • Feature - Product feature decisions
  • Process - Workflow and methodology decisions
  • Scope - Project scope changes
4

Enter Details

  • Summary - Brief description of the decision
  • Rationale - Why this decision was made
  • Decision Maker - Who made the final call
  • Alternatives Considered - Other options that were evaluated
5

Save

Click “Log Decision” to save with timestamp

​
Decision Detail View

Click any decision to open the detail sheet where you can:
  • View the full decision summary and rationale
  • See all alternatives that were considered
  • Review the decision context and related discussions
  • Update the outcome status

​
Decision Status

​
AI-Extracted Decisions

Kasava can automatically extract decisions from conversations and discussions. These are marked with a robot icon and initially show “Needs Review” status until verified.
Review AI-extracted decisions regularly to ensure accuracy and update their status once implemented.
Embed decisions in Plans - Use the /decision slash command in the Plan editor to embed a decision widget. This displays the decision outcome, rationale, and decision maker directly in your PRDs and architecture documents.

​
Insights (AI Analysis)

The Insights section displays AI-generated analysis of your product’s health, risks, and opportunities. Navigate to /products/[id]/analysis?analysisTab=insights.

​
Insights List

The Insights tab shows AI-generated observations about your product:
  • Priority indicator - Color-coded dot (critical, high, medium, low)
  • Expand chevron - Click to expand and see full details
  • Type icon - Visual indicator of insight category
  • Title - Brief insight summary
  • Metrics - Key numbers related to the insight
  • Type badge - Category label
  • Date - When the insight was generated
  • Actions - Acknowledge or delete buttons

​
Filtering Insights

Use the filter bar to focus on specific insights:
  • Type filter - Filter by insight category
  • Priority filter - Filter by severity level
  • Show acknowledged - Toggle to show/hide reviewed insights

​
Insight Types

​
Insight Priorities

​
Viewing Insight Details

Click any insight row to expand it and see:
  • Full description - Detailed explanation of the insight
  • All metrics - Complete list of relevant measurements
  • Related entities - Links to PRs, commits, or issues involved
  • Suggested actions - Recommendations for addressing the insight (for risk insights)
  • Affected files - Files involved with expandable code diffs (for risk insights)

​
Managing Insights

  • Acknowledge - Click the eye icon to mark an insight as reviewed (dimmed in the list)
  • Delete - Click the trash icon to remove an insight permanently
  • View Details - For risk insights, click “View Details” for an expanded sheet view

​
Generating New Insights

1

Click Rerun Analysis

Click the “Rerun Analysis” button in the filter bar
2

Select Analysis Period

Choose how far back to analyze:
  • 7 days - Quick analysis (~50-100 credits)
  • 14 days - Standard analysis (~100-200 credits)
  • 30 days - Comprehensive analysis (~200-400 credits)
  • 60 days - Extended analysis (~400-800 credits)
  • 90 days - Deep analysis (~800-1,200 credits)
3

Run Analysis

Click “Run Analysis” to generate new insights
Credit usage depends on repository size and commit volume. Longer periods provide more context but use more credits.

​
Ask a Question

In addition to automated insights, you can ask specific questions about your product:
1

Click Ask a Question

Click the “Ask a question” button in the filter bar
2

Select Data Sources

Choose what to analyze:
  • Commits
  • Pull Requests
  • Issues
  • Status Updates
3

Enter Your Question

Examples:
  • “What features were shipped last week?”
  • “Who worked on the authentication system?”
  • “What blockers have been mentioned?”
4

Get Answer

The AI provides a contextual answer with references
Select only relevant data sources for more focused answers and faster responses.
Embed insights in Plans - Use the /insight slash command in the Plan editor to embed an insight widget. This displays the insight severity, category, and suggested actions directly in your planning documents for context.

​
Repositories

Link repositories to your product in the Repositories section. Navigate to /products/[id]/repositories.

​
Linking Repositories

1

Open Repositories

Click “Repositories” in the product sidebar
2

Click Link Repository

Click the “Link Repository” button
3

Select Repositories

Choose from your indexed repositories
4

Assign Roles (Optional)

Specify repository roles (primary, supporting, etc.)
Linked repositories enable:
  • Code Search - Semantic search across the codebase
  • Activity Tracking - Commits and PRs appear in the timeline
  • AI Context - AI features understand the code structure
  • Documentation - Generate and view code documentation
Search across linked repositories using semantic search. Navigate to /products/[id]/code-search.
  • Enter natural language queries
  • Results ranked by relevance
  • View code snippets in context
  • Navigate directly to files in repositories

​
Documentation

View and manage generated documentation in the Documentation section. Navigate to /products/[id]/documentation.
  • Auto-generated API documentation
  • Architecture overviews
  • Component documentation
  • Function and method references

​
Timeline

View all product activity in chronological order. Navigate to /products/[id]/timeline.
  • Commits from linked repositories
  • Issues created and closed
  • Pull requests opened and merged
  • Digests generated
  • Decisions logged

​
Bug Reports

View bug reports associated with this product. Navigate to /products/[id]/bug-reports.
  • Filter by severity (high, medium, low)
  • View bug details including screenshots and environment info
  • Link to GitHub issues if created
  • Navigate to full bug reports page

​
Prototypes

Manage design prototypes and mockups. Navigate to /products/[id]/prototypes.
  • Link to Figma designs
  • Reference v0 prototypes
  • Attach design specifications
  • Track design iterations

​
PRDs (Plans)

Access Product Requirements Documents for this product. Navigate to /products/[id]/prds.
  • View all PRDs associated with this product
  • Create new PRDs directly from the product
  • Track PRD status and approvals

​
Best Practices

One Product per major initiative - Create separate Products for distinct projects or features to keep work organized.
Link all relevant repositories - The more repositories you link, the better the AI understands your codebase.
Run AI Discovery - Use the Knowledge section to let AI discover your product’s feature areas. This improves commit classification and digest quality.
Generate digests regularly - Weekly digests help track progress and identify issues early.
Document decisions - Important decisions are easy to forget; logging them preserves context for future reference.
Set measurable goals - Connect goals to data sources for automatic progress tracking.

Dashboard

Your home for work items and updates

Product Knowledge

AI-powered feature discovery and codebase understanding

PRD Management

Create and manage Product Requirements Documents

Integrations

Connect GitHub and other platforms