Install the app from the download page for {% data variables.copilot.github_copilot_app %}.
The {% data variables.copilot.github_copilot_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 {% data variables.product.github %} issues and pull requests, and manage the full development lifecycle—without context-switching between terminals, IDEs, and browser tabs.
The app is built on {% data variables.copilot.copilot_cli %} and integrates natively with {% data variables.product.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.
{% data reusables.gated-features.github-app %} {% data variables.copilot.copilot_business_short %} and {% data variables.copilot.copilot_enterprise_short %} users must have the {% data variables.copilot.copilot_cli_short %} policy enabled by an administrator.
The {% data variables.copilot.github_copilot_app %} supports the following operating systems:
- macOS
- Linux
- Windows
- Work in parallel. Run multiple agent sessions at the same time, each on its own branch, so you can make progress on several tasks without waiting for one to finish.
- Stay in one place. Triage issues, direct agents, review changes, and land pull requests without switching between your terminal, IDE, and browser.
- Start fast. The app connects to {% data variables.product.github %} natively—your repositories, branches, issues and pull requests work out of the box with no additional setup.
- Stay in control. Choose how much autonomy to give agents, from fully collaborative to fully autonomous, and adjust the model and reasoning effort for each session.
- Collaborate on a shared surface. Use canvases to create custom interfaces where people and agents can collaborate.
- Parallel workspaces: Run multiple isolated agent sessions simultaneously, each with a dedicated git worktree and branch. You can also run sessions in cloud sandboxes (public preview) hosted by {% data variables.product.github %}. For more information, see AUTOTITLE.
- Session modes: Choose how you work with agents: Interactive (collaborative), Plan (agent plans, you approve), or Autopilot (fully autonomous). You can also select from multiple LLMs and adjust reasoning effort for each session.
- Model selection: Select from multiple LLMs, including models from your own provider using bring your own key (BYOK), and adjust reasoning effort for each session.
- {% data variables.product.github %} integration: Browse and find issues, start sessions from them, create and close pull requests, review pull requests, view CI check results, and search across your repositories—all within the app.
- Customizations: Configure and use global instructions, MCP servers, and agent skills.
- Automations: Save recurring agent tasks and run them on a schedule or on demand.
- Quick chats: Brainstorm in a conversation mode without creating a dedicated branch or workspace.
- Session history: Use
/chronicleto get insights from previous sessions, including work you started in the app. - Canvases: Open custom, agent-driven artifacts and interfaces where people and agents can collaborate.
A typical workflow in the {% data variables.copilot.github_copilot_app %} looks like this:
- Browse issues in a repository and pick one up, or start from a blank workspace.
- Choose a session mode—Interactive, Plan, or Autopilot—and select a model.
- Describe the task and let the agent create a branch, write code, and run tests.
- Review the agent's changes, provide feedback, and iterate.
- Create a pull request, leave a review, check whether CI passed, and merge the PR—all from within the app.
You can run several of these workflows in parallel, each in its own workspace, and switch between them as needed.
Follow these practices to use {% data variables.product.prodname_ai_credits_short %} more efficiently in the app:
- Match model capability to task complexity. Use lighter models for straightforward changes and higher-capability models for complex debugging, design decisions, and multi-step tasks.
- Choose the right session mode for the stage of work. Use Plan mode to validate scope and approach, use Interactive mode when you want tighter steering, and move to Autopilot when the task is well-defined.
- Use quick chats to scope before opening a full session. For early exploration, use Quick chats to clarify requirements and reduce rework before creating a dedicated session.
- Start a new session when you switch tasks. A new session keeps context focused and avoids carrying irrelevant history into unrelated work.
- Use usage insights regularly. Run
/chronicle cost tipsto find expensive patterns in your session usage and improve efficiency over time.
For more detailed optimization tips, see AUTOTITLE.
To share feedback, click the Give feedback icon in the bottom-left corner of the app.
{% data variables.copilot.github_copilot_app %} may generate code that is a match or near match of publicly available code, even if the "Suggestions matching public code" policy is set to "Block." See AUTOTITLE.
