Initial commit

Clancey · jmoseley · cmcnally · Clancey · commit ab8ee457005c · 2026-05-11T13:01:56.000-08:00
Co-authored-by: Jeremy Moseley &lt;jemoseley@microsoft.com&gt;
Co-authored-by: cmcnally &lt;cmcnally@github.com&gt;
Co-authored-by: Copilot &lt;223556219+Copilot@users.noreply.github.com&gt;
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,56 @@
+name: Bug report
+description: Report a bug or unexpected behavior in the GitHub App.
+type: Bug
+labels:
+  - triage
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for reporting a bug. Please share as much detail as you can so the team can triage it quickly.
+  - type: input
+    id: title
+    attributes:
+      label: Short summary
+      description: A brief description of the problem.
+      placeholder: App installation fails for one repository
+  - type: input
+    id: version
+    attributes:
+      label: Affected version or release
+      description: Which app version, release tag, or build were you using?
+      placeholder: v1.2.3
+  - type: input
+    id: installation_context
+    attributes:
+      label: Installation context
+      description: Where is the app installed, and what scope was affected?
+      placeholder: Installed on octo-org, affecting octo-repo
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: Describe the bug and the behavior you observed.
+  - type: textarea
+    id: steps_to_reproduce
+    attributes:
+      label: Steps to reproduce
+      description: List the steps needed to reproduce the problem.
+      placeholder: |
+        1. Open ...
+        2. Click ...
+        3. Observe ...
+  - type: textarea
+    id: expected_behavior
+    attributes:
+      label: Expected behavior
+      description: What did you expect to happen instead?
+  - type: textarea
+    id: additional_context
+    attributes:
+      label: Additional context
+      description: Share any logs, screenshots, request IDs, or related details that could help.
+      placeholder: |
+        - Screenshot or screen recording
+        - Relevant org, repo, or environment details
+        - Any error messages or request IDs
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,42 @@
+name: Feature request
+description: Suggest an improvement for the GitHub App.
+type: Feature
+labels:
+  - triage
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for sharing an idea. Please describe the workflow and the problem you want the GitHub App to solve.
+  - type: input
+    id: title
+    attributes:
+      label: Feature summary
+      description: A short description of the idea or workflow gap.
+      placeholder: Add finer-grained installation controls
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem are you trying to solve?
+      description: Describe the current pain point or limitation.
+  - type: textarea
+    id: proposed_solution
+    attributes:
+      label: Proposed solution
+      description: Describe the behavior or capability you would like to see.
+  - type: textarea
+    id: impact
+    attributes:
+      label: Workflow impact
+      description: Who is affected, and how would this improve the GitHub App workflow?
+  - type: input
+    id: installation_context
+    attributes:
+      label: Installation context
+      description: If relevant, describe where the app is installed or which scope this request affects.
+      placeholder: Organization install for octo-org
+  - type: textarea
+    id: additional_context
+    attributes:
+      label: Additional context
+      description: Add mockups, examples, links, or related details here.
diff --git a/.github/commands/feedback.yml b/.github/commands/feedback.yml
@@ -0,0 +1,28 @@
+---
+trigger: feedback
+title: "GitHub App Feedback"
+surfaces:
+  - discussion
+description: Share your feedback on how the GitHub app is going.
+steps:
+  - type: fill
+    template: |-
+      Post this after your first session with the GitHub app. Don't overthink it &mdash; we want your gut reactions!
+
+      If comfortable, please record yourself launching the app for the first time [optional]. Feel free to answer the questions below in your recording by talking out loud rather than writing it down &ndash; no need to repeat your answers if you've already answered them verbally. You may attach your video to the discussion comment, or provide a link to a video.
+
+      You've had a few days with the app now. We'd love to hear how things have evolved.
+
+      Again, please feel free to share recordings of specific, real workflows that involve the GitHub app. Talk out loud and feel free to answer the questions below verbally in the video or through written answers.
+
+      **1. What have you tried doing with the app so far (e.g., start a new project, review a PR, write code, etc.), and why?**
+
+      **2. What has been most useful about this app? What tasks is it particularly suited for?**
+
+      **3. How does this experience compare to other tools you use today (e.g., Copilot in your IDE, Claude Code, Codex)? What does the GitHub app do better or worse?**
+
+      **4. What is missing, or confusing, if anything?**
+
+      **5. What type of tasks do you still feel like you need to go to github.com or other tools for?**
+
+      **6. If you had a magic wand to make this app just right for you, what would you change?**
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1 @@
+.DS_Store
diff --git a/README.md b/README.md
@@ -0,0 +1,63 @@
+# GitHub app
+
+The GitHub app is a desktop application for agent-driven development that brings parallel workstreams, GitHub integration, and PR lifecycle management into one place.
+
+> **Availability:** The GitHub app is in public preview. Copilot Business and Enterprise subscribers have access today. Copilot Pro and Pro+ subscribers can [sign up for early access](https://gh.io/github-app).
+
+![GitHub app](docs/readme-github-app.png)
+
+## Introduction and overview
+
+The GitHub app is a desktop application purpose-built for agent-driven development. It gives you a single place to direct AI agents across parallel workstreams, work with GitHub issues and pull requests, and manage the full development lifecycle&mdash;without context-switching between terminals, IDEs, and browser tabs.
+
+The app is built on GitHub Copilot CLI and integrates natively with GitHub, so your repositories, branches, and CI pipelines work out of the box. It's designed for workflows where you want to run multiple agents in parallel and stay focused on directing work rather than doing it all yourself.
+
+## Getting started
+
+### Prerequisites
+
+Make sure [Git](https://github.com/git-guides/install-git) is installed.
+
+You'll also need an active [Copilot subscription](https://github.com/features/copilot/plans).
+
+### Install
+
+Download the app for your platform:
+
+**Recommended**
+
+- [Mac (Apple Silicon)](../../releases/latest/download/GitHub-darwin-arm64.dmg)
+- [Windows](../../releases/latest/download/GitHub-windows-x64-setup.exe)
+- [Linux](../../releases/latest/download/GitHub-linux-x64.AppImage)
+
+**Alternate / older devices**
+
+- [Mac (Intel)](../../releases/latest/download/GitHub-darwin-x64.dmg)
+- [Windows (ARM)](../../releases/latest/download/GitHub-windows-arm64-setup.exe)
+
+You can also browse all builds on the [Releases](../../releases) page.
+
+For setup and a walkthrough of your first session, see the [documentation](https://gh.io/github-app-docs).
+
+## This repository
+
+This repo is the public home for the GitHub app. Use it to:
+
+- Download releases from the [Releases](../../releases) page
+- File bugs and feature requests
+- Join discussions
+- Read release notes in [`changelog.md`](./changelog.md)
+
+The application source lives elsewhere; this repo is for releases, issues, and discussion.
+
+
+## Feedback and issues
+
+Use the issue forms in this repository to report a bug or propose an improvement, join [Discussions](https://github.com/github/app/discussions/3), or send feedback from within the app. When filing an issue, please include:
+
+- The app version
+- Your operating system and version
+- Steps to reproduce
+- Expected vs. actual behavior
+- Screenshots or logs
+
diff --git a/changelog.md b/changelog.md
diff --git a/docs/readme-github-app.png b/docs/readme-github-app.png
