Evidence record / github-copilot-cli
A dated record of one change, kept so the writing that cites it can be checked. Compiled from the sources listed below by the research run, not written for reading. The judgment lives in the issues that cite it, below.
2026-10-13-github-copilot-cli-custom-agent-docs-put-personal-definitions-ahead-of-repository-and-organization-definition
Custom-agent docs put personal definitions ahead of repository and organization definitions. Personal ~/.copilot/agents definitions win same-ID collisions over repository agents. Deduplication is by ID, not display name. Every project .github/agents directory precedes every project .claude/agents directory; then come added roots, plugins, and remote organization/enterprise agents at lowest priority. Same-name agents with different IDs can both load, and ambiguous selection uses the first match in that order.
Channel: docs-only. Half: both. Date: 2026-09-30.
Operator consequence: Inspect the selected definition when personal, repository or remote agents share an ID or name. Do not assume an organization-provided agent takes precedence locally. Keep managed permission policy distinct from custom-agent definition precedence.
Receipt
Finding metadata
Run: 2026-10-13-profile-refresh-2026-09-21_2026-10-13-frontier-v0
Finding ID: 2026-10-13-github-copilot-cli-custom-agent-docs-put-personal-definitions-ahead-of-repository-and-organization-definition
Profile citations
- github-copilot-cli / claim / custom-agent-precedence
Source links
Primary links, including exact changelog lines when available.
- commit2026-10-13-github-copilot-cli-custom-agent-docs-put-personal-definitions-ahead-of-repository-and-organization-definitiongithub.com/github/docs/commit/cf14212193e2ca638e086760c8f88008b1c60e23tagged commit file2026-10-13-github-copilot-cli-custom-agent-docs-put-personal-definitions-ahead-of-repository-and-organization-definitiongithub/docs / content/copilot/reference/copilot-cli-reference/cli-command-reference.md#L1293-L1311
Versioned source: run artifact