GitHub Copilot CLI
Brings the power of Copilot coding agent directly to your terminal
Install with Homebrew
brew install --cask copilot-cliQuick Take: GitHub Copilot CLI
Use Copilot CLI when your team already sits on Copilot seats and lives in GitHub Issues and pull requests. You get `/plan`, `/fleet`, GitHub-native MCP, `/delegate` PRs, and GPT-5.6 Sol/Terra/Luna via `/model`, billed in AI Credits (Pro is $10/month with 1,500 credits; Pro+ $39 with 7,000; Max $100 with 20,000). Remove `github/gh-copilot` on day one; that suggest/explain path died on 25 October 2025. Watch Sol plus `/fleet` credit burn, confirm Business/Enterprise admins enabled the CLI and models, and keep Claude Code, Codex, Cursor, Warp AI, Amazon Q CLI, or Muse Code in the bake-off if GitHub coupling is not your constraint.
Best For
- •Developers living in GitHub Issues and pull requests
- •Teams that already pay for Copilot seats
- •Terminal-first Mac workflows that still hand off to VS Code
- •Engineers who need parallel subagents and multi-model comparison
- •Orgs that require Copilot policy inheritance on agent tools
What is GitHub Copilot CLI?
GitHub Copilot CLI is GitHub's standalone agentic coding agent for the terminal. It replaces the older gh copilot suggest / gh copilot explain extension. The current product installs as @github/copilot (npm), via curl -fsSL https://gh.io/copilot-install | bash, or with Homebrew (brew install --cask copilot-cli). You run a GitHub-native agent in your shell that plans work, edits repositories, opens pull requests, talks to issues through native GitHub MCP, and can fan out parallel subagents with /fleet.
This is a breaking mental-model change from 2024-mid-2025 docs. The github/gh-copilot GitHub CLI extension, commands like gh copilot suggest and gh copilot explain, was deprecated on 25 October 2025. If that extension is still installed, remove it with gh extension remove github/gh-copilot and migrate to the standalone Copilot CLI. The new tool is an agentic runtime: /plan to outline work, Shift+Tab to move between plan and autopilot modes, /model to pick models, /delegate to push implementation toward a PR, /resume to continue long sessions, plus skills, AGENTS.md guidance, and MCP (including GitHub-native issue/PR context).
Models matter because CLI interactions draw AI Credits. On 9 July 2026 GitHub announced OpenAI's GPT-5.6 Sol, Terra, and Luna in Copilot, including Copilot CLI's model picker. Sol is the high-reasoning tier for large codebases and long agent runs; Terra is the balanced default; Luna is the lightweight, cost-efficient option. Anthropic and Google models are also available in Copilot's broader catalog (subject to plan and admin policy). Copilot Business/Enterprise admins may need to enable GPT-5.6 policies. Sol availability skews to Pro+/Max/Business/Enterprise; Terra and Luna reach Pro and above (plus higher tiers).
Access is included with Copilot Free, Pro, Pro+, Max, Business, and Enterprise. Usage is not "unlimited agent loops": each agent interaction consumes GitHub AI Credits from your plan allowance (1 AI credit = $0.01 USD). Individual paid examples as of August 2026 docs: Pro $10/month with 1,500 total monthly AI credits (1,000 base + 500 flex); Pro+ $39/month with 7,000; Max $100/month with 20,000. Free/Student plans include limited AI-credit allowances with auto model selection constraints. Code completions remain outside AI-credit billing on paid plans; Copilot CLI agent work does consume credits. Exceeding the included pool means upgrading, setting an additional-usage budget, or waiting for the monthly UTC reset.
On a Mac, Copilot CLI fits terminal-first workflows alongside Ghostty, iTerm2, Warp, or Terminal.app. It can start a /plan in the CLI and continue in VS Code, or stay entirely in the shell for issue-to-commit loops. Native GitHub MCP means the agent can search issues, reason about labels/activity, and /delegate a branch + PR without bolting on a third-party GitHub integration first. Organization guardrails still apply: branch protections, required checks, and Copilot Business/Enterprise policies follow the agent. File edits and command execution are approval-gated, you remain responsible for reviewing /diff output.
Competitive set in August 2026: Anthropic Claude Code (terminal/IDE agent on Claude models), OpenAI Codex CLI / Codex-in-ChatGPT, Cursor (AI editor), Warp AI (terminal-bound), Amazon Q CLI (AWS-weighted), and Meta Muse Code (newer terminal agent narrative). Copilot CLI's differentiator is GitHub-native MCP, billing through existing Copilot seats/credits, and deep issue/PR/delegate loops for teams already standardized on GitHub.
Who it is for: developers who live in git + GitHub Issues/PRs and want an agent that does not abandon the terminal; teams that already pay for Copilot and want CLI parity with IDE agents; engineers who need /fleet parallelism or multi-model comparison on one task. Who should be careful: anyone still following tutorials that only mention gh copilot suggest (obsolete); orgs whose admins disabled Copilot CLI; users who expect offline operation; people who only need occasional one-liner shell help (the old suggest/explain niche), the new CLI is a heavier agentic product with credit burn to match.
Install prerequisites include an active Copilot subscription (or entitled Free access) and, for npm, Node.js 22+. First launch uses /login (or a fine-grained PAT with Copilot Requests via COPILOT_GITHUB_TOKEN / GH_TOKEN / GITHUB_TOKEN). Keep Copilot CLI updated (docs cite minimum versions for accurate usage/billing UI; prefer latest stable). Use /changelog and /experimental show to track preview capabilities.
Practically, start with a small /plan on a scratch branch, pick Terra or Luna while learning cost dynamics, enable AGENTS.md with build/test commands, and only then try Sol or /fleet on expensive refactors. Treat autopilot as a power mode after you trust the approval UX. Migrate muscle memory: aliases pointing at gh copilot suggest should be deleted; teach the team the slash-command vocabulary instead.
As of 2026-08-09 the product to document is the agentic CLI on @github/copilot: bundled with Copilot plans, metered by AI Credits, with GPT-5.6 Sol, Terra, and Luna in the picker. Retire suggest/explain language from runbooks and onboarding. The github/gh-copilot extension was deprecated on 25 October 2025.
Closer look: From gh-copilot to Agentic Copilot CLI
Understanding the product break is essential for accurate documentation and onboarding in 2026.
History & Background
Early Copilot CLI experiences shipped as a GitHub CLI extension focused on natural-language suggest/explain for shell and git. That extension (github/gh-copilot) was deprecated 25 October 2025. GitHub replaced the mental model with a standalone agentic Copilot CLI distributed as @github/copilot and related installers, aligned with Copilot's broader agent runtime and SDK story.
How It Works
The agent runs locally in your terminal, authenticates to GitHub, uses models routed through Copilot, and can call MCP servers, including GitHub-native MCP for issues/PRs. Slash commands orchestrate planning, model selection, parallel subagents, delegation, and session resume. Approvals gate filesystem and shell side effects. Credits meter token usage by model.
Key Features
Agentic planning with /plan and Shift+Tab modes
Outline multi-step work with `/plan`, then Shift+Tab between plan mode and autopilot when you want Copilot to carry tasks forward without step-by-step approval. Plans can move from CLI into VS Code for refinement.
/fleet parallel subagents
Run the same task across parallelized subagents and converge on a decision-ready result. Useful for comparing approaches or accelerating exploration while you retain control over what gets applied.
/model picker including GPT-5.6 Sol, Terra, and Luna
Switch models per task. GPT-5.6 Sol targets high-reasoning/long agent work; Terra is the balanced default; Luna optimizes for speed/cost. Anthropic and Google models are also part of Copilot's multi-provider catalog subject to plan/policy.
GitHub-native MCP, issues, and /delegate PRs
Built-in GitHub MCP support lets the agent work with issues, branches, and pull requests. `/delegate` can create a branch, implement, and open a PR; `/diff` keeps review in the loop. `/remote` supports steering work from GitHub.com or mobile.
Session continuity with /resume, skills, and AGENTS.md
Long-running work can `/resume` with memory/compaction so history does not collapse. AGENTS.md and Agent Skills shape instructions and tool access across models and delegated jobs.
Approval-gated edits under existing GitHub guardrails
File changes and command execution require explicit approval. Branch protections, required checks, and Business/Enterprise Copilot policies still apply, CLI does not bypass org governance.
Flexible install channels
Install via `npm install -g @github/copilot`, the gh.io install script, Homebrew cask `copilot-cli`, WinGet on Windows, or direct GitHub releases, then authenticate with `/login` or a fine-grained PAT.
Who Should Use GitHub Copilot CLI?
1GitHub-centric full-stack developer
Starts Copilot CLI in a repo, runs `/plan` against a linked issue via GitHub MCP, uses Terra for implementation, reviews `/diff`, then `/delegate` to open a PR without leaving the terminal.
2Staff engineer unblocking a thorny refactor
Selects GPT-5.6 Sol for deep reasoning, kicks `/fleet` to explore two migration strategies in parallel, merges the better plan into autopilot on a worktree, and keeps CI green under branch protections.
3Platform team on Copilot Business
Admins enable Copilot CLI and GPT-5.6 policies, engineers authenticate with org accounts, and AGENTS.md standardizes test commands across services while credits are monitored in the usage dashboard.
4Developer migrating off gh-copilot
Removes `github/gh-copilot`, installs `@github/copilot`, deletes obsolete `??` suggest aliases, and relearns slash commands for agentic workflows instead of one-shot shell translation.
How to Install GitHub Copilot CLI on Mac
Install the standalone Copilot CLI (not the deprecated gh extension). You need an active Copilot plan (Free/Pro/Pro+/Max/Business/Enterprise as entitled). npm installs require Node.js 22+.
Remove the deprecated gh-copilot extension if present
Run gh extension remove github/gh-copilot. The old gh copilot suggest / gh copilot explain extension was deprecated 25 October 2025 and is not the current product.
Install Copilot CLI
Pick one: npm install -g @github/copilot, or curl -fsSL https://gh.io/copilot-install | bash, or brew install --cask copilot-cli. (WinGet is available on Windows: winget install GitHub.Copilot.)
Authenticate
Launch Copilot CLI and run /login, or export a fine-grained PAT with Copilot Requests using COPILOT_GITHUB_TOKEN, GH_TOKEN, or GITHUB_TOKEN (precedence in that order).
Verify plan access and org policy
Confirm your user has Copilot entitlements. For Business/Enterprise, ensure an admin enabled Copilot CLI (and GPT-5.6 models if required).
Add project guidance and try a small /plan
Create or update AGENTS.md with build/test commands, open a scratch branch, run a small /plan, and practice approvals before enabling autopilot or /fleet.
Pro Tips
- • If npm has
ignore-scripts=true, usenpm_config_ignore_scripts=false npm install -g @github/copilot. - • Prefer Luna/Terra while learning; Sol burns more AI Credits on long agent loops.
- • Keep Copilot CLI updated so usage and billing displays match current AI Credits terminology.
Configuration Tips
Write a concrete AGENTS.md
Document package manager, test/lint commands, and forbidden paths. Skills and AGENTS.md keep behavior stable across /model switches and delegated runs.
Match models to jobs
Use Luna for quick questions, Terra for everyday agentic coding, Sol for large-codebase reasoning. Watch the usage dashboard, model choice is the main credit lever.
Use plan mode before autopilot
Shift+Tab into plan mode to outline risky migrations; only then Shift+Tab into autopilot once scope is clear.
Lean on GitHub MCP for issue-driven work
Point the agent at issue numbers/labels instead of pasting walls of ticket text. Native MCP reduces context hunting.
Budget AI Credits for agent weeks
Pro's 1,500 credits can vanish under Sol + /fleet. Set additional-usage budgets or upgrade to Pro+/Max before a deadline crunch.
Alternatives to GitHub Copilot CLI
Copilot CLI sits among terminal and editor coding agents. Pick based on model preference, GitHub coupling, and billing home.
Claude Code
Anthropic's agentic coding CLI/IDE tool on Claude models with CLAUDE.md. Stronger if your team standardizes on Anthropic; Copilot CLI wins when GitHub Issues/PRs/MCP and Copilot seats are already the source of truth.
Codex CLI
OpenAI's coding agent lineage (including ChatGPT desktop Codex flows) on GPT-5.6-class models. Prefer Codex if your org is OpenAI-first; prefer Copilot CLI for GitHub-native delegate/MCP loops billed through Copilot.
Cursor
AI-native editor with deep inline UX. Choose Cursor when the editor is the product; choose Copilot CLI when you want terminal/agent workflows that still integrate with VS Code without switching IDEs.
Warp AI
AI assistance built into the Warp terminal. Convenient if you already live in Warp; Copilot CLI is portable across Ghostty/iTerm/Terminal and ties into GitHub Copilot billing.
Amazon Q CLI
Strong AWS-oriented CLI assistance. Prefer Q for cloud ops on AWS; prefer Copilot CLI for GitHub repository agency and PR delegation.
Meta Muse Code
Newer terminal coding agent competitor. Evaluate on your repos; Copilot CLI is the safer choice when GitHub governance and Copilot admin policies must apply automatically.
Pricing
Copilot CLI is included with Copilot Free, Pro ($10/mo, 1,500 AI credits/month), Pro+ ($39/mo, 7,000 credits), Max ($100/mo, 20,000 credits), Business, and Enterprise. Interactions consume AI Credits (1 credit = $0.01) based on model and tokens. Completions are not AI-credit billed on paid plans; CLI agent work is. Overages can use additional-usage budgets or plan upgrades. Business/Enterprise may require admin enablement. GPT-5.6 Sol/Terra/Luna follow published plan availability and admin model policies.
Pros
- ✓True agentic CLI with /plan, /fleet, /delegate, /resume, not just shell one-liners
- ✓GitHub-native MCP for issues/PRs and org policy inheritance
- ✓Included across Copilot Free through Enterprise seating
- ✓Multi-model picker including GPT-5.6 Sol, Terra, Luna plus Anthropic/Google options
- ✓Works in any Mac terminal and can hand off to VS Code
- ✓Approval-gated edits with /diff visibility
Cons
- ✗AI Credits burn quickly on Sol + long /fleet autopilot sessions
- ✗Business/Enterprise admins can disable CLI or models
- ✗Obsolete gh-copilot tutorials still confuse new users
- ✗Requires network access; not an offline assistant
- ✗Heavier product than the old suggest/explain helper, overkill for rare shell lookups
Community & Support
Primary references are GitHub's Copilot CLI feature page, the github/copilot-cli repository, and docs under docs.github.com for install, auth, billing, and models. npm publishes @github/copilot. Deprecation context for the old extension lives in github/gh-copilot. Changelog posts (including the 2026-07-09 GPT-5.6 Sol/Terra/Luna rollout) track model availability. Support follows GitHub Copilot support channels; org users go through their admins for policy. Community discussion spans GitHub Discussions, Reddit, and developer social posts comparing Copilot CLI with Claude Code, Codex, Cursor, and Muse Code.
Frequently Asked Questions about GitHub Copilot CLI
gh copilot suggest and gh copilot explain was deprecated 25 October 2025. The current product is the standalone agentic Copilot CLI (@github/copilot).About the Author
Expert Tips for GitHub Copilot CLI
Teams that bill Copilot CLI as 'command help' under-train users; the 2026 product is an agentic GitHub workflow tool whose ROI shows up in issue-to-PR cycle time, not obscure shell flags.
GPT-5.6 Sol in Copilot CLI can exhaust Pro credit pools quickly when paired with /fleet, Terra/Luna literacy is part of competent Mac terminal craft now.
GitHub-native MCP plus org policy inheritance is the practical moat versus generic terminal agents for companies already standardized on GitHub Enterprise.
Related Technologies & Concepts
Related Topics
Sources & References
Fact-CheckedLast verified: Aug 9, 2026
Key Verified Facts
- Copilot CLI installs via npm (@github/copilot), the gh.io install script, or Homebrew cask copilot-cli, and is included in Copilot Free/Pro/Pro+/Max/Business/Enterprise with usage drawing AI Credits.[cite-1, cite-3, cite-8]
- GPT-5.6 Sol, Terra, and Luna became available in GitHub Copilot, including Copilot CLI, per the 2026-07-09 changelog.[cite-4]
- Copilot Pro is $10/month with 1,500 monthly AI credits; Pro+ $39 with 7,000; Max $100 with 20,000.[cite-6]
- The legacy github/gh-copilot extension (suggest/explain) was deprecated; users should migrate to the standalone Copilot CLI and can remove the extension with gh extension remove github/gh-copilot.[cite-7, cite-1]
- Copilot CLI supports /plan, /fleet parallel subagents, /model switching, /delegate PR workflows, /resume, skills/AGENTS.md, and GitHub-native MCP.[cite-1, cite-2]
- 1GitHub Copilot CLI
Accessed Aug 9, 2026
- 2github/copilot-cli repository
Accessed Aug 9, 2026
- 3Installing GitHub Copilot CLI
Accessed Aug 9, 2026
- 4GPT-5.6 Sol, Terra, and Luna available in GitHub Copilot
Accessed Aug 9, 2026
- 5Models and pricing for GitHub Copilot
Accessed Aug 9, 2026
- 6Usage-based billing for individuals
Accessed Aug 9, 2026
- 7github/gh-copilot (deprecated extension)
Accessed Aug 9, 2026
- 8npm package @github/copilot
Accessed Aug 9, 2026
Research queries: GitHub Copilot CLI agentic install @github/copilot 2026; gh-copilot deprecated October 2025; GPT-5.6 Sol Terra Luna Copilot CLI; Copilot Pro AI credits 1500 billing