Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,7 @@ docsTeamMetrics:
- copilot-cli
---

> [!NOTE]
> The new tabbed interface is currently in {% data variables.release-phases.public_preview %} and is subject to change.

An interactive {% data variables.copilot.copilot_cli_short %} session has four tabs at the top of the screen:
By default, interactive {% data variables.copilot.copilot_cli_short %} sessions for Git repositories have four tabs at the top of the screen:
* **Session**: The regular chat experience where you enter prompts for {% data variables.product.prodname_copilot_short %}.
* **Issues**: Open issues in the current repository on {% data variables.product.prodname_dotcom %}.
* **Pull requests**: Open pull requests in the current repository on {% data variables.product.prodname_dotcom %}.
Expand All @@ -28,15 +25,19 @@ The **Issues**, **Pull requests**, and **Gists** tabs let you browse content fro
* **Pull an item into your chat** — quickly insert a reference to the selected item into the prompt box so that you can ask {% data variables.product.prodname_copilot_short %} to investigate, fix, comment on, or review it.
* **Jump to an item on {% data variables.product.prodname_dotcom_the_website %}** — for example when you want to comment on an issue, merge a pull request, or edit a gist.

> [!NOTE]
> The **Issues** and **Pull requests** tabs are only shown when {% data variables.copilot.copilot_cli_short %} is running inside a {% data variables.product.prodname_dotcom %} repository. In other directories, only the **Session** and **Gists** tabs are shown.

## Switching between tabs

* Press <kbd>Tab</kbd> to move to the next tab.
* Press <kbd>Shift</kbd>+<kbd>Tab</kbd> to move to the previous tab.

Tab switching is paused while another part of the CLI—such as the slash command picker—is observing your keystrokes.
* Use the mouse to click on a tab to switch to it.

> [!NOTE]
> The **Issues** and **Pull requests** tabs are only shown when {% data variables.copilot.copilot_cli_short %} is running inside a {% data variables.product.prodname_dotcom %} repository. In other directories, only the **Session** and **Gists** tabs are shown.
> Clicking tabs requires mouse support. This is enabled by default but can be disabled with the `--no-mouse` command-line option. Use the `--mouse=on` option to re-enable mouse support if it has been disabled.

Tab switching is paused while another part of the CLI—such as the slash command picker—is observing your keystrokes.

## Common keyboard controls

Expand All @@ -47,6 +48,7 @@ The **Issues**, **Pull requests**, and **Gists** tabs all use the same controls.
* Press <kbd>Enter</kbd> to display a detailed view of the highlighted item. Press <kbd>Esc</kbd> in the details view to return to the list.
* Press <kbd>o</kbd> to open the highlighted item (or, in the detailed view, the current item) on {% data variables.product.prodname_dotcom_the_website %}.
* Press <kbd>c</kbd> to insert a reference to the item into the prompt input area and jump back to the **Session** tab.
* Press <kbd>/</kbd> (on the **Issues** and **Pull requests** tabs) to search {% data variables.product.prodname_dotcom %} with a custom query. Type a query, press <kbd>Enter</kbd> to run it, and <kbd>Esc</kbd> to cancel or clear it.

