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

# Overview

> Track and manage unimplemented suggestions with the Kody Issues feature.

## Quick Overview

* **Auto-tracking**: Automatically captures unimplemented suggestions from closed PRs
* **Smart resolution**: Auto-resolves when suggestions are implemented in future PRs
* **Advanced filtering**: Filter by status, severity, category, and more, and save your default filters
* **Zero setup**: Works automatically with your existing code review workflow (turn it off with the **Auto-create issues** switch)

## What It Is

The **Kody Issues** feature automatically tracks all suggestions generated by Kody that were **not implemented** in your pull requests (PRs). It acts like a sonar, providing a live list of pending improvements to ensure you never lose sight of critical feedback.

Issues isn't a sidebar item: open it from the **Issues** tab in the [Cockpit](/en/how_to_use/cockpit/overview) (it shows the open-issue count), or search for **Issues** in the ⌘K command palette (the way in when your plan doesn't include the Cockpit). The list shows **Status**, **Severity**, **Category**, **Title**, **Repository**, **File**, **Age**, and **#PR(s)**, filtered to open issues by default. Click a row to open the issue's detail panel, where you can change its status and severity, step through issues with **J** / **K**, **Share** a link, and see **Team feedback from PR reactions**.

The **Auto-create issues** switch at the top right of the page turns automatic issue creation on or off for the workspace (on by default).

<Frame caption="Kody Issues dashboard showing tracked suggestions with filters and status management">
  <img src="https://mintcdn.com/kodus/O447Mtyto-OZAUba/images/issues.png?fit=max&auto=format&n=O447Mtyto-OZAUba&q=85&s=72ae6d780b56f8efdf1feea77a2b0747" alt="Kody Issues Dashboard" width="2296" height="1044" data-path="images/issues.png" />
</Frame>

## Key Benefits

<CardGroup cols={2}>
  <Card title="Continuous Visibility" icon="eye">
    Always stay aware of outstanding improvements without manual tracking
  </Card>

  <Card title="Quality Tracking" icon="chart-line">
    Prioritize and address critical fixes efficiently with severity levels
  </Card>

  <Card title="Error Prevention" icon="shield-check">
    Ensure vital suggestions don't fall through the cracks during development
  </Card>

  <Card title="Team Flexibility" icon="users">
    Customize statuses and severities to fit your workflow perfectly
  </Card>
</CardGroup>

## How It Works

### 1. Issue Creation

<Note>
  Issues are only created when PRs are **closed** - not when they're opened or
  during review.
</Note>

<Warning>
  Kody rules of type **PR** do not generate issues. Only file-level and code-specific suggestions create trackable issues.
</Warning>

* When a PR is **closed**, Kody compiles all suggestions made in that PR that were **not applied**
* For each unimplemented suggestion, Kody automatically creates an **Issue** linked to the repository
* Each issue includes the original suggestion context, file location, and severity level

### 2. Automatic Resolution

* If a developer implements the suggested change in a **subsequent PR**, Kody marks the associated Issue as **Resolved**
* Kody intelligently matches implemented changes to existing issues using code analysis
* Resolution happens automatically without manual intervention

### 3. Manual Management

#### Status Control

* **Open**: New issues requiring attention
* **Resolved**: Automatically marked when suggestions are implemented
* **Dismissed**: Manually marked when suggestions aren't relevant to your team

#### Severity Adjustment

* Each Issue has a severity level (`Critical`, `High`, `Medium`, `Low`)
* You can update severity levels at any time to reflect your team's priorities
* Use severity to focus on the most impactful improvements first

### 4. Advanced Filtering

<Warning>
  Filters are powerful tools - save them as your default to quickly access
  issues that matter most to your workflow.
</Warning>

Open **Filters** at the top of the list (the button shows how many are active):

* **Status filters**: Open, Resolved, Dismissed
* **Severity filters**: Critical, High, Medium, Low
* **Category filters**: Security, Performance, Code Style, etc.
* **Repository filters**: Focus on specific projects
* **Title, file path, and PR numbers**: Narrow down to specific issues
* **Set as default filters**: Automatically apply your preferred filters each time you open Issues in this browser (**Reset to default filters** brings them back)

## Why It Matters

### For Development Teams

* **Never lose track** of important code improvements
* **Prioritize work** based on actual impact and severity
* **Learn patterns** from commonly dismissed vs. implemented suggestions

### For Engineering Managers

* **Track code quality** trends across repositories
* **Identify bottlenecks** in suggestion implementation
* **Measure improvement** in code review follow-through

## Best Practices

<CardGroup cols={1}>
  <Card title="Regular Review Sessions" icon="calendar">
    Schedule weekly team reviews of open issues to maintain code quality
    momentum
  </Card>

  <Card title="Severity Guidelines" icon="triangle-exclamation">
    Establish team standards for when to adjust issue severity levels
  </Card>

  <Card title="Dismissal Criteria" icon="circle-xmark">
    Create clear guidelines for when issues should be dismissed vs. implemented
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Kody Rules Setup" icon="user-police" href="/en/how_to_use/code_review/configs/kody_rules">
    Configure custom rules that will be tracked as issues
  </Card>

  <Card title="Feedback on suggestions" icon="graduation-cap" href="/en/how_to_use/code_review/learning/kody_learning">
    Understand what feedback records and how to configure future reviews.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.