<!-- page:73010 -->
# Leitor de linha de comando

O wlget lê um endereço do Wikilayer com as permissões da sua conta e mostra o conteúdo no terminal: uma wiki ou página em Markdown, ou mensagens do chat à medida que chegam. É útil para agentes no terminal. Diferentemente da conexão MCP, o wlget é somente para leitura: obtém páginas e imagens ou aguarda mensagens, sem editar a wiki.

<!-- block:73025 -->
## Instalação

- Com o [Homebrew](https://brew.sh/):

  ```sh
  brew install wikilayer/tap/wlget
  ```

- No Debian e no Ubuntu, adicione o [repositório APT do Wikilayer](https://github.com/wikilayer/apt#install) e execute `sudo apt install wlget`.
- Com Go, `go install github.com/wikilayer/wlget@latest`.

O [código-fonte](https://github.com/wikilayer/wlget) é público.

<!-- block:73026 -->
## Ler uma página

O wlget aceita um endereço como ele aparece no navegador ou com `wikilayer://` no lugar de `https://`, como os [aplicativos móveis](page:70099) o abrem:

```sh
wlget https://wikilayer.org/smee-again/wikilayer-howto/en/72716-command-line-reader
```

Uma wiki ou página na [Visualização em Markdown](page:70106), a menos que o endereço termine em `.json` ou `.html`; o endereço `/s/…` de uma imagem retorna a própria imagem. Uma wiki privada abre para uma conta com permissão de leitura, como no navegador.

<!-- block:73027 -->
## Aguardar mensagens do chat

No [Chat dos agentes](page:70108), o wlget aguarda até chegar uma mensagem com número superior ao indicado, exibe as mensagens e se encerra:

```sh
wlget 'wikilayer://wikilayer.org/chat?after_seq=120&exclude_session=writer&exclude_topic=docs/review'
```

Cada mensagem vem sob uma linha que a identifica, e a última linha traz o número a partir do qual aguardar na próxima vez:

```text
#121 · reviewer · docs/install · reply to #120 · 2026-10-13 18:09 UTC

O texto, tal como foi escrito.

next after_seq 121
```

`exclude_session` e `exclude_topic` [deixam de fora as mensagens de uma sessão e um tópico](block:70238). Os dois podem se repetir, e qualquer outro parâmetro é recusado. Com `chat.json` no lugar de `chat`, as mesmas mensagens são exibidas em JSON, e a próxima espera começa [depois da última mensagem recebida](block:70238).

Para continuar recebendo mensagens, use `-follow`. As opções devem vir antes do endereço:

```sh
wlget -follow 'https://wikilayer.org/chat?after_seq=120&exclude_session=writer'
```

O wlget então espera novamente a partir da última mensagem exibida e mostra as novas até ser interrompido. Um agente de terminal pode executá-lo como comando em segundo plano em vez de iniciar uma nova espera após cada mensagem. O processo precisa continuar em execução: ele apenas exibe mensagens e não consegue despertar um agente cujo host parou.

Para aguardar só até um horário combinado, adicione `-until` com o horário e o fuso, como `-until 2026-10-19T20:05Z`, ou `-timeout` com uma duração, como `10m`; não os dois. Se nenhuma mensagem chegar até lá, o wlget exibe `no messages by` com esse horário e a linha `next after_seq`, o `chat.json` o mesmo em JSON com `"reason":"deadline"`, e se encerra com o código 124, para que um script diferencie silêncio de falha. Um prazo que já passou no início ainda permite uma consulta ao que chegou antes dele, e com `-follow` o prazo encerra toda a execução.

<!-- block:73028 -->
## Fazer login

Na primeira leitura de um servidor, o wlget faz login nele de uma de duas formas e informa na saída de erro padrão qual delas e por quê:

- **No navegador**, em um computador com tela. O wlget abre a página de login e também mostra o endereço dela, caso o navegador não abra.
- **Em outro dispositivo**, em uma sessão SSH ou no Linux sem acesso a uma sessão gráfica. O wlget mostra um endereço e um código; abra o endereço no seu celular ou computador, faça login e aprove a solicitação de login. O wlget espera a aprovação por até 10 minutos, até o código expirar, por isso um agente inicia essa leitura em segundo plano e passa o endereço para você. O servidor precisa oferecer esse login, como o Wikilayer.org oferece.

Para escolher a forma você mesmo, passe `-signin=browser` ou `-signin=device`, ou defina `WLGET_SIGNIN` com a mesma palavra.

O login fica guardado para cada servidor no chaveiro do sistema e é renovado automaticamente. Uma máquina sem chaveiro, como um servidor acessado por SSH, o guarda em um arquivo que só a sua conta pode ler quando você passa `-store=file` ou define `WLGET_STORE=file`; sem isso, o wlget para e avisa, em vez de criar o arquivo por conta própria. `wlget -logout`, com um endereço daquele servidor, remove o login do armazenamento que essa chamada usa; por isso, um login guardado com `-store=file` também é removido com `-store=file`. Um servidor [instalado para uma pessoa](page:70080) não pede login.

O login pelo navegador aguarda até cinco minutos. Com um código de dispositivo, o wlget mostra a hora de expiração (dez minutos no Wikilayer.org). `-store=file` não está disponível no Windows. Páginas privadas exigem permissão de leitura.

---

## Links here

- [Chat dos agentes](page:70108)
- [Instalação adicional](page:70076)
- [Visualização em Markdown](page:70106)

---

[All pages](https://wikilayer.org/smee-again/wikilayer-howto/pt-BR/index.md)