For the full set of keypresses you can use, see [Keyboard reference](#keyboard-reference) at the end of this article.

Expand Down Expand Up @@ -74,6 +76,16 @@ Pressing <kbd>c</kbd> inserts a reference to the pull request into the prompt bo
#5678 check this out and run tests
```

## Searching issues and pull requests

By default, the **Issues** and **Pull requests** tabs show items that involve you. Press <kbd>a</kbd> to toggle between this (`involves:@me`) and all open items.

To run your own search, press <kbd>/</kbd>. An inline search box opens where you can type a {% data variables.product.prodname_dotcom %} search query, then press <kbd>Enter</kbd> to run it.

Press <kbd>Esc</kbd> to cancel while typing, or to clear an applied search and return to the default list.

You can use the same set of search qualifiers that are available on {% data variables.product.prodname_dotcom_the_website %}. See [AUTOTITLE](/search-github/searching-on-github/searching-issues-and-pull-requests).

## Browsing your gists

The **Gists** tab lists the gists owned by the {% data variables.product.prodname_dotcom %} account you are signed in to. Both public and secret gists are shown. Unlike the **Issues** and **Pull requests** tabs, the **Gists** tab is not scoped to a repository—it is always available, regardless of where you started the CLI.
Expand Down Expand Up @@ -103,6 +115,24 @@ The **Issues**, **Pull requests**, and **Gists** tabs are read-only environments
https://gist.github.com/USERNAME/GIST-ID delete this
```

## Customizing the tabs

You can reorder, hide, or turn off the tabs in your settings file (`~/.copilot/settings.json`) using the `tabs` object:

```json copy
{
"tabs": {
"enabled": true,
"sort": ["copilot", "pull-requests", "issues", "gists"],
"hide": ["gists"]
}
}
```

* `enabled`: set to `false` to turn off the tabbed interface entirely.
* `sort`: the order in which tabs appear. Use the identifiers `copilot` (the **Session** tab), `issues`, `pull-requests`, and `gists`. Any tabs you omit keep their default order after the ones you list. Unknown identifiers are ignored.
* `hide`: tabs to hide, using the same identifiers. The **Session** tab (`copilot`) cannot be hidden.

## Keyboard reference

The footer hint bar in the **Issues**, **Pull requests**, and **Gists** tabs summarizes the available keys:
Expand All @@ -116,4 +146,7 @@ The footer hint bar in the **Issues**, **Pull requests**, and **Gists** tabs sum
| <kbd>o</kbd> | List view or details view | Open the highlighted item on {% data variables.product.prodname_dotcom_the_website %} in your browser. |
| <kbd>c</kbd> | List view or details view | Insert a reference to the item into the prompt input area and jump back to the **Session** tab. |
| <kbd>a</kbd> | List view on **Issues** and **Pull requests** tabs | Toggle between showing only items that involve you and showing every open item in the repository. |
| <kbd>/</kbd> | List view on **Issues** and **Pull requests** tabs | Open a search box. |
| <kbd>Enter</kbd> | Search box | Run the search query. |
| <kbd>Esc</kbd> | Search box / applied search | Cancel the search box, or dismiss the search results. |
| <kbd>Esc</kbd> | Details view | Return to the list view. |
1 change: 0 additions & 1 deletion data/reusables/copilot/plans/copilot-max-upgrade-only.md

This file was deleted.

3 changes: 0 additions & 3 deletions data/reusables/projects/sunset_notice_content.md

This file was deleted.

94 changes: 0 additions & 94 deletions data/tables/copilot/model-multipliers.yml

This file was deleted.

1 change: 1 addition & 0 deletions data/ui.yml
Original file line number Diff line number Diff line change
Expand Up @@ -293,6 +293,7 @@ secret_scanning:
webhooks:
action_type_switch_error: There was an error switching webhook action types.
action_type: Action type
action_type_selected: "'{{ actionType }}' action selected. {{ description }}"
availability: Availability for <code>{{ WebhookName }}</code>
webhook_payload_object: Webhook payload object for <code>{{ WebhookName }}</code>
webhook_payload_example: Webhook payload example
Expand Down
43 changes: 27 additions & 16 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -225,7 +225,7 @@
"is-svg": "6.0.0",
"javascript-stringify": "^2.1.0",
"js-cookie": "^3.0.7",
"js-yaml": "^4.1.1",
"js-yaml": "^4.2.0",
"liquidjs": "^10.27.0",
"lodash": "^4.18.0",
"lodash-es": "^4.18.0",
Expand Down

This file was deleted.

1 change: 1 addition & 0 deletions src/fixtures/fixtures/data/ui.yml
Original file line number Diff line number Diff line change
Expand Up @@ -293,6 +293,7 @@ secret_scanning:
webhooks:
action_type_switch_error: There was an error switching webhook action types.
action_type: Action type
action_type_selected: "'{{ actionType }}' action selected. {{ description }}"
availability: Availability for <code>{{ WebhookName }}</code>
webhook_payload_object: Webhook payload object for <code>{{ WebhookName }}</code>
webhook_payload_example: Webhook payload example
Expand Down
18 changes: 18 additions & 0 deletions src/graphql/data/fpt/changelog.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,22 @@
[
{
"schemaChanges": [
{
"title": "The GraphQL schema includes these changes:",
"changes": []
}
],
"previewChanges": [],
"upcomingChanges": [
{
"title": "The following changes will be made to the schema:",
"changes": [
"<p>On member <code>CopilotAgentTask.type</code>:<code>type</code> will be removed. Use <code>codingAgentFilter</code> and <code>codingAgentTypeFilter</code> instead. <strong>Effective 2026-10-01</strong>.</p>"
]
}
],
"date": "2026-06-23"
},
{
"schemaChanges": [
{
Expand Down
8 changes: 8 additions & 0 deletions src/graphql/data/fpt/graphql_upcoming_changes.public.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7998,6 +7998,14 @@ upcoming_changes:
date: '2026-07-01T00:00:00+00:00'
criticality: breaking
owner: peter-evans
- location: CopilotAgentTask.type
description:
'`type` will be removed. Use `codingAgentFilter` and `codingAgentTypeFilter`
instead.'
reason: '`type` will be removed.'
date: '2026-10-01T00:00:00+00:00'
criticality: breaking
owner: github/copilot-mission-control
- location: User.viewerRelevantRepositories
description:
'`viewerRelevantRepositories` will be removed. Use viewerCopilotChatRepositorySuggestions
Expand Down
8 changes: 8 additions & 0 deletions src/graphql/data/fpt/upcoming-changes.json
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,14 @@
"date": "2026-10-01",
"criticality": "breaking",
"owner": "github/client-apps-platform"
},
{
"location": "CopilotAgentTask.type",
"description": "<p><code>type</code> will be removed. Use <code>codingAgentFilter</code> and <code>codingAgentTypeFilter</code> instead.</p>",
"reason": "<p><code>type</code> will be removed.</p>",
"date": "2026-10-01",
"criticality": "breaking",
"owner": "github/copilot-mission-control"
}
],
"2026-07-01": [
Expand Down
Loading
Loading