github / github/copilot-cli

Support configurable user-level discovery paths for agents, skills, hooks, and instructions

Offen
#4,622 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

area:agents area:configuration area:plugins
Vorherrschende Sprache
Shell
Sterne
11.2k
Forks
1.9k
Ø Merge
14 Std. 16 Min.
Gemergte PRs (30 T.)
6

Beschreibung

Copilot CLI currently discovers shared user-level artifacts from fixed locations such as:

%USERPROFILE%\.agents

This is useful as a cross-tool default, but there is no supported way to relocate that discovery root for managed or XDG-style profile layouts.

COPILOT_CUSTOM_INSTRUCTIONS_DIRS only adds instruction directories. It does not provide equivalent discovery overrides for:

  • Agents
  • Skills
  • Hooks
  • Shared manifests or related metadata

COPILOT_HOME is not an appropriate substitute because it relocates broader Copilot application state, including sessions, databases, packages, caches, and lock files.

Requested behavior

Provide one or more documented environment variables or configuration settings for additional user-level discovery roots.

For example:

COPILOT_AGENT_DIRS
COPILOT_SKILL_DIRS
COPILOT_HOOK_DIRS
COPILOT_CUSTOM_INSTRUCTIONS_DIRS

Alternatively, support a unified root:

COPILOT_USER_CONFIG_DIR=C:\Users\<user>\.config\agents

with documented subdirectories:

agents\
skills\
hooks\
instructions\

Compatibility

The existing %USERPROFILE%\.agents location should remain a default discovery path. Configured paths should augment or override it through clearly documented precedence rules.

This would preserve the .agents interoperability convention while allowing:

  • Enterprise-managed profile layouts
  • XDG-style configuration separation
  • Portable development environments
  • Machines where the profile root should remain free of tool-owned directories

Related issues

This request is complementary to #4204: that issue proposes broader .agents discovery, while this issue requests a supported way to configure where that user-level discovery tree lives.

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Keine Quelldatei oder kein Test ist angegeben. Beginne damit, die bestehende benutzerweite Erkennung für %USERPROFILE%.agents und COPILOT_CUSTOM_INSTRUCTIONS_DIRS zu finden, und bestimme anschließend, wie konfigurierbare Stammverzeichnisse und die Priorität dargestellt werden sollen. Als erledigt gilt die Aufgabe, wenn dokumentierte Einstellungen die angeforderten Artefakttypen unterstützen und gleichzeitig der bestehende Standardpfad erhalten bleibt.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
shell
Bereich
cli
Issue-Typ
Feature
Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Aktivitätsstatus
Aktiv
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
45/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.