Copilot Memory lets Copilot learn about your codebase and your personal preferences, helping Copilot agents work more effectively. For more information, see About GitHub Copilot Memory.
Your personal setting controls whether Copilot can store and use user-level preferences in your sessions. Repository-level facts have separate controls.
On Copilot Business and Copilot Enterprise plans, an administrator must allow user-level preferences before you can use them. Enabling the policy does not undo a choice you previously made to disable user-level preferences. For more information, see Managing Copilot Memory for an enterprise, organization, or repository.
Settings in individual applications can further restrict Copilot Memory, but cannot override your GitHub settings or policies.
This article covers reviewing and deleting the memories that Copilot has already stored. For guidance on getting a specific fact or preference remembered in the first place, see Manually creating memories for GitHub Copilot.
Disabling or enabling Copilot Memory
The Copilot Memory setting in your personal account controls user-level preferences in your own Copilot sessions. It does not control repository-level facts or change other users' sessions.
The dropdown shows your saved setting. Enterprise or organization policies can still prevent you from using user-level preferences. For repository-level controls, see Managing Copilot Memory for an enterprise, organization, or repository.
- In the upper-right corner of any page on GitHub, click your profile picture, then click Copilot settings.
- Under "Features", scroll down to the setting for Copilot Memory.
- Click the dropdown button and choose whether to enable or disable user-level preferences.
Disabling user-level preferences does not disable repository-level facts or delete stored memories. If you want to delete your user-level preferences, review and delete them before turning them off.
Copilot Memory in GitHub Copilot CLI
In interactive sessions, the CLI's local Copilot Memory setting is on by default, so it follows your GitHub settings and policies. Use /memory off to disable both types of memory in the CLI, or /memory on to remove that local opt-out. The choice takes effect in the current session and is saved for future interactive sessions on that machine. Changing your personal setting on GitHub.com does not clear a CLI opt-out. You can also disable Copilot Memory in your Copilot CLI user settings with "memory": false. The CLI setting cannot override applicable enterprise, organization, or repository restrictions.
To check the CLI setting, enter /memory or /memory show. The command displays the client setting and a link to manage your stored memories on GitHub. An enabled status does not mean that your account or repository policies allow both types of memory.
In non-interactive runs, such as copilot -p "YOUR PROMPT", Copilot Memory is disabled by default, even if it is enabled for interactive sessions. Add --enable-memory to enable it for that run. This option takes precedence over a saved "memory": false setting, but account, repository, and tool-permission restrictions still apply. It does not change your saved setting.
Note
Turning off Copilot Memory in the CLI stops further storage and retrieval, but memories already supplied to an existing conversation can remain in its context. To continue without that earlier context, turn memory off and start a new session.
Copilot Memory in Visual Studio Code
For Copilot sessions that run in its Local Agent Host, Visual Studio Code has its own Copilot Memory setting. It is off by default, even when your GitHub settings allow memory. These sessions can use repository-level facts and user-level preferences when the applicable settings allow them.
- Open Settings in Visual Studio Code.
- Search for
chat.copilot.memory.enabled. - Select the checkbox to enable Copilot Memory, or clear it to disable the feature in Visual Studio Code.
Enabling this setting does not override your GitHub settings or policies. On Copilot Business and Copilot Enterprise plans, an organization owner or enterprise owner must also allow user-level preferences. Repository-level facts follow the separate repository access controls.
This setting does not affect VS Code's memory tool for local memory files. See Use memory with agents in VS Code in the VS Code documentation.
Copilot Memory in the GitHub Copilot app
Copilot Memory must be available for your account in the app. The app does not provide a separate toggle to make it available or a screen for managing these shared memories.
Where are the settings for Copilot Memory:
- User-level preferences — as an individual users, you can enable or disable Copilot Memory in your personal settings on GitHub.com. See Disabling or enabling Copilot memory. On Copilot Business and Copilot Enterprise plans, an organization owner or enterprise owner must first allow you to enable Copilot Memory. See Managing Copilot Memory for an enterprise, organization, or repository.
- Repository-level facts — the repository's settings and applicable repository access policies must allow these. If access is blocked by a policy, ask the relevant administrator to check the repository controls.
The Memory setting in a project's settings controls a separate set of preferences that the project remembers across tasks. You can edit those preferences there, but this does not change your shared Copilot Memory facts or preferences. Use the personal or repository settings on GitHub.com to view and delete those.
Selecting a default billing entity
If you receive Copilot access through multiple enterprises or organizations, you must select a default billing entity in order to create new repository-level facts or user-level preferences with Copilot Memory. The billing entity determines which account "owns" (can manage and delete) user-level preferences that are generated for your account. Do this in your account settings.
Until you select a default, Copilot cannot create new memories for you, and will tell you to choose one.
The owner of a user-level preference is set when the preference is created by Copilot Memory and it does not change afterwards. If you later move to a different license, the preferences you have already generated stay with the organization or enterprise that owned them, and Copilot will no longer retrieve them for you. Existing repository-level facts remain associated with their repository and are not restricted to your active billing entity.
Viewing and deleting your user-level preferences
Copilot Memory stores preferences for your personal use of Copilot.
- In the upper-right corner of any page on GitHub, click your profile picture, then click Copilot settings.
- In the sidebar, under Copilot, click Memory.
- To delete a memory, click next to it. To delete several memories at once, select their checkboxes, then click Delete.
Memories are ranked by usefulness. Memories that Copilot has learned not to use are hidden from the list, but can remain stored until they expire.
Note
If you have write access to a repository and user-level preferences enabled for your account, you can also view and delete repository-level facts in the repository's settings. See Managing Copilot Memory for an enterprise, organization, or repository.
Enabling Copilot Dreaming for your personal account
Copilot Dreaming for personal memories, and for your personally owned repositories, is disabled by default. You can enable Copilot Dreaming in your personal Copilot settings.
If you get access to Copilot through an organization or enterprise, your ability to enable Copilot Dreaming may be limited by policies set by the organization or enterprise. For more information, see About GitHub Copilot Dreaming.
Note
Copilot Dreaming is in public preview and is subject to change.
Enabling Copilot Dreaming for your personal memories
- In the upper-right corner of GitHub.com, click your profile picture, then click Settings.
- In the sidebar, under "Code, planning, and automation", click Copilot then click Features.
- Under Features, locate Copilot Memory.
- Make sure Copilot Memory is enabled. If Copilot Memory is disabled, the personal Copilot Dreaming setting is hidden.
- In the Dreaming dropdown, select Enabled.
This setting controls Copilot Dreaming for your personal memories only. It does not enable Copilot Dreaming for repositories you own. If an organization or enterprise provides your Copilot access, you can select Disabled to opt out when Copilot Dreaming is permitted. You cannot override a policy that disables Dreaming in any organization or enterprise that provides you with Copilot access, even if you also have an individual subscription.
To review the results, see Managing Copilot Memory for an enterprise, organization, or repository.
Enabling Copilot Dreaming for a personally owned repository
These steps apply if you have an eligible individual Copilot subscription and do not receive Copilot access from an organization or enterprise. You must have administrator access to the repository. You cannot enable Copilot Dreaming for an archived repository.
Organization and enterprise policies control Copilot Dreaming for organization-owned repositories. See Managing Copilot Memory for an enterprise, organization, or repository.
-
On GitHub.com, open the personally owned repository where you want to enable Copilot Dreaming.
-
Under the repository name, click Settings.
-
In the sidebar, under "Code, planning, and automation", click Copilot, then Memory.
Make sure Allow Copilot to store and retrieve repository facts is enabled.
-
In the sidebar, click Dreaming.
-
Enable Dreaming.
-
Repeat for each of your personally owned repositories where you want to enable Copilot Dreaming.