---
title: "Visão geral da CLI"
description: "Instale a CLI, entre na conta, vincule uma pasta de projeto a um site e coloque-o no ar."
canonical: "https://atelier201.com/docs/pt/cli/overview"
updated: "2026-11-06"
---

# Visão geral da CLI

```bash
npm install -g @atelier201/cli
atelier201 auth login
atelier201 account
```

`atelier201 auth login` abre um navegador, pergunta a qual workspace você quer se conectar e quais
permissões conceder, e armazena o token no chaveiro do sistema operacional,
não em um arquivo oculto. Em uma máquina sem navegador, use `atelier201 auth login --device`.

## Da pasta de projeto ao site no ar

```bash
atelier201 sites create "Maison Dupont" --link   # cria o site e vincula esta pasta
atelier201 site pull                             # traz os arquivos do site para cá
# ...edit...
atelier201 site push --build --wait              # envia a pasta, compila o site e aguarda
atelier201 previews create                       # cria um link privado para essa compilação
atelier201 publish                               # mostra o que vai ao ar, pede confirmação e publica
```

Todo comando de site aceita `--site <id>` ou usa o site vinculado à pasta atual.
`atelier201 site link --site <id>` grava `.atelier201/site.json`, que não contém nenhum
segredo e é incluído no `.gitignore`.

Para textos, entradas e informações da empresa, prefira os comandos de conteúdo a editar
arquivos: eles validam os dados com base no modelo de conteúdo do site e não podem quebrar o
layout.

```bash
atelier201 content set business:/tagline "Fresh bread daily"
```

Consulte [Comandos](/docs/cli/commands) para ver todos eles e
[Modelo de conteúdo e mídia](/docs/platform/content-model) para saber o que um site contém.

## Saída

**A saída é JSON automaticamente quando stdout não é um terminal.** Basta redirecionar para `jq`,
e nenhum comando precisa da opção `--json` na CI. No terminal, você recebe uma
tabela. Escolha o formato com `--output json|table|ndjson`.

## Códigos de saída

Um script pode tomar decisões sem precisar ler uma mensagem:

| Código | Significado                                                                 |
| ------ | --------------------------------------------------------------------------- |
| 0      | Sucesso                                                                     |
| 1      | Falha inesperada                                                            |
| 2      | Uso incorreto ou solicitação rejeitada pelo servidor como inválida          |
| 3      | Autenticação ou permissão                                                   |
| 4      | Não encontrado                                                              |
| 5      | Limite de requisições atingido                                              |
| 6      | Conflito: conflito de gravação, publicação desatualizada ou limite do plano |