> For the complete documentation index, see [llms.txt](https://cumbucadev.gitbook.io/github-essentials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cumbucadev.gitbook.io/github-essentials/dia-2/o-comando-git.md).

# O Comando Git

Caso já tenha seguido as instruções da seção [Broken mention](broken://pages/77oRKf3RAJPELx8TimwD), não é necessário instalar e nem configurar mais nada para ter acesso à Git CLI. Apenas abra o terminal e todos os comandos git já estão disponíveis para você.

<figure><img src="/files/Oz9VM84wPacZ7AtjCj0C" alt=""><figcaption></figcaption></figure>

## git

O comando `git` é o ponto de entrada para **todas** as operações do Git. Ele é utilizado para invocar quaisquer outros comandos disponíveis no Git. Para utilizá-lo, basta digitar no terminal de comando `git` seguido pelo nome do comando que deseja executar e quaisquer argumentos necessários.

A estrutura básica para utilizar o comando `git` é a seguinte:

> <mark style="color:purple;">git</mark> <mark style="color:orange;">comando</mark> <mark style="color:blue;">\[opções]</mark> <mark style="color:green;">\[argumentos]</mark>

* <mark style="color:purple;">**git**</mark><mark style="color:purple;">:</mark> A palavra-chave que inicia todos os comandos do Git.
* <mark style="color:orange;">**comando**</mark>: A ação específica que você deseja executar.\
  Por exemplo, para inicializar um novo repositório Git, você digita <mark style="color:purple;">`git`</mark><mark style="color:orange;">`init`</mark>. Isso cria um novo repositório Git vazio.&#x20;
* <mark style="color:blue;">**\[opções]**</mark><mark style="color:blue;">:</mark> São como ajustes extras que você pode usar com um comando.\
  Por exemplo, quando você quer adicionar todas as mudanças feitas nos arquivos ao índice do Git, você usa o comando `git add` com a opção `all`: <mark style="color:purple;">`git`</mark><mark style="color:orange;">`add`</mark><mark style="color:blue;">`--all`</mark>. Isso significa que você está dizendo ao Git para adicionar todas as mudanças, não importa quais arquivos foram modificados.
* <mark style="color:green;">**\[argumentos]**</mark>: São as entradas sobre as quais você quer que o comando aja.\
  Por exemplo, se você quer adicionar um arquivo específico para o próximo commit, você diz ao Git qual arquivo usar como um argumento. Então, o Git sabe exatamente com o que você está lidando: <mark style="color:purple;">`git`</mark><mark style="color:orange;">`add`</mark><mark style="color:green;">`arquivo.txt`</mark>

A partir de agora, vamos adotar a seguinte convenção de cores para facilitar a identificação:

* <mark style="color:purple;">roxo para identificar git</mark>
* <mark style="color:orange;">laranja para identificar o comando</mark>
* <mark style="color:blue;">azul para identificar \[opções]</mark>
* <mark style="color:green;">verda para identificar \[argumentos]</mark>

Os colchetes `[ ]` indicam que tanto opções quanto argumentos são opcionais, ou seja, podem haver casos em que nem um nem outro são necessários. Um exemplo é o <mark style="color:purple;">git</mark> <mark style="color:orange;">init</mark>, que veremos logo em seguida.&#x20;

{% hint style="info" %}
Se você digitar apenas <mark style="color:purple;">`git`</mark> no terminal, será exibida uma lista de comandos comuns do Git, como <mark style="color:orange;">`clone`</mark>, <mark style="color:orange;">`init`</mark>, <mark style="color:orange;">`add`</mark>, entre outros. Não se preocupe se parecer muita informação - você não precisa aprender tudo de uma vez. Esta lista simplesmente mostra quais comandos estão disponíveis e o que eles fazem.
{% endhint %}

Em resumo, toda interação com o Git é feita através do comando <mark style="color:purple;">`git`</mark>. Ele é o seu meio de comunicação com o Git e permite que você execute uma ampla variedade de tarefas de controle de versão em seu projeto.

{% hint style="warning" %}
Esta é uma explicação simplificada para fins didáticos. Para explorar todas as possibilidades do comando <mark style="color:purple;">`git`</mark>, consulte a [documentação oficial](https://git-scm.com/docs/git/pt_BR).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cumbucadev.gitbook.io/github-essentials/dia-2/o-comando-git.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.