> For the complete documentation index, see [llms.txt](https://ainur.gitbook.io/unideck-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ainur.gitbook.io/unideck-docs/reference-and-spec/widgets/github-issues.md).

# GitHub - Issues

The **GitHub Issues Widget** in UniDeck enables you to monitor and manage issues from your GitHub repositories directly on your dashboard, helping you stay organized and up-to-date with your projects.

### Widget Sizes

To accommodate different user preferences and dashboard layouts, the GitHub Issues Widget is available in the following sizes:

* **Medium**: Provides a balanced view, displaying a list of recent issues with essential details.
* **Large**: Offers an extensive overview, showcasing more issues with additional information for in-depth monitoring.

<table data-card-size="large" data-view="cards" data-full-width="true"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td align="center">Medium</td><td><a href="/files/M0ZtN3vif7bNWUdAcLSO">/files/M0ZtN3vif7bNWUdAcLSO</a></td></tr><tr><td align="center">Large</td><td><a href="/files/AnPYpaJCWAkSeTUbRP4r">/files/AnPYpaJCWAkSeTUbRP4r</a></td></tr></tbody></table>

### Functionality

Designed to integrate seamlessly with your GitHub account, the GitHub Issues Widget allows you to:

* **Monitor Issues**: View and track the status of issues across selected repositories.
* **Stay Informed**: Receive real-time updates on issue activities, ensuring timely responses and resolutions.

### Configuration and Context Menu

The GitHub Issues Widget offers customizable settings to tailor its functionality to your needs:

* **Configuration**:
  * **Accessing Configuration**: Click the "Configure" button located in the top right corner of the widget to open the configuration modal.
  * **Filtering Options**: Customize the issues displayed by applying filters:
    * **Filter By**:
      * **Assigned**: Issues assigned to you.
      * **Created**: Issues you have created.
      * **Mentioned**: Issues where you are mentioned.
      * **Subscribed**: Issues you are subscribed to.
      * **Repos**: Issues across selected repositories.
      * **All**: All issues.
    * **State**:
      * **Open**: Currently open issues.
      * **Closed**: Issues that have been closed.
      * **All**: Both open and closed issues.
    * **Sort By**:
      * **Created**: Sort by creation date.
      * **Updated**: Sort by last update.
      * **Comments**: Sort by the number of comments.
    * **Direction**:
      * **Ascending**: Sort in ascending order.
      * **Descending**: Sort in descending order.
* **Context Menu**:
  * **Adjust Size**: Right-clicking on the widget opens a context menu where you can switch between Medium and Large sizes to fit your dashboard layout.
  * **Configure Widget**: Access the configuration modal to update user/organization, repository selections, and apply filters as needed.

By incorporating the GitHub Issues Widget into your UniDeck dashboard, you can efficiently manage your project issues, ensuring that all tasks are promptly addressed and your projects remain on track.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ainur.gitbook.io/unideck-docs/reference-and-spec/widgets/github-issues.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
