/codex: the filesystem boundary's bare `agents/` makes Codex skip a repository's own agents/ folder

Abierto Apto para principiantes
  • ¿Algo no está bien?
#3,924 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

@indraoverflow ya está trabajando en esto.

Desde el 5/11/2026.

  • #3995 de @indraoverflow — cerrado sin fusionar
  • #4037 de @indraoverflow — abierto

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
70/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
markdown
Área
devtools

Línea de trabajo

Empieza en codex/SKILL.md, en la sección "Filesystem Boundary", donde el texto del prompt enumera las rutas protegidas e incluye la entrada genérica agents/. Comprueba cómo se inserta ese texto de límite en cada prompt de codex exec. Está terminado cuando la entrada nombra solo las rutas exactas de instalación (~/.claude/skills/, ~/.agents/, .claude/skills/, agents/openai.yaml), o cuando el texto indica que las carpetas propias del repositorio revisado son legibles, y un prompt de prueba con un cambio en agents/ dentro del diff lo confirma.

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

Descripción

bug S3

What happens

The filesystem boundary that /codex puts in front of every codex exec prompt (codex/SKILL.md, "Filesystem Boundary") reads:

IMPORTANT: Do NOT read or execute any files under ~/.claude/, ~/.agents/, .claude/skills/, or agents/. ...

The first three entries are the skill install paths. The last one, agents/, is relative to the repository, so it also matches a repository's own agents/ folder when that folder is reviewed code (for example a repo that keeps agent prompt files in agents/ and tests them).

Seen on v1.91.162.0 (the text is unchanged in v1.91.350.0), Codex consult mode, reviewing a diff that changed agents/planner.md:

  • Codex left the changed agents/planner.md out of its review.
  • It wrapped the repo's documentation test suites in a read guard, and the suites that read agents/ were blocked (4 of 12 in one run; 3 of 3 that read it in a later run whose diff didn't touch agents/ at all).
  • Its verdict was "Can't verify".

It isn't consistent: an earlier run in the same session, with the same boundary, ran all 12 suites. The workaround is one extra sentence in the task text saying the repository's agents/ folder is reviewed code and may be read.

Expected

The boundary keeps Codex out of skill definitions without hiding repository content that happens to share the folder name.

Suggestion

Name the exact install paths the boundary protects (~/.claude/skills/, ~/.agents/, .claude/skills/, and the generated agents/openai.yaml it already names), not a bare agents/. Or add a sentence saying the reviewed repository's own folders are always readable. A test prompt for a repo with an agents/ folder in its diff would pin it.

Lenguaje dominante
TypeScript
Estrellas
139k
Forks
20.6k
Merge medio
10 h 12 min
PR fusionados (30 d)
655

Preparar el entorno

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.

Más de garrytan/gstack

Todos los issues de garrytan/gstack

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.