# github/app architecture

> Architecture diagram of the GitHub repository github/app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/github/app
- Repository: https://github.com/github/app

## Overview

This repository is the public home for the GitHub Copilot desktop app, not its implementation: the supplied tree contains no application source. The README describes a workflow for finding work, running and steering agents, reviewing progress in canvases, and helping land pull requests. The graph captures those documented capabilities and their stated environments; paths are null because no implementation paths are present, and all relationships are evidenced by the README.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_work["Work management"]
  node_app["Copilot app"]
  node_mywork["My Work"]
end

subgraph group_agents["Agent work"]
  node_local["Local sessions"]
  node_worktree["Git worktrees"]
  node_cloud["Cloud sessions"]
  node_agents["Coding agents"]
  node_canvases["Canvases"]
  node_automations["Automations"]
end

subgraph group_delivery["Delivery"]
  node_merge["Agent Merge"]
end

node_user(("Developer"))
node_githubenv["GitHub environments"]
node_github["GitHub repositories"]

node_user -->|"uses"| node_app
node_app -->|"provides context"| node_mywork
node_app -->|"runs sessions"| node_local
node_local -->|"isolates in"| node_worktree
node_app -->|"provides sessions"| node_cloud
node_cloud -->|"runs in"| node_githubenv
node_user -->|"steers"| node_agents
node_agents -->|"work shown in"| node_canvases
node_app -->|"provides"| node_automations
node_app -->|"provides"| node_merge
node_merge -->|"advances pull requests"| node_github

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_mywork toneBlue
class node_local,node_worktree,node_cloud,node_agents,node_canvases,node_automations toneAmber
class node_merge toneMint
class node_user,node_githubenv,node_github toneIndigo
```

## Components

### Work management

- **Copilot app**
- **My Work**

### Agent work

- **Local sessions**
- **Git worktrees**
- **Cloud sessions**
- **Coding agents**
- **Canvases**
- **Automations**

### Delivery

- **Agent Merge**

### Other components

- **Developer**
- **GitHub environments**
- **GitHub repositories**

## Connections

- Developer → Copilot app: uses (evidence: `README.md`)
- Copilot app → My Work: provides context (evidence: `README.md`)
- Copilot app → Local sessions: runs sessions (evidence: `README.md`)
- Local sessions → Git worktrees: isolates in (evidence: `README.md`)
- Copilot app → Cloud sessions: provides sessions (evidence: `README.md`)
- Cloud sessions → GitHub environments: runs in (evidence: `README.md`)
- Developer → Coding agents: steers (evidence: `README.md`)
- Coding agents → Canvases: work shown in (evidence: `README.md`)
- Copilot app → Automations: provides (evidence: `README.md`)
- Copilot app → Agent Merge: provides (evidence: `README.md`)
- Agent Merge → GitHub repositories: advances pull requests (evidence: `README.md`)
