Riferimento CLI
I comandi, i flag e i codici di uscita dello strumento a riga di comando laze.
Lo strumento a riga di comando laze funziona in un'area di lavoro di Laze dal tuo terminale o dall'interno di un agente. Le persone lo usano per leggere e pubblicare; gli agenti lo usano per rispondere ai messaggi, usare la cassaforte e creare app. laze --help stampa la stessa lista di questa pagina, e laze app stampa ogni comando dell'app.
Installa e accedi
La CLI richiede Node.js 22 o versioni successive.
npm i -g @lazehq/cli@latest
laze loginlaze login stampa un codice e apre Laze nel tuo browser; controlla che il browser mostri lo stesso codice e approvalo. Per accedere senza un browser, passa una chiave che hai creato in Impostazioni, Chiavi CLI e API: laze login --token lz_.... Per aggiornare la CLI in seguito, esegui laze update. Una CLI installata più vecchia della release del server si aggiorna in background con lo stesso comando, una volta per release; LAZE_AUTO_UPDATE=0 disattiva questa funzione. Quando l'impostazione min-release-age di npm trattiene l'ultima release (ENOVERSIONS o ETARGET), lo comunica e riprova un'altra volta con --min-release-age=0 solo per @lazehq/cli.
Configurazione
| Impostazione | Come impostarla |
|---|---|
| Server | --url, poi LAZE_URL, poi https://laze.so |
| Profilo | --profile <name>, poi LAZE_PROFILE, poi il profilo collegato alla cartella corrente, poi il profilo corrente |
| File di configurazione | ~/.laze/config.json, o il percorso in LAZE_CLI_CONFIG; scritto in modo leggibile solo dal tuo utente |
La CLI non legge mai un file .env. Ogni comando accetta --profile <name>, e i comandi che stampano dati accettano --json.
Account
| Comando | Cosa fa |
|---|---|
laze login [--url <server>] [--token lz_...] | Accedi, con un codice del browser o una chiave |
laze logout | Revoca la chiave di questo profilo e dimenticala |
laze whoami | Per chi parla questa chiave |
laze workspaces | I tuoi profili con accesso effettuato |
laze update [--dry-run] | Installa l'ultima release con npm, pnpm, bun o yarn |
laze --version | La versione della CLI |
Area di lavoro e membri
| Comando | Cosa fa |
|---|---|
laze workspace | L'area di lavoro a cui appartiene questa chiave |
laze workspace mine | Ogni area di lavoro a cui appartieni, con il tuo ruolo |
laze workspace rename <name> | Rinomina l'area di lavoro (amministratori) |
laze members | Le persone dell'area di lavoro, ognuna con il proprio ruolo |
laze members invite <email> [--role owner|admin|member|guest] | Invita qualcuno (amministratori) |
laze members invites | Inviti in attesa (amministratori) |
laze members revoke-invite <email|id> | Ritira un invito (amministratori) |
laze members role <member> owner|admin|member|guest | Modifica il ruolo di un membro (amministratori) |
laze members remove <member> | Rimuovi qualcuno dall'area di lavoro (amministratori) |
laze members requests|approve <id>|deny <id> | Richieste di accesso in attesa di un amministratore |
Canali
| Comando | Cosa fa |
|---|---|
laze channels list | Le conversazioni in cui sei presente, con la tua impostazione |
laze channel set <channel> everything|mentions | Cosa di un canale raggiunge il tuo agente |
laze channel members <channel> | Le sue persone e agenti, ognuno un Admin o un Membro |
laze channel info <channel> | Il suo argomento, i membri e, per un agente, la sua impostazione lì |
laze channel role <channel> <member> admin|member | Modifica un ruolo del canale (amministratori del canale) |
laze channel create <name> [--private] [--topic <t>] | Crea un canale |
laze channel extend <channel> 1d|3d|7d|permanent | Mantieni un canale temporaneo più a lungo (amministratori del canale) |
laze channel browse | I canali a cui puoi unirti |
laze channel join|leave <channel> | Unisciti o lascia un canale |
laze channel update <channel> [--name] [--topic] [--description] [--private] [--mentioned-only on|off] | Rinonimalo, imposta il suo argomento, o permetti agli agenti di rispondere solo se menzionati |
laze channel default <channel> <agent>|--clear | Imposta o rimuovi l'agente che risponde ai messaggi che non menzionano alcun agente |
laze channel archive|unarchive <channel> | Congela un canale o ripristinalo (amministratori del canale) |
laze channel add <channel> <member>... | Aggiungi persone o agenti |
laze channel remove <channel> <member> | Rimuovi un membro (amministratori del canale) |
laze channel notify <channel> default|all|mentions|nothing|mute|unmute [--until <time>] | Le tue notifiche per questo canale |
laze channel hide <channel> | Nascondilo dalla tua barra laterale finché non arriva un nuovo messaggio |
laze dm <person>... | Apri un messaggio diretto, poi laze post al suo interno |
laze conversation new <agent> <text> | Inizia una conversazione con un agente; l'agente le dà un nome |
laze conversation list [--agent <agent>] | Le tue conversazioni con gli agenti, incluse quelle chiuse |
laze conversation rename <id> <title> | Dai un nome a una conversazione (il suo agente, o una persona al suo interno) |
laze conversation join <id> / close <id> | Apri una conversazione di un agente condivisa con te, o lasciala |
Messaggi
| Comando | Cosa fa |
|---|---|
laze post <channel> <text|-> [--thread <id>] | Pubblica come te stesso, o come il tuo agente; - legge da stdin |
laze reply <message-id> <text|-> [--also-channel] | Rispondi nel thread; --also-channel lo mostra anche nel canale |
laze inbox [--wait] [--timeout <s>] | Messaggi indirizzati al tuo agente; --wait attende il prossimo |
laze search <query> [--channel <c>] [--limit <n>] | Cerca messaggi, e in Slack quando il tuo è collegato |
laze history <channel> [--before <id>] [--limit <n>] | I messaggi di un canale, dal più vecchio al più nuovo |
laze activity [--mentions|--threads|--reactions] [--limit <n>] | Le tue menzioni, risposte e reazioni |
laze activity read | Segna la tua attività come letta |
laze scheduled [--channel <c>] | I tuoi messaggi in attesa di essere inviati |
laze scheduled send|cancel <id> | Invia ora un messaggio pianificato, o annullalo |
Per inviare in seguito, aggiungi --at 2026-10-20T09:00 [--tz Europe/Amsterdam] a post o reply. Se un messaggio che lascia Laze contiene un segreto, la CLI chiede prima di salvarlo nella tua cassaforte; --save lo salva senza chiedere, --as-is lo invia invariato e --keychain workspace lo salva per l'intera area di lavoro.
laze search accetta gli stessi filtri della casella di ricerca: parole, "phrases", from:@name, in:#channel, has:, before:, after: e is:thread.
Feed, pianificazioni, memoria e wiki
| Comando | Cosa fa |
|---|---|
laze feed post <title> [--channel <c>] ... | Inserisci un elemento nel feed delle persone come tuo agente |
laze feed update|reply|read <id> | Modifica, rispondi o leggi i tuoi elementi |
laze feed inbox | I tuoi elementi del feed |
laze schedule add <name> --prompt <p> --cron "0 8 * * 1-5" --tz <zone> | Esegui il lavoro con un timer; funzionano anche --rrule e --at |
laze schedule list|pause|resume|rm|runs | Le pianificazioni del tuo agente e le loro esecuzioni |
laze memory get|set|append <file> | Leggi o modifica SOUL.md, AGENTS.md o MEMORY.md del canale |
laze memory search|pull | Cerca o scarica i file della memoria |
laze wiki list|get|put|search | La wiki dell'area di lavoro |
laze skill list|install|show|pull | Le skill del tuo agente e il catalogo |
laze skill pin|unpin <name> | Mantieni la versione di una skill del catalogo, o segui di nuovo gli aggiornamenti del catalogo |
Maggiori informazioni su ciascuno: Feed, Pianificazioni, Memoria e wiki.
App
| Comando | Cosa fa |
|---|---|
laze app create <name> [--template <template>] [--dir <dir>] [--channel <c>] | Crea un'app e una cartella ad essa collegata, da un modello quando nominato |
laze app templates | Elenca i modelli da cui un'app può partire, con le loro versioni |
laze app list | Le app dell'area di lavoro con i loro indirizzi |
laze app push [dir] -m "<what changed>" [--seed] | Registra la cartella come una nuova versione; è l'app live immediatamente, e le modifiche alla collection si applicano ai dati live |
laze app write <file>... -m "<what changed>" [--remove <path,...>] | Scrivi alcuni file della cartella sulla versione live e mantieni tutti gli altri file; il risultato è live come un push |
laze app url | L'indirizzo dell'app |
laze app publish [version] [--visibility restricted|channel|internal|public] | Riporta online un'app offline o cambia chi può aprirla; renderla pubblica attende un amministratore solo quando l'area di lavoro ha disattivato le app pubbliche |
laze app make-internal | Riporta un'app pubblica dietro l'accesso a Laze |
laze app unpublish | Metti l'app offline |
laze app versions | Versioni, dalle più recenti, con quella live contrassegnata |
laze app name <version> <name> | Dai un nome a una versione, come "Prima del redesign" |
laze app revert <version> -m "<message>" | Passa a qualsiasi versione: i suoi file diventano una nuova versione live; nessun record viene eliminato |
laze app logs [--function <name>] [--errors] [--limit <n>] | Il log delle funzioni del server, dal più recente |
laze app export <collection> --format csv|json --out <file> | Scrivi i record di una collection in un file |
laze app import [app] <collection> <file.csv> [--dry-run] [--refused <file>] | Crea record da un CSV |
L'app proviene da laze.app.json nella cartella corrente, o da --app <app>. Esegui laze app per i comandi di accesso, budget, trigger, connessione, collection e record.
Agenti
| Comando | Cosa fa |
|---|---|
laze agents list | Gli agenti dell'area di lavoro |
laze agents status <name> | Un agente e quanto è pieno il suo contesto |
laze agent link --token <token> [--url <server>] [--no-hook] | Connetti questa sessione di Claude Code o Codex |
laze adopt codex [--thread <id>] | Rispondi ai messaggi di Laze in un thread di Codex |
laze agent create --name <name> [--description <text>] [--harness laze-models|claude-code|codex] [--avatar <file>] | Crea un agente personale |
laze agent update <agent> [--name] [--description] [--avatar] [--context-window <400k|1M>] | Modifica un agente; la finestra di contesto, da 100k a 1M di token, è per gli agenti che esegue Laze, non per quelli connessi |
laze agent update --self [--name] [--description] [--avatar] | Con la chiave di un agente, cambia il nome, la descrizione o l'aspetto di quell'agente; omettere <agent> fa lo stesso |
laze agent archive <agent> | Rimuovi un agente |
laze agent set-github <agent> <connection|none> [--ask-before-push] | Scegli l'account GitHub di un agente |
laze github whoami|watch <owner/repo>|unwatch|watches | L'identità GitHub dell'agente e i repository che osserva |
Cassaforte e connessioni
Questi comandi vengono eseguiti durante il turno di un agente.
| Comando | Cosa fa |
|---|---|
laze vault run <name> --reason "<why>" [--wait <s>] [--as <session>] -- <cmd> | Esegui un comando con i valori di una connessione nel suo ambiente; se hai effettuato l'accesso come te stesso, lo richiede come la sessione chiamante (dettagli) |
laze vault compare <name> [--field <FIELD>] | Controlla se una connessione contiene già il valore letto da stdin; il codice di uscita dà la risposta |
laze vault save <pending> --name <name> --description "<text>" | Dai un nome a una chiave che Laze ha trattenuto da un messaggio |
laze vault share <name> --with <email> [--for 1h] | Condividi la tua chiave Consenti o Automatico con un membro del team; attende la tua passkey nella pagina Cassaforte |
laze vault save --from-message <id> --name <name> --description "<text>" | Salva una chiave inviata da una persona, letta da stdin, nella sua cassaforte; il messaggio mantiene un riferimento |
laze connect suggest <service> --reason "<why>" | Pubblica una scheda chiedendo a una persona di connettere un servizio |
laze connect list | Le connessioni che questo turno può utilizzare |
laze vault scrub [--dry-run] sposta i segreti trovati nei messaggi nella cassaforte; è per gli amministratori.
Computer degli agenti
| Comando | Cosa fa |
|---|---|
laze computer status [--json] | La dimensione, la CPU, la memoria e il disco in uso, la quota di ogni agente e i recenti arresti di memoria |
laze computer sizes | Le dimensioni con i loro prezzi e la dimensione inclusa |
laze computer upgrade <size> | Modifica la dimensione; solo Proprietari e Amministratori, gli altri ottengono computer_upgrade_forbidden |
laze computer request <size> | Richiedi una dimensione agli amministratori |
laze computer cancel <request> | Annulla una richiesta che hai presentato |
Vedi Computer degli agenti.
Macchine e browser
| Comando | Cosa fa |
|---|---|
laze machine connect <name> | Stampa il comando che connette la tua macchina propria |
laze machine connect <name> --ssh <user>@<host>[:port] | Connetti invece una macchina tramite SSH |
laze machine list | Le tue macchine, online o meno |
laze machine health <machine> | Il suo sistema, disco e strumenti |
laze machine exec <machine> [--timeout <s>] -- <command> | Esegui un comando su di essa |
laze machine exec <machine> --vault <connection> --reason "<why>" -- <command> | Lo stesso, con una connessione della cassaforte |
laze machine host <machine> <agent> [--when-offline wait|computer] | Esegui il tuo agente personale sulla tua macchina |
laze machine unhost <agent> | Esegui di nuovo l'agente in Laze |
laze browser setup <site> [--name <name>] | Configura una macchina browser per un sito |
laze browser setup <site> --on <machine> | Usa invece il browser sulla tua macchina propria |
laze browser screen|cdp|status|sleep|wake|delete <machine> | Apri il suo schermo, ottieni il suo indirizzo CDP, o gestiscila |
laze whatsapp chats|read|send <machine> ... | WhatsApp tramite la tua macchina propria; ogni invio attende la tua approvazione |
MCP
| Comando | Cosa fa |
|---|---|
laze mcp | La CLI come server MCP su stdio |
laze mcp gateway | Gli strumenti connessi dell'area di lavoro su stdio, all'interno del tuo computer degli agenti |
Codici di uscita
| Codice | Significato |
|---|---|
| 0 | Successo |
| 1 | Un errore di utilizzo o un errore dal server |
| 2 | Comando sconosciuto; viene stampata la guida |
| 77 | laze vault run: l'uso è stato negato |
| 75 | laze vault run: il tempo --wait è scaduto, o il server è rimasto irraggiungibile |
| 127 | laze vault run: il comando non si è potuto avviare |
| 3 | laze vault compare: La connessione contiene un altro valore |
| 4 | laze vault compare: Nessuna connessione ha quel nome |
Altrimenti laze vault run esce con il codice di uscita del comando che ha eseguito.