Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

TUI attention docs are missing details & are wrong placed

Abierto Apto para principiantes
  • ¿Algo no está bien?
#50,902 1 comentario 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

@andreivince ya está trabajando en esto.

Desde el 2/10/2026.

  • #52799 de @andreivince — abierto

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
75/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
json, typescript
Área
cli, documentation

Línea de trabajo

El issue apunta a la página de documentación en https://opencode.ai/v2/docs/cli/config#alerts y los enlaces del esquema. Examina el código fuente de la documentación del repositorio, probablemente en un directorio docs/, para encontrar la referencia incorrecta al archivo de configuración. También revisa el esquema de configuración de TUI en https://opencode.ai/tui.json y el código en packages/tui/src/attention.ts para comprender los tipos de archivos de sonido permitidos. La solución implica actualizar la documentación para hacer referencia a tui.json en lugar de cli.json y agregar detalles sobre los formatos de audio compatibles.

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

Descripción

Description

So the current docs (https://opencode.ai/v2/docs/cli/config#alerts) for alerts are showing wrong information because those never worked for me in a ~/.config/opencode/cli.json file (schema link).

It took me a few hours and help from frontier AI models to find out that there exists another config tui.json. I couldn't find any docs online about it except the schema link and this little section here without much further explanation there.

Proposed change

I would at least change the code snippets header label from cli.json to tui.json or create a whole subpage for TUI and move this there. There is also no information about the allowed file types (e.g. mp3, wav, etc.). I had to reverse engineer the code to find out that the default files are also mp3, see imports https://github.com/anomalyco/opencode/blob/dev/packages/tui/src/attention.ts#L17

Plugins

0

OpenCode version

1.18.32

Steps to reproduce

Prerequisite is that no ~/.config/opencode/tui.json exists or at least no attention object in the JSON file.

Procedure:

  1. Create ~/.config/opencode/cli.json file
  2. Paste the following from https://opencode.ai/v2/docs/cli/config#alerts: 
    {
  "$schema": "https://opencode.ai/v2/cli.json",
  "attention": {
    "notifications": true,
    "sound": true,
    "volume": 0.4,
    "sound_pack": "opencode.default",
    "sounds": {
      "permission": "/home/me/sounds/permission.wav"
    }
  }
}
  3. Restart openclaude via shell opencode
  4. Send any prompt
  5. No sound is played at all
Screenshot and/or share link

No response

Operating System

Linux RHEL 10.2

Terminal

Intellij Terminal & RHEL default terminal named "Konsole"

Lenguaje dominante
TypeScript
Estrellas
213k
Forks
28.4k
Merge medio
8 h 32 min
PR fusionados (30 d)
253

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 anomalyco/opencode

Todos los issues de anomalyco/opencode

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.