github / github/copilot-cli

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

Abierto
#4,622 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

area:agents area:configuration area:plugins
Lenguaje dominante
Shell
Estrellas
11.2k
Forks
1.9k
Merge medio
14 h 16 min
PR fusionados (30 d)
6

Descripción

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.

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Línea de trabajo

No se especifica ningún archivo fuente ni ninguna prueba. Empieza por localizar el descubrimiento existente a nivel de usuario para %USERPROFILE%.agents y COPILOT_CUSTOM_INSTRUCTIONS_DIRS, y después determina cómo deben representarse las raíces configurables y la precedencia. La tarea se considera terminada cuando la configuración documentada admite los tipos de artefacto solicitados y conserva la ruta predeterminada existente.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
shell
Área
cli
Tipo de issue
Nueva funcionalidad
Dificultad
5/5
Tiempo estimado
Más de una semana
Estado de actividad
Activo
Claridad
Bastante claro
Aptitud para principiantes
45/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.