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

# Manage applications

> Group repositories into applications for aggregated vulnerability tracking and reporting.

## Overview

Applications let you group related repositories together. Once grouped, you can view aggregated vulnerability metrics, export a combined SBOM, and filter vulnerabilities by application.

## Prerequisites

* A Cysmiq workspace with connected repositories
* Permission to create applications

## Create an application

<Steps>
  <Step title="Open Applications">
    From the sidebar, select **Applications**. If you have no applications yet, the list will be empty.

    <Frame caption="The Applications page shows all applications in your workspace.">
      <img src="https://mintcdn.com/cysmiq/b1Lbo3Hes6--JS1V/images/guides/manage-applications/manage-applications-01-applications.webp?fit=max&auto=format&n=b1Lbo3Hes6--JS1V&q=85&s=a7428b95fa8bbf608ff4bc4a594a1288" alt="Applications page with New Application button." width="2880" height="2160" data-path="images/guides/manage-applications/manage-applications-01-applications.webp" />
    </Frame>
  </Step>

  <Step title="Create a new application">
    Select **New Application** to open the creation form.

    Enter a **Name** for the application and an optional **Description** to help teammates understand its purpose.

    Under **Select Assets**, choose the repositories to include. You can select multiple repositories from the dropdown.

    <Frame caption="Fill in the application name, description, and assets.">
      <img src="https://mintcdn.com/cysmiq/b1Lbo3Hes6--JS1V/images/guides/manage-applications/manage-applications-02-form-filled.webp?fit=max&auto=format&n=b1Lbo3Hes6--JS1V&q=85&s=e21b5aad54717e35ad29d54a5ef60652" alt="Create New Application form with name, description, and assets selected." width="2880" height="2160" data-path="images/guides/manage-applications/manage-applications-02-form-filled.webp" />
    </Frame>

    Select **Create** to save the application.
  </Step>

  <Step title="Open the new application">
    After the application is created, it appears in the list. Select the application to open it.

    <Frame caption="Select the application from the list to open it.">
      <img src="https://mintcdn.com/cysmiq/b1Lbo3Hes6--JS1V/images/guides/manage-applications/manage-applications-04-list.webp?fit=max&auto=format&n=b1Lbo3Hes6--JS1V&q=85&s=e90ca9e047d33d30d0c1a40f04432d0b" alt="Applications list with a newly created application." width="2880" height="2160" data-path="images/guides/manage-applications/manage-applications-04-list.webp" />
    </Frame>
  </Step>
</Steps>

## View the application

The application overview displays:

* **Linked Assets**: Number of repositories in the application
* **Vulnerability Trend**: Open and fixed vulnerabilities over time
* **Severity Distribution**: Breakdown by severity level
* **Vulnerability Breakdown by Asset**: Per-repository vulnerability counts
* **Frequent Violations**: Most common vulnerability types

<Frame caption="The application overview shows aggregated vulnerability data.">
  <img src="https://mintcdn.com/cysmiq/b1Lbo3Hes6--JS1V/images/guides/manage-applications/manage-applications-03-created.webp?fit=max&auto=format&n=b1Lbo3Hes6--JS1V&q=85&s=f004a16db47ff0000b5e649702506bd4" alt="Application overview showing vulnerability trends, severity distribution, and asset breakdown." width="2880" height="2160" data-path="images/guides/manage-applications/manage-applications-03-created.webp" />
</Frame>

## View application assets

Open the **Assets** tab to see all repositories linked to the application. Each row shows the repository name, type, vulnerability counts, and last scan time.

<Frame caption="The Assets tab lists all repositories in the application.">
  <img src="https://mintcdn.com/cysmiq/b1Lbo3Hes6--JS1V/images/guides/manage-applications/manage-applications-05-assets-tab.webp?fit=max&auto=format&n=b1Lbo3Hes6--JS1V&q=85&s=1102e251db1e1603ca0cfe66d585bd63" alt="Assets tab showing linked repositories with vulnerability counts." width="2880" height="2160" data-path="images/guides/manage-applications/manage-applications-05-assets-tab.webp" />
</Frame>

From this tab you can:

* Select the plus icon (Add assets) to link additional repositories
* Remove a repository by selecting the remove icon in the Actions column

## Edit or delete an application

Open the **Settings** tab to update the application name or description. Select **Save changes** to apply updates.

<Frame caption="Update application details or delete the application from Settings.">
  <img src="https://mintcdn.com/cysmiq/b1Lbo3Hes6--JS1V/images/guides/manage-applications/manage-applications-06-settings-tab.webp?fit=max&auto=format&n=b1Lbo3Hes6--JS1V&q=85&s=56dbf456f6df4d11315882888328988d" alt="Application settings showing name, description fields and delete option." width="2880" height="2160" data-path="images/guides/manage-applications/manage-applications-06-settings-tab.webp" />
</Frame>

To delete an application, select **Delete Application** in the Danger Zone. Deleting an application removes the grouping but does not delete the underlying repositories or their vulnerabilities.

## Export an SBOM

From any application tab, select **Download SBOM** to export a software bill of materials that combines all repositories in the application.

## Related docs

* [Applications](/concepts/applications)
* [SBOMs](/concepts/sboms)
* [Assets](/concepts/assets)