glowed - navegador/editor de Markdown en terminal para Ghostty

glowed es una herramienta TUI para buscar, previsualizar y editar documentos Markdown dentro de un proyecto en la terminal Ghostty.

Personalmente, la hice porque necesitaba un flujo para explorar rápidamente archivos .md dentro de un sistema de gestión de conocimiento desde la terminal y pasar las partes necesarias a un LLM CLI. Sobre todo, la creé dedicándole unos dos días de vibe coding por las ganas de dejar abierta solo la terminal y poder recorrer y revisar documentos con rapidez.

La instalación se puede hacer con un tap de Homebrew.

brew install khw1031/tap/glowed  

Los ejemplos de uso son los siguientes.

 cd my-project  
 glowed  
  
 # o abrir directamente un archivo específico  
 glowed ./docs/note.md  

Actualmente, estas son las funciones compatibles.

• escaneo de archivos .md bajo el project root
• búsqueda por nombre de archivo, frontmatter, tag: / tags:
• previsualización de Markdown basada en Glamour
• modo de edición de Markdown sin procesar
• backup + atomic write al guardar
• undo/redo
• selección basada en click/rueda/arrastre del mouse
• en source selection mode, copia el Markdown original junto con path metadata
• footer action bar
• keymap configurable
• lanzador de sesiones de LLM CLI externas
  • se puede configurar cualquier CLI ejecutable desde PATH, como claude, codex, aider o un wrapper script hecho por ti

En la parte de LLM, glowed no maneja directamente API keys ni OAuth; en su lugar, abre el CLI donde el usuario ya inició sesión en un nuevo split/session de Ghostty.

Las limitaciones actuales también son claras. (Se hizo con vibe coding para uso personal y ajustado a mi entorno personal...)

• Está hecho con macOS + Ghostty como referencia.
• Aún no se ha probado lo suficiente en iTerm2, Terminal.app, WezTerm, Kitty, tmux, SSH, terminales Linux, etc.
• El mouse tracking, la selección por arrastre, las secuencias de cursor/teclas y la ejecución de splits de Ghostty pueden verse muy afectados por el entorno.
• En la pantalla de preview, el texto renderizado seleccionado no se remapea con precisión a la línea/columna del Markdown original. Para copiar el Markdown original hay que usar edit mode o source selection mode.
• Como sigue siendo un MVP inicial, se recomienda usar documentos importantes junto con version control como git.

También dejé escrito el proceso de desarrollo en el README. La implementación actual se hizo usando Codex GPT-5.5, pi agent coding harness y un archivo local de planificación TODO.md.

En este proyecto también estoy experimentando con una nueva forma de gestión de open source acorde a la era de la IA.

En lugar de reunir todas las mejoras en PRs al upstream como se hacía tradicionalmente, por ahora recomiendo priorizar que cada usuario lo modifique libremente según su workflow y lo distribuya en su propio tap de Homebrew.

Por ejemplo, incluso con el mismo nombre de fórmula glowed, si el namespace del tap de Homebrew es distinto, se puede distribuir cada uno por separado.

  brew install khw1031/tap/glowed  
  brew install someone/tap/glowed  

Es decir, el usuario puede crear, usar y distribuir libremente su propia versión, como someone/tap/glowed. Si hace falta, también puede mantener el nombre del binario como glowed o cambiarlo a algo como glowed-someone para que conviva con varias versiones.

Si publican una versión modificada, me gustaría que lo avisaran en el GitHub issue de Distribution registration. No es una solicitud de aprobación, sino una forma de compartir qué versiones existen. Si se modificó con un agente de IA o un coding harness, también se recomienda indicar qué agent/model/method se usó. Yo lo revisaré y, si considero que alguna idea o cambio es necesario, podría incorporarlo directamente en este repositorio. Por eso, la redistribución debe hacerse con una LICENSE que permita uso libre.

---

P.S.

Además, actualmente estoy buscando nuevas oportunidades. He trabajado como desarrollador FE y me interesa mucho la AI Transformation con agentes, así como la mejora de workflows de desarrollo y no desarrollo. También tengo experiencia armando workflows internos basados en agentes dentro de empresas para mejorar la eficiencia del trabajo. Si hay alguna oportunidad relacionada, no duden en contactarme a través de mi perfil de GitHub :)