glowed - navegador/editor de Markdown no terminal para Ghostty

glowed é uma ferramenta TUI para buscar, visualizar e editar documentos Markdown dentro de projetos no terminal Ghostty.

Pessoalmente, eu precisava de um fluxo para navegar rapidamente por arquivos .md dentro de um sistema de gestão de conhecimento no terminal e enviar as partes necessárias para uma LLM CLI, então acabei criando isso. Em especial, eu queria poder deixar só o terminal aberto e navegar e visualizar documentos rapidamente, então fiz isso em cerca de dois dias de vibe coding.

A instalação pode ser feita via Homebrew tap.

brew install khw1031/tap/glowed  

Exemplos de uso:

 cd my-project  
 glowed  
  
 # ou abrir um arquivo específico diretamente  
 glowed ./docs/note.md  

Atualmente, os recursos suportados são os seguintes.

• varredura de arquivos .md abaixo do project root
• busca por nome de arquivo, frontmatter, tag: / tags:
• preview de Markdown com base em Glamour
• modo de edição de Markdown bruto
• backup + atomic write ao salvar
• undo/redo
• seleção baseada em clique/rolagem/arraste do mouse
• no modo source selection, copia o Markdown original junto com os metadados de path
• barra de ações no rodapé
• keymap configurável
• launcher de sessão CLI de LLM externo
  • é possível configurar CLIs executáveis via PATH, como claude, codex, aider ou scripts wrapper próprios

Na parte de LLM, o glowed não lida diretamente com API key nem OAuth; ele abre a CLI na qual o usuário já está logado em um novo split/session do Ghostty.

As limitações atuais também são claras. (Foi feito com vibe coding para uso pessoal, ajustado ao meu ambiente...)

• Foi feito tendo macOS + Ghostty como referência.
• Ainda não foi suficientemente testado em iTerm2, Terminal.app, WezTerm, Kitty, tmux, SSH, Linux terminal etc.
• mouse tracking, drag selection, cursor/key sequence e a execução de split no Ghostty podem ser bastante afetados pelo ambiente.
• O texto renderizado selecionado na tela de preview ainda não é remapeado com precisão para line/column do Markdown original. Para copiar o Markdown original, é preciso usar o edit mode ou o source selection mode.
• Como ainda é um MVP inicial, recomenda-se usar documentos importantes junto com version control como git.

O processo de desenvolvimento também foi documentado no README. A implementação atual foi feita com Codex GPT-5.5, pi agent coding harness e um arquivo local de planejamento TODO.md.

Este projeto também está experimentando uma nova forma de gestão de open source para a era da IA.

Em vez de reunir todas as melhorias em PRs para o upstream, a recomendação inicial é que cada usuário modifique livremente a ferramenta de acordo com seu próprio workflow e a distribua no seu próprio Homebrew tap.

Por exemplo, mesmo com o mesmo nome de fórmula glowed, é possível distribuir cada uma separadamente se o namespace do Homebrew tap for diferente.

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

Ou seja, o usuário pode criar sua própria versão, como someone/tap/glowed, e usá-la e distribuí-la livremente. Se necessário, também pode manter o nome do binário como glowed ou alterá-lo para algo como glowed-someone para coexistir com várias versões.

Se você publicar uma versão modificada, seria ótimo informar isso em Distribution registration na issue do GitHub. Não é um pedido de aprovação, mas apenas uma forma de compartilhar quais versões existem. Se a modificação tiver sido feita com AI agent ou coding harness, também é recomendado informar quais agent/model/method foram usados. Posso analisar e, se achar necessário, refletir ideias ou mudanças diretamente neste repositório. Por isso, a redistribuição deve ser feita sob uma LICENSE que permita uso livre.

---

P.S.

Além disso, atualmente estou em busca de novas oportunidades. Tenho trabalhado como desenvolvedor FE e tenho grande interesse em AI Transformation com uso de agentes, além de melhorias de workflow tanto para desenvolvimento quanto para áreas não técnicas. Também tenho experiência em montar workflows internos baseados em agentes dentro de empresas para aumentar a eficiência do trabalho. Se houver alguma oportunidade relacionada, fique à vontade para entrar em contato pelo perfil do GitHub :)