How to clear GitHub Copilot cache on Mac

By AI Agent Clean Team · Published 2026-08-09 · Last updated 2026-09-23 · macOS 14+

GitHub Copilot CLI and IDE extensions have different storage owners. Review disk usage on macOS 14+ while preserving settings, credentials and sessions; the paths below are inspection candidates, not a verified deletion list.

View on the Mac App Store

Copilot data is split across CLI home folders, host-editor data, and IDE globalStorage extension IDs (including legacy Chat/Nightly IDs). Measure folders on your own Mac — sizes vary by workload and host editor.

Consider only individually verified, disposable files. Keep settings, credentials, agents, skills, and session state. This guide does not describe a full reset.

Why Copilot cache grows

  • SDK and CLI caches — downloaded artifacts under ~/Library/Caches.
  • IDE extension caches — cache, logs, and tmp under github.copilot* globalStorage (not the whole extension root).
  • CLI logs — ~/.copilot/logs is an inspection candidate; verify its owner and retain logs needed for troubleshooting. No retention schedule is established here.

GitHub Copilot inspection candidates (macOS)

Evidence limitation: these candidates have not been tested for every CLI or host-editor version. GitHub Desktop is a separate product; its application data must not be included in a Copilot cleanup merely because it is GitHub-branded.

PathTypical contentsSafe to clear?
~/Library/Caches/copilotCLI / runtime cacheVerify owner, version and regenerable purpose first; otherwise keep
~/Library/Caches/github-copilot-sdkSDK downloadsVerify owner, version and regenerable purpose first; otherwise keep
~/.copilot/logs/CLI logsVerify owner, version and regenerable purpose first; otherwise keep
…/globalStorage/github.copilot*/cache|logs|tmpIDE extension regenerable dataVerify owner, version and regenerable purpose first; otherwise keep
~/.copilot/settings.json / config.jsonPreferencesKeep
~/.copilot/session-state/, session-store.dbCLI sessionsKeep (confirm if removing)
~/.copilot/mcp-*, agents/, skills/Auth / MCP / skillsKeep

Quit Copilot and host editors before deleting. Prefer Trash over permanent erase. Layouts can change between Copilot CLI and extension versions.

Step-by-step: manual Copilot cache cleanup

  1. Quit Copilot and host IDEs — the specific editor hosting your Copilot extension. VS Code, JetBrains and Cursor data are not interchangeable.
  2. Open Finder Go to Folder — paste ~/Library/Caches and review copilot / github-copilot-sdk.
  3. Review ~/.copilot/logs — retain logs needed for diagnostics; only review individual closed files with confirmed ownership. Leave settings.json and MCP/session folders alone.
  4. Relaunch the same client — verify sign-in, normal suggestions and existing sessions. If anything is missing, stop and restore the files you moved, preserving any newly created state before restoring.

Find Copilot logs in VS Code before changing files

In VS Code, use View → Output and choose GitHub Copilot. To locate extension logs on disk, open the Command Palette and run Developer: Open Extension Logs Folder. Use the installed editor’s location rather than assuming a CLI folder applies to VS Code.

GitHub’s official log-viewing instructions, reviewed September 23, 2026, describe diagnosis, not approval to delete logs or the surrounding folder. Retain useful diagnostics and inspect logs for sensitive information before sharing them.

FAQ

Is it safe to clear GitHub Copilot cache on Mac?

Only consider files whose regenerable purpose and owner are confirmed. Keep settings, MCP secrets, agents, skills, and session-state. A full reset is outside this guide.

Where is GitHub Copilot cache stored on macOS?

Start with ~/Library/Caches/copilot, github-copilot-sdk, ~/.copilot/logs, and version-specific IDE globalStorage/github.copilot* cache subfolders.

Will clearing Copilot cache delete my chat history?

Deleting the wrong local state can remove history. Keep session directories and databases, preserve a backup, and check every selected item in your installed app version. This guide does not establish that a particular cleanup selection preserves all chat history.

Automated cleanup with AI Agent Clean

As of v1.0.1, the AI Agent Cleaner module groups GitHub Copilot caches, logs, IDE extension caches, and sessions separately — regenerable items are selected by default; sessions need confirmation.

  1. Open AI Agent Clean (or Smart Scan).
  2. Expand the GitHub Copilot group and review sizes.
  3. Leave sessions and protected paths unchecked.
  4. Clean — selected items move to Trash by default.

Scanning stays free; cleanup requires an active plan. Trial eligibility and offers depend on current Mac App Store terms. See pricing.

Safety warnings
  • Do not wipe all of ~/.copilot as “cache”.
  • Keep authentication and secret-bearing folders; signing in again is not a substitute for preserving local configuration and state.
  • Prefer Trash so you can restore if login or CLI state looks wrong.

Related guides and features

Preview Copilot cache sizes locally — no cloud upload.

View on the Mac App Store

View plans on the Mac App Store

Scan free. Check trial eligibility, available offers, and current terms in the Mac App Store.

View on the Mac App Store