---
title: "CLI di AdaptlyPost"
description: "Installa la CLI di AdaptlyPost, accedi con un token API e usa ogni parte di AdaptlyPost dal terminale o da uno script. Output JSON e veri codici di uscita."
url: "https://adaptlypost.com/it/features/cli/docs"
---

[Torna agli agenti AI](https://adaptlypost.com/it/features/agents)

# CLI di AdaptlyPost

Gestisci AdaptlyPost dal terminale o da uno script. Un solo binario, nessun runtime da gestire, e ogni comando può restituire JSON.

## Installazione

Scegli il metodo più adatto alla tua macchina. Homebrew e curl installano un binario autonomo, quindi Node non serve.

npm

```
npm install -g @adaptlypost/cli
```

Homebrew (macOS, Linux)

```
brew trust adaptlypost/tap && brew install adaptlypost/tap/adaptlypost
```

Script di installazione (macOS, Linux)

```
curl -fsSL https://adaptlypost.com/install.sh | sh
```

Esegui una volta, senza installare

```
npx -p @adaptlypost/cli adaptlypost --help
```

Homebrew 7 si rifiuta di caricare una formula da un tap di terze parti finché non lo consideri attendibile, ed è quello che fa brew trust. Se lo salti, sia l'installazione sia l'aggiornamento si fermano con "Refusing to load formula from untrusted tap".

L'installazione ti dà due nomi per lo stesso programma. Quello breve è `apost`.

## Autenticazione

Crea un token API e passalo a login. I token si trovano nelle impostazioni del workspace: [API e agenti AI](https://adaptlypost.com/it/api-tokens).

```
adaptlypost login
```

Il comando apre la pagina dei token, legge il token da un prompt nascosto, controlla il prefisso `adaptly_` in locale, poi lo verifica con una chiamata API prima di scriverlo su disco con permessi 0600\. Se il controllo non va a buon fine non viene salvato nulla.

In CI, passa il token tramite pipe e salta il prompt

```
echo "$MY_SECRET" | adaptlypost login --token-stdin
```

Oppure non salvarlo affatto e passalo a ogni comando

```
ADAPTLYPOST_API_TOKEN=adaptly_your_token adaptlypost whoami
```

## Avvio rapido

Programma un post su due piattaforme. Gli id degli account si ottengono con adaptlypost accounts list.

```
adaptlypost post --caption "Shipping today"   --accounts acc_123 --platforms LINKEDIN,TWITTER   --schedule "2026-10-02T09:00:00Z"
```

## Comandi

Ogni comando accetta --help e la maggior parte accetta --json. Se qualcosa non va, esegui prima adaptlypost doctor.

Accesso

| adaptlypost login  | Salva un token API su questa macchina, dopo aver verificato che funziona |
| ------------------ | ------------------------------------------------------------------------ |
| adaptlypost logout | Rimuove il token salvato                                                 |
| adaptlypost whoami | Mostra quale token è in uso e cosa può vedere                            |

Lavoro di tutti i giorni

| adaptlypost post      | Crea, programma, pubblica, aggiorna ed elimina i post |
| --------------------- | ----------------------------------------------------- |
| adaptlypost accounts  | Elenca gli account social collegati e i loro id       |
| adaptlypost analytics | Copertura, engagement e suddivisioni per piattaforma  |
| adaptlypost media     | Carica immagini e video per un post                   |

Vie di fuga

| adaptlypost api  | Invia una richiesta autenticata a qualsiasi endpoint dell'API |
| ---------------- | ------------------------------------------------------------- |
| adaptlypost mcp  | Stampa la configurazione del server MCP per il tuo editor     |
| adaptlypost open | Apre una pagina della web app nel browser                     |

Questa macchina

| adaptlypost config     | Legge e scrive le preferenze della CLI                      |
| ---------------------- | ----------------------------------------------------------- |
| adaptlypost doctor     | Controlla questa macchina, i file di configurazione e l'API |
| adaptlypost completion | Stampa lo script di completamento per la shell              |

Ogni comando elenca le proprie opzioni con `adaptlypost <command> --help`.

## Scripting

Aggiungi --json a qualsiasi comando e ottieni un envelope stabile con ok, command e data, pronto per jq.

```
adaptlypost whoami --json
```

Raramente ti serve l'opzione. L'output passa da solo a JSON quando stdout non è un terminale o quando CI è impostata, quindi un comando in pipe ti restituisce già JSON.

Codici di uscita

| 0 | Successo                                                          |
| - | ----------------------------------------------------------------- |
| 2 | Errore di utilizzo, per esempio un'opzione mancante o sconosciuta |
| 3 | Il token è stato rifiutato o manca                                |
| 4 | Nessun risultato per quell'id                                     |
| 5 | L'API ha rifiutato l'input                                        |
| 7 | Troppe richieste                                                  |
| 8 | Errore di rete o timeout                                          |
| 9 | Raggiunto il limite del piano o della quota                       |

## Prossimi passi

Crea un token, oppure collega lo stesso account a un agente AI.

[Crea un token API](https://adaptlypost.com/it/api-tokens)[Agenti AI e MCP](https://adaptlypost.com/it/features/agents)