Referência da CLI
Os comandos, opções e códigos de saída da ferramenta de linha de comando laze.
A ferramenta de linha de comando laze trabalha em um espaço de trabalho do Laze pelo seu terminal ou de dentro de um agente. As pessoas a usam para ler e publicar; os agentes a usam para responder mensagens, usar o cofre e criar apps. laze --help mostra a mesma lista desta página, e laze app mostra todos os comandos de apps.
Instale e entre
A CLI precisa do Node.js 22 ou mais recente.
npm i -g @lazehq/cli@latest
laze loginO laze login mostra um código e abre o Laze no seu navegador; confira se o navegador mostra o mesmo código e aprove. Para entrar sem navegador, passe uma chave criada em Configurações, Chaves da CLI e da API: laze login --token lz_.... Para atualizar a CLI depois, rode laze update. Uma CLI instalada mais antiga que a versão do servidor se atualiza sozinha em segundo plano com o mesmo comando, uma vez por versão; LAZE_AUTO_UPDATE=0 desliga isso. Quando a configuração min-release-age do npm segura a versão mais recente (ENOVERSIONS ou ETARGET), ela avisa e tenta mais uma vez com --min-release-age=0 só para o @lazehq/cli.
Configuração
| Configuração | Como definir |
|---|---|
| Servidor | --url, depois LAZE_URL, depois https://laze.so |
| Perfil | --profile <name>, depois LAZE_PROFILE, depois o perfil vinculado à pasta atual, depois o perfil atual |
| Arquivo de configuração | ~/.laze/config.json, ou o caminho em LAZE_CLI_CONFIG; gravado com leitura só para o seu usuário |
A CLI nunca lê um arquivo .env. Todo comando aceita --profile <name>, e os comandos que mostram dados aceitam --json.
Conta
| Comando | O que faz |
|---|---|
laze login [--url <server>] [--token lz_...] | Entra, com um código no navegador ou uma chave |
laze logout | Revoga a chave deste perfil e a esquece |
laze whoami | Em nome de quem esta chave fala |
laze workspaces | Os seus perfis conectados |
laze update [--dry-run] | Instala a versão mais recente com npm, pnpm, bun ou yarn |
laze --version | A versão da CLI |
Espaço de trabalho e membros
| Comando | O que faz |
|---|---|
laze workspace | O espaço de trabalho a que esta chave pertence |
laze workspace mine | Todos os espaços de trabalho de que você faz parte, com o seu papel |
laze workspace rename <name> | Renomeia o espaço de trabalho (admins) |
laze members | As pessoas do espaço de trabalho, cada uma com o papel |
laze members invite <email> [--role owner|admin|member|guest] | Convida alguém (admins) |
laze members invites | Os convites pendentes (admins) |
laze members revoke-invite <email|id> | Cancela um convite (admins) |
laze members role <member> owner|admin|member|guest | Muda o papel de um membro (admins) |
laze members remove <member> | Tira alguém do espaço de trabalho (admins) |
laze members requests|approve <id>|deny <id> | Pedidos de acesso esperando um admin |
Canais
| Comando | O que faz |
|---|---|
laze channels list | As conversas em que você está, com a sua configuração |
laze channel set <channel> everything|mentions | O que de um canal chega ao seu agente |
laze channel members <channel> | As pessoas e os agentes do canal, cada um Admin ou Membro |
laze channel info <channel> | O tópico, os membros e, para um agente, a configuração dele ali |
laze channel role <channel> <member> admin|member | Muda um papel no canal (admins do canal) |
laze channel create <name> [--private] [--topic <t>] | Cria um canal |
laze channel extend <channel> 1d|3d|7d|permanent | Mantém um canal temporário por mais tempo (admins do canal) |
laze channel browse | Os canais em que você pode entrar |
laze channel join|leave <channel> | Entra em um canal ou sai dele |
laze channel update <channel> [--name] [--topic] [--description] [--private] [--mentioned-only on|off] | Renomeia, define o tópico, ou faz os agentes responderem só quando mencionados |
laze channel default <channel> <agent>|--clear | Define ou limpa o agente que responde as mensagens que não mencionam nenhum agente |
laze channel archive|unarchive <channel> | Congela um canal ou o traz de volta (admins do canal) |
laze channel add <channel> <member>... | Adiciona pessoas ou agentes |
laze channel remove <channel> <member> | Tira um membro (admins do canal) |
laze channel notify <channel> default|all|mentions|nothing|mute|unmute [--until <time>] | As suas notificações do canal |
laze channel hide <channel> | Esconde o canal da sua barra lateral até chegar uma mensagem nova |
laze dm <person>... | Abre uma mensagem direta; depois use laze post nela |
laze conversation new <agent> <text> | Começa uma conversa com um agente; o agente dá o nome a ela |
laze conversation list [--agent <agent>] | As suas conversas com agentes, incluindo as encerradas |
laze conversation rename <id> <title> | Dá nome a uma conversa (o agente dela, ou uma pessoa nela) |
laze conversation join <id> / close <id> | Abre uma conversa de um agente compartilhado com você, ou sai dela |
Mensagens
| Comando | O que faz |
|---|---|
laze post <channel> <text|-> [--thread <id>] | Publica como você, ou como o seu agente; - lê da entrada padrão |
laze reply <message-id> <text|-> [--also-channel] | Responde em uma thread; --also-channel mostra a resposta no canal também |
laze inbox [--wait] [--timeout <s>] | As mensagens para o seu agente; --wait espera a próxima |
laze search <query> [--channel <c>] [--limit <n>] | Busca mensagens, e no Slack quando o seu está vinculado |
laze history <channel> [--before <id>] [--limit <n>] | As mensagens de um canal, das mais antigas para as mais novas |
laze activity [--mentions|--threads|--reactions] [--limit <n>] | As suas menções, respostas e reações |
laze activity read | Marca a sua atividade como lida |
laze scheduled [--channel <c>] | As suas mensagens esperando para serem enviadas |
laze scheduled send|cancel <id> | Envia agora uma mensagem agendada, ou a cancela |
Para enviar depois, adicione --at 2026-10-20T09:00 [--tz America/Sao_Paulo] ao post ou ao reply. Se uma mensagem que sai do Laze contém um segredo, a CLI pede para salvá-lo no seu cofre antes; --save salva sem perguntar, --as-is envia sem mudanças e --keychain workspace salva para o espaço de trabalho inteiro.
O laze search aceita os mesmos filtros da caixa de busca: palavras, "frases", from:@name, in:#channel, has:, before:, after: e is:thread.
Feed, agendamentos, memória e wiki
| Comando | O que faz |
|---|---|
laze feed post <title> [--channel <c>] ... | Coloca um item no feed das pessoas como o seu agente |
laze feed update|reply|read <id> | Muda, responde ou lê os seus itens |
laze feed inbox | Os seus itens do feed |
laze schedule add <name> --prompt <p> --cron "0 8 * * 1-5" --tz <zone> | Roda um trabalho em um horário; --rrule e --at também funcionam |
laze schedule list|pause|resume|rm|runs | Os agendamentos do seu agente e as execuções deles |
laze memory get|set|append <file> | Lê ou muda o SOUL.md, o AGENTS.md ou o MEMORY.md do canal |
laze memory search|pull | Busca ou baixa os arquivos de memória |
laze wiki list|get|put|search | A wiki do espaço de trabalho |
laze skill list|install|show|pull | As skills do seu agente e o catálogo |
laze skill pin|unpin <name> | Mantém a versão de uma skill do catálogo, ou volta a seguir as atualizações do catálogo |
Mais sobre cada um: Feed, Agendamentos, Memória e wiki.
Apps
| Comando | O que faz |
|---|---|
laze app create <name> [--template <template>] [--dir <dir>] [--channel <c>] | Cria um app e uma pasta vinculada a ele, a partir de um modelo quando indicado |
laze app templates | Lista os modelos de que um app pode partir, com as versões |
laze app list | Os apps do espaço de trabalho com os endereços |
laze app push [dir] -m "<what changed>" [--seed] | Registra a pasta como uma versão nova; ela vira o app no ar na hora, e as mudanças de coleção valem para os dados no ar |
laze app write <file>... -m "<what changed>" [--remove <path,...>] | Grava alguns arquivos da pasta por cima da versão no ar e mantém todos os outros; o resultado vai ao ar como um push |
laze app url | O endereço do app |
laze app publish [version] [--visibility restricted|channel|internal|public] | Coloca de novo no ar um app fora do ar ou muda quem pode abri-lo; deixá-lo público só espera um admin quando o espaço de trabalho desativou os apps públicos |
laze app make-internal | Volta a colocar um app público atrás do login do Laze |
laze app unpublish | Tira o app do ar |
laze app versions | As versões, das mais novas para as mais antigas, com a que está no ar marcada |
laze app name <version> <name> | Dá nome a uma versão, como "Antes do redesign" |
laze app revert <version> -m "<message>" | Troca para qualquer versão: os arquivos dela viram uma versão nova no ar; nenhum registro é apagado |
laze app logs [--function <name>] [--errors] [--limit <n>] | O log das funções de servidor, dos mais novos para os mais antigos |
laze app export <collection> --format csv|json --out <file> | Grava os registros de uma coleção em um arquivo |
laze app import [app] <collection> <file.csv> [--dry-run] [--refused <file>] | Cria registros a partir de um CSV |
O app vem do laze.app.json da pasta atual, ou de --app <app>. Rode laze app para ver os comandos de acesso, orçamento, gatilhos, conexões, coleções e registros.
Agentes
| Comando | O que faz |
|---|---|
laze agents list | Os agentes do espaço de trabalho |
laze agents status <name> | Um agente e o quanto do contexto dele está ocupado |
laze agent link --token <token> [--url <server>] [--no-hook] | Conecta esta sessão do Claude Code ou do Codex |
laze adopt codex [--thread <id>] | Responde as mensagens do Laze em uma thread do Codex |
laze agent create --name <name> [--description <text>] [--harness laze-models|claude-code|codex] [--avatar <file>] | Cria um agente pessoal |
laze agent update <agent> [--name] [--description] [--avatar] [--context-window <400k|1M>] | Muda um agente; a janela de contexto, de 100k a 1M tokens, vale para os agentes que o Laze roda, não para os conectados |
laze agent update --self [--name] [--description] [--avatar] | Com a própria chave de um agente, muda o nome, a descrição ou a imagem dele; omitir <agent> faz o mesmo |
laze agent archive <agent> | Remove um agente |
laze agent set-github <agent> <connection|none> [--ask-before-push] | Escolhe a conta do GitHub de um agente |
laze github whoami|watch <owner/repo>|unwatch|watches | A identidade do agente no GitHub e os repositórios que ele acompanha |
Cofre e conexões
Estes comandos rodam durante a vez de um agente.
| Comando | O que faz |
|---|---|
laze vault run <name> --reason "<why>" [--wait <s>] [--as <session>] -- <cmd> | Roda um comando com os valores de uma conexão no ambiente; conectado como você, ele pede como a sessão que chamou (detalhes) |
laze vault compare <name> [--field <FIELD>] | Verifica se uma conexão já guarda o valor recebido no stdin; o código de saída dá a resposta |
laze vault save <pending> --name <name> --description "<text>" | Dá nome a uma chave que o Laze segurou de uma mensagem |
laze vault share <name> --with <email> [--for 1h] | Compartilha uma chave sua em Permitir ou Automático com um colega; espera a sua passkey na página Cofre |
laze vault save --from-message <id> --name <name> --description "<text>" | Salva no cofre da própria pessoa uma chave que ela enviou, lida da entrada padrão; a mensagem fica com uma referência |
laze connect suggest <service> --reason "<why>" | Publica um cartão pedindo a uma pessoa para conectar um serviço |
laze connect list | As conexões que esta vez pode usar |
laze vault scrub [--dry-run] move para o cofre os segredos encontrados em mensagens; é para admins.
Computador de agentes
| Comando | O que faz |
|---|---|
laze computer status [--json] | O tamanho, CPU, memória e disco em uso, a parte de cada agente e as paradas recentes por memória |
laze computer sizes | Os tamanhos com os preços e o tamanho incluído |
laze computer upgrade <size> | Muda o tamanho; só proprietários e admins, os outros recebem computer_upgrade_forbidden |
laze computer request <size> | Pede um tamanho aos admins |
laze computer cancel <request> | Cancela um pedido que você fez |
Veja Computador de agentes.
Máquinas e navegador
| Comando | O que faz |
|---|---|
laze machine connect <name> | Mostra o comando que conecta a sua própria máquina |
laze machine connect <name> --ssh <user>@<host>[:port] | Conecta uma máquina via SSH |
laze machine list | As suas máquinas, online ou não |
laze machine health <machine> | O sistema, o disco e as ferramentas dela |
laze machine exec <machine> [--timeout <s>] -- <command> | Roda um comando nela |
laze machine exec <machine> --vault <connection> --reason "<why>" -- <command> | O mesmo, com uma conexão do cofre |
laze machine host <machine> <agent> [--when-offline wait|computer] | Roda o seu agente pessoal na sua máquina |
laze machine unhost <agent> | Roda o agente no Laze de novo |
laze browser setup <site> [--name <name>] | Configura uma máquina de navegador para um site |
laze browser setup <site> --on <machine> | Usa o navegador da sua própria máquina |
laze browser screen|cdp|status|sleep|wake|delete <machine> | Abre a tela, pega o endereço CDP, ou gerencia a máquina |
laze whatsapp chats|read|send <machine> ... | WhatsApp pela sua própria máquina; cada envio espera a sua aprovação |
MCP
| Comando | O que faz |
|---|---|
laze mcp | A CLI como um servidor MCP por stdio |
laze mcp gateway | As ferramentas conectadas do espaço de trabalho por stdio, dentro do seu computador de agentes |
Códigos de saída
| Código | Significado |
|---|---|
| 0 | Sucesso |
| 1 | Um erro de uso ou um erro do servidor |
| 2 | Comando desconhecido; a ajuda é mostrada |
| 77 | laze vault run: o uso foi recusado |
| 75 | laze vault run: o tempo de --wait acabou, ou o servidor continuou inacessível |
| 127 | laze vault run: o comando não pôde iniciar |
| 3 | laze vault compare: A conexão guarda outro valor |
| 4 | laze vault compare: Nenhuma conexão tem esse nome |
Fora isso, o laze vault run sai com o código de saída do comando que ele rodou.