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

# base44 exec

> Executa um script com o SDK da Base44 pré-autenticado como o usuário atual. Lê o script do stdin.

<Warning>
  Esta página faz parte de uma habilidade de agente de código IA e é escrita para agentes, não para humanos. Para a documentação legível por humanos da Base44, veja a [documentação para desenvolvedores](/developers).
</Warning>

# base44 exec

Executa um script com o SDK da Base44 pré-autenticado como o usuário atual. Lê o script do stdin.

## Sintaxe

```bash theme={null}
cat ./script.ts | npx base44 exec
echo "<code>" | npx base44 exec
```

## Como funciona

O comando `exec` lê um script do stdin e o executa no lado do servidor com o SDK da Base44 pré-autenticado como o usuário atualmente logado. Isso permite executar scripts únicos contra os dados do seu aplicativo sem escrever uma função completa.

## Variáveis globais disponíveis

> **`base44`** — um cliente SDK pré-inicializado, disponível como variável global em cada script exec. Você não precisa importá-lo ou configurá-lo — está pronto para usar imediatamente.

Use-o para interagir com os recursos do seu aplicativo:

* `base44.entities.<EntityName>` — operações CRUD em entidades (`.list()`, `.get(id)`, `.create(data)`, `.update(id, data)`, `.delete(id)`)
* `base44.functions.invoke(name, data?)` — chama uma função de backend
* `base44.agents.<AgentName>` — invoca agentes de IA
* Para mais recursos e métodos disponíveis, veja a [referência do SDK da Base44](https://docs.base44.com/developers/skills/base44-cli/references/../../base44-sdk/SKILL.md)

## Exemplos

```bash theme={null}
# Executa um arquivo de script
cat ./script.ts | npx base44 exec

# Script inline
echo "const users = await base44.entities.User.list(); console.log(users)" | npx base44 exec

# Executa contra um aplicativo específico sem um checkout de projeto local
cat ./script.ts | npx base44 exec --app-id app_123

# Ou resolve o aplicativo a partir do ambiente
BASE44_APP_ID=app_123 npx base44 exec < ./script.ts
```

## Requisitos

* Deve estar autenticado (`npx base44 login`)
* Deve ser executado em um destes contextos:
  * de um diretório de projeto Base44 vinculado, ou
  * com `--app-id <id>`, ou
  * com `BASE44_APP_ID` definido
* O script deve ser canalizado via stdin (modo não interativo)

## Notas

* O script é executado com o SDK da Base44 pré-autenticado — você pode usar `base44.entities`, `base44.functions`, etc. diretamente
* `--app-id` é útil quando você quer inspecionar dados do aplicativo sem mudar para um projeto local vinculado
* O código de saída do script é encaminhado como código de saída do processo CLI
* Este comando requer que stdin seja canalizado (não aceita entrada em modo TTY interativo)

<Note>Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>