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

# Computadores e terminais

> Máquinas na nuvem, seu dispositivo local e sessões de terminal compartilhadas.

Um computador é uma máquina que executa seu código. Um espaço pode ter uma máquina na nuvem (criada sob demanda, uma por espaço), um navegador na nuvem e seu próprio dispositivo quando o app Kazzle está instalado. A IA os usa para comandos shell, operações de arquivo, sessões de terminal e automação de navegador.

## Tipos de computador

| Tipo               | Capacidades                                  | Use para                                                                                       |
| ------------------ | -------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Máquina na nuvem   | Shell, terminal, arquivos                    | Codificação, scripts, builds, desenvolvimento de app. Arquivos persistem após parar e acordar. |
| Navegador na nuvem | Navegador                                    | Scraping, automação, navegação sem login                                                       |
| Seu dispositivo    | Desktop, terminal, navegador (quando online) | Seu computador executando Kazzle. Navegador integrado mais suporte a extensão.                 |
| Produção           | Iniciar, parar e logs apenas                 | Seu app implantado. Sem acesso a shell, arquivos ou navegador.                                 |

## Persistência da máquina na nuvem

Os arquivos da máquina na nuvem persistem em ciclos normais de parada e acordar. Arquivos, pacotes instalados e ferramentas permanecem intactos. Uma máquina na nuvem é um ambiente de desenvolvimento persistente, não um container descartável.

## Ciclo de vida

1. **Verificar computadores existentes.** A IA vê computadores disponíveis antecipadamente.
2. **Criar se necessário.** A IA cria uma máquina na nuvem ou navegador na nuvem sob demanda.
3. **Acordar se offline.** Máquinas na nuvem podem ser acordadas e paradas; navegadores na nuvem e seu dispositivo são iniciados de forma diferente.
4. **Pronto.** Uma vez acordado, todas as ferramentas estão disponíveis.

## Comandos shell

A IA executa comandos shell para builds, instalações, operações git e scripts. Os comandos são executados no sistema de arquivos persistente da máquina na nuvem.

Regras:

* A IA prefere a ferramenta de banco de dados em relação aos clientes de banco de dados shell.
* Operações de arquivo de app e repo são limitadas ao seu espaço de trabalho.
* Padrões destrutivos são detectados por [políticas de ferramentas](/security/tool-policies).

## Terminais

Terminais são sessões shell persistentes compartilhadas entre você e a IA. A IA os cria para processos de longa duração (servidores de desenvolvimento, builds, watchers). Você também pode abri-los manualmente.

Ambos os lados veem o mesmo terminal em tempo real:

* A IA executa `npm install`. Você vê a saída.
* Você digita um comando. A IA pode ler a saída.
* A IA inicia um servidor de desenvolvimento. Você pode interagir com ele.

Quando a IA inicia um app, o servidor de desenvolvimento é executado em um terminal. Você pode ler sua saída para verificar erros, e a IA o monitora para detectar falhas de build.

## Sistema de arquivos

Para arquivos de app e repo, a IA usa operações de arquivo com escopo que não podem escapar da raiz do espaço de trabalho. Para acesso bruto ao sistema de arquivos, ela usa comandos shell.