Custom agents not appearing in dropdown unless agent files are open in editor
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 38/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Stale
- Tech stack
- swift
- Domain
- desktop-dev, tooling
Research direction
Reproduce the issue with a valid .github/agents/my-custom-agent.agent.md file, then compare the agent dropdown before and after opening the file in Xcode. Trace how custom agents are discovered and loaded when Copilot Chat opens, and consider the reported expected behavior complete when agents remain available after the file is closed.
Written by the indexing model from the issue text.
Description
Description
Custom agents defined in .github/agents/ are not appearing in the Copilot chat agent dropdown in Xcode unless the agent file itself is currently open in a window/editor tab.
Expected Behavior
Custom agents should be automatically discovered and loaded from the .github/agents/ directory when:
Opening Xcode with a project
Opening Copilot Chat
Creating a new custom agent file
This is how custom agents work in VS Code - they appear in the dropdown automatically without requiring the files to be open.
Actual Behavior
Custom agents only appear in the Copilot chat dropdown when their corresponding .agent.md files are open in the Xcode editor. Once the file is closed, the agent disappears from the dropdown.
Steps to Reproduce
Create a custom agent file in .github/agents/ (e.g., my-custom-agent.agent.md)
Add valid YAML frontmatter and agent content:
---
name: my-custom-agent
description: Test custom agent
---
You are a helpful assistant.
Save the file and close it
Open Copilot Chat in Xcode
Click the agent dropdown at the bottom of the chat view
Result: The custom agent does NOT appear in the list
Now open the my-custom-agent.agent.md file in Xcode (in any window/tab)
Check the agent dropdown again
Result: The custom agent NOW appears in the dropdown
Environment
Copilot for Xcode version: [latest as of January 2026] (0.46.159)
Xcode version: 26.2 (17C52)
macOS version: 26.2 (25C56)
GitHub Copilot subscription: [Pro/Business/Enterprise]
Additional Context
The custom agent files are in the correct location (.github/agents/)
Files use the correct .agent.md extension
The .github folder is NOT ignored by .gitignore
The same custom agents work perfectly in VS Code without needing to open the files
No target property is set (or it's set to allow all IDEs)
This behavior is consistent across multiple custom agents
Verification Checklist
I have verified the following:
✅ Agent files are in .github/agents/ directory
✅ Files use .agent.md extension
✅ YAML frontmatter is valid
✅ .github folder is not git-ignored
✅ Latest version of Copilot for Xcode is installed
✅ Same agents work in VS Code
✅ No target: vscode property restricting the agent to VS Code only
Impact
This bug requires developers to keep all custom agent files open in editor tabs to use them, which:
Clutters the workspace
Defeats the purpose of having reusable, discoverable agents
Creates inconsistent behavior compared to VS Code
Makes custom agents essentially unusable in Xcode workflows
Suggested Fix
Copilot for Xcode should implement proper file system watching/indexing to automatically discover and load custom agents from .github/agents/ without requiring the files to be open in the editor, matching the behavior in VS Code and other supported IDEs.
- Dominant language
- Swift
- Stars
- 6.3k
- Forks
- 2k
- Avg merge
- 3d 21h
- Merged PRs (30d)
- 2
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from github/CopilotForXcode
-
Difficulty 1/5 Under an hour Newbie friendliness 85/100
github/CopilotForXcode#181 · 2 reactions ·
-
Add ability to attach Copilot window only to Xcode projects/workspaces, ignoring standalone files Open
Difficulty 3/5 1-2 days Newbie friendliness 68/100
github/CopilotForXcode#945 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 35/100
github/CopilotForXcode#943 ·
-
Difficulty 5/5 Over a week Newbie friendliness 10/100
github/CopilotForXcode#936 · 2 comments ·
-
Difficulty 5/5 Over a week Newbie friendliness 10/100
github/CopilotForXcode#934 ·
All issues in github/CopilotForXcode
Similar issues
-
area:dictation documentation P2
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
uttrflow/uttrflow-swift#1180 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
OneBusAway/onebusaway-ios#1451 ·
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 68/100