# Agente no terminal

> Um agente que lê, busca e edita arquivos do seu projeto e roda comandos na sua máquina, com a sua aprovação.


Estes comandos precisam do CLI instalado e conectado à sua conta. Veja [Instalar o CLI](/pt-br/cli/install).

Rode `notholy` dentro de um projeto. O agente pode usar estas ferramentas na sua máquina:

| Ferramenta | Faz |
|---|---|
| `read`, `grep`, `glob` | Lê e busca arquivos |
| `edit`, `write` | Altera arquivos |
| `bash` | Roda um comando |
| `cve_lookup`, `cve_search`, `web_search`, `read_url` | Ferramentas remotas de pesquisa |

## Modos

| Modo | Comportamento |
|---|---|
| `plan` | Só leitura |
| `ask` | Padrão. Pergunta antes de cada escrita e de cada comando |
| `auto-edit` | Edita sem perguntar. Os comandos continuam pedindo aprovação |
| `yolo` | Nunca pergunta. Exige `--yolo` em toda execução |

Os comandos rodam na sua máquina, sob a sua autorização. Os servidores da NotHoly nunca rodam nada contra os seus alvos.

Coloque as instruções do projeto em `NOTHOLY.md`, na raiz. O conteúdo dos arquivos e a saída dos comandos são tratados como dado, nunca como instrução para o agente.

Slash commands: `/model`, `/effort`, `/cost`, `/compact`, `/mcp`, `/resume`. As sessões ficam salvas em `~/.notholy/sessions` com permissão `600`.

```bash
notholy --mode plan -p "map the auth flow in this repo"
```

## Próximos passos

- [Connect e run](/pt-br/cli/connect-and-run)