> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AppSignal CLI

> Consulte seus dados do AppSignal pelo terminal: acompanhe logs, inspecione incidentes e gerencie triggers sem sair do shell.

A AppSignal CLI traz seus dados de monitoramento para o terminal, para que você possa trabalhar no mesmo shell em que roda seus testes e deploys. Acompanhe logs conforme chegam, pesquise incidentes e os encerre, e gerencie triggers de detecção de anomalias, tudo sem abrir a interface web. É um binário único feito em Rust, então não há nada mais para instalar.

A CLI foi feita para dois tipos de usuários: pessoas e agentes de IA. Por padrão, todo comando imprime saída legível por humanos; passe `--output json` e ela retorna JSON legível por máquina. Em outras palavras, a mesma ferramenta que você usa durante um incidente também pode alimentar dados estruturados para um agente de programação. Ela inclui ainda uma [AppSignal agent skill](/cli/skill): um conjunto de instruções que ensina um agente como Claude ou Codex a usar a CLI. Instale-a com `appsignal-cli skill install`.

<Note>
  A CLI conversa com os mesmos dados do AppSignal que a interface do app e o [AppSignal MCP](/mcp-server). Ela é um portal para dados que o AppSignal já tem. Se seu app não está enviando logs, `logs tail` não vai mostrar nada.
</Note>

## O que você pode fazer

* **Logs:** acompanhe linhas de log conforme chegam, ou pesquise em um intervalo de tempo com a [sintaxe de consulta](/logging/query-syntax) do AppSignal. Filtre por severidade ou origem, aplique log views salvas e liste as views e fontes de um app. Crie e gerencie métricas derivadas de log e triggers baseados em log a partir dos seus dados de log.
* **Incidentes:** liste incidentes de exceção, performance e anomalia, e pesquise os de exceção e performance por nome ou mensagem; abra os detalhes de um incidente; atualize seu estado, severidade ou responsáveis; e adicione notas.
* **Triggers:** liste, crie, atualize e arquive triggers de detecção de anomalias.
* **Dashboards:** liste, crie e atualize os [dashboards](/cli/dashboards) do seu app.
* **Apps:** liste suas aplicações, encontre um app pelo nome e inspecione seus usuários, notifiers, namespaces, dashboards e deploy markers.
* **Configuração de projeto:** crie uma [configuração local do projeto](/cli/configuration) para que comandos executados em um repositório usem por padrão a organização correta.
* **Agent skill:** instale a skill do AppSignal incluída no seu agente de IA, atualize-a e verifique se está atual.

## Flags globais

Estas flags funcionam em todos os comandos:

| Flag                      | Descrição                                                                                             |
| ------------------------- | ----------------------------------------------------------------------------------------------------- |
| `--output <value>` (`-o`) | Renderiza os resultados como `human` (o padrão) ou `json`. `--format` é um sinônimo.                  |
| `--help` (`-h`)           | Mostra uso, subcomandos e opções de qualquer comando (por exemplo, `appsignal-cli logs tail --help`). |

Você pode passar `--output` (ou `--format`) antes ou depois do subcomando. Os resultados do comando vão para a saída padrão no formato escolhido; mensagens de status sempre vão para a saída de erro padrão, então um fluxo `--output json` permanece um JSON válido que você pode encaminhar para outra ferramenta.

## Instalação

A CLI roda em macOS e Linux, tanto em máquinas Intel (`x86_64`) quanto Apple Silicon / ARM (`arm64`). Distribuições Linux baseadas em musl, como Alpine, também são suportadas.

<Tabs>
  <Tab title="Homebrew">
    Instale a fórmula. O Homebrew faz o tap de `appsignal/appsignal-cli` automaticamente:

    ```sh theme={null}
    brew install appsignal/appsignal-cli/appsignal-cli
    ```

    Para atualizar depois, execute:

    ```sh theme={null}
    brew upgrade appsignal-cli
    ```
  </Tab>

  <Tab title="Script de instalação (macOS & Linux)">
    Instale a última release com o one-liner abaixo. Ele precisa de privilégios de super-usuário para instalar o binário no system path, e verifica o download contra o manifesto `SHA256SUMS` publicado antes da instalação:

    ```sh theme={null}
    curl -sSL https://github.com/appsignal/appsignal-cli/releases/latest/download/install.sh | sudo sh
    ```

    Execute o mesmo comando a qualquer momento para atualizar para a última release.
  </Tab>
</Tabs>

<Note>
  Prefere não encaminhar um script para o seu shell? Baixe o binário para sua plataforma diretamente da [última release](https://github.com/appsignal/appsignal-cli/releases/latest/).
</Note>

### Verifique a instalação

Verifique se a CLI está no seu `PATH`:

```sh Shell theme={null}
appsignal-cli --version
```

Em seguida, execute `appsignal-cli about` para uma visão geral da sua configuração, incluindo sua versão, endpoint, organização padrão e status de autenticação:

```sh Shell theme={null}
appsignal-cli about
```

Antes de você autenticar, aparecerá `Auth: Not authenticated` e ele indicará os comandos a executar em seguida.

## Próximos passos

Você instalou a CLI, mas ela não consegue acessar seus dados até que você faça login. Vá para [Autenticação](/cli/authentication) para conectar a CLI à sua conta do AppSignal.