Document Copilot app launcher links

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: basiclines

content/copilot/how-tos/github-copilot-app/index.md

@@ -1,7 +1,7 @@
 ---
-title: '{% data variables.copilot.github_copilot_app %}'
-shortTitle: '{% data variables.copilot.github_copilot_app %}'
-intro: 'A desktop application for agent-driven development that brings parallel workstreams, {% data variables.product.github %} integration, and PR lifecycle management into one place.'
+title: "{% data variables.copilot.github_copilot_app %}"
+shortTitle: "{% data variables.copilot.github_copilot_app %}"
+intro: "A desktop application for agent-driven development that brings parallel workstreams, {% data variables.product.github %} integration, and PR lifecycle management into one place."
 versions:
   feature: copilot
 contentType: how-tos
@@ -17,6 +17,7 @@ redirect_from:
   - /copilot/how-tos/github-app
 children:
   - /getting-started
+  - /open-from-github
   - /customize-github-copilot-app
   - /agent-sessions
   - /working-with-canvas-extensions

content/copilot/how-tos/github-copilot-app/open-from-github.md

@@ -0,0 +1,89 @@
+---
+title: Opening the GitHub Copilot app from GitHub
+shortTitle: Open from GitHub
+allowTitleToDifferFromFilename: true
+intro: "Use links from {% data variables.product.github %} to open repositories, issues, pull requests, and agent tasks directly in the {% data variables.copilot.github_copilot_app %}."
+product: '{% data reusables.gated-features.github-app %}<br><a href="https://github.com/features/copilot/plans?ref_product=copilot&ref_type=purchase&ref_style=button&utm_source=docs-open-from-github-signup&utm_medium=docs&utm_campaign=github-copilot-app-ga-2026" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline"><span>Sign up for {% data variables.product.prodname_copilot_short %}</span> {% octicon "link-external" height:16 %}</a>'
+versions:
+  feature: copilot
+contentType: how-tos
+category:
+  - Author and optimize with Copilot
+---
+
+You can open the {% data variables.copilot.github_copilot_app %} from {% data variables.product.github %} links that wrap an app link in the hosted launcher. The hosted launcher opens the app when possible and keeps a fallback page available if the browser cannot hand off to the app.
+
+## Launcher URL format
+
+Use the hosted launcher URL with an `entry_point` value and an encoded app link in `open`.
+
+```text
+https://github.com/copilot/app/launch?entry_point=ENTRY_POINT&open=ENCODED_APP_LINK
+```
+
+- `entry_point` identifies the source of the link. Use a stable, low-cardinality value, such as the name of the surface that renders the link.
+- `open` is the URL-encoded app link to open.
+
+Public examples should use the `ghapp://` scheme. The app also accepts `github-app://` and `gh://` links.
+
+## Repository link
+
+To open a repository in the app, encode an app link in this format.
+
+```text
+ghapp://github.com/OWNER/REPO
+```
+
+For example:
+
+```text
+https://github.com/copilot/app/launch?entry_point=docs_repo_link&open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO
+```
+
+## Issue link
+
+To open an issue in the app, encode an app link in this format.
+
+```text
+ghapp://github.com/OWNER/REPO/issues/123
+```
+
+For example:
+
+```text
+https://github.com/copilot/app/launch?entry_point=docs_issue_link&open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fissues%2F123
+```
+
+## Pull request link
+
+To open a pull request in the app, encode an app link in this format.
+
+```text
+ghapp://github.com/OWNER/REPO/pull/123
+```
+
+For example:
+
+```text
+https://github.com/copilot/app/launch?entry_point=docs_pull_request_link&open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fpull%2F123
+```
+
+## Agent task link
+
+To resume a Copilot agent task in the app, encode an app link in this format.
+
+```text
+ghapp://github.com/OWNER/REPO/tasks/TASK_ID
+```
+
+For example:
+
+```text
+https://github.com/copilot/app/launch?entry_point=docs_agent_task_link&open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Ftasks%2FTASK_ID
+```
+
+Use the GitHub task ID for `TASK_ID`. Do not use a runtime session ID or an app-local session URL for links that resume Copilot agent tasks from {% data variables.product.github %}.
+
+## Attribution and privacy
+
+Use `entry_point` to attribute the link source without duplicating details from the `open` target. Keep the value generic and stable, and do not include repository names, issue or pull request numbers, branch names, task IDs, prompts, or raw app links in analytics events.