Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.noimosai.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Panoramica

NoimosAI CLI (@agos-labs/noimosai-cli) ti permette di usare il tuo workspace NoimosAI dalla riga di comando. Puoi parlare con l’agente NoimosAI per analisi marketing, generazione di contenuti e SEO, pubblicare sia post social brevi sia articoli lunghi (WordPress, note) su piattaforme collegate e controllare workspace e integrazioni senza uscire dal terminale. Il pacchetto è pubblicato su npm come @agos-labs/noimosai-cli.

​
Funzionalità principali

  • Chat — conversazioni interattive o singole con l’agente NoimosAI.
  • Pubblicazione — invio di post social e articoli lunghi verso account collegati.
  • Controllo di workspace e integrazioni — visualizzazione di workspace e account connessi dalla CLI.
  • Automazione — i comandi principali supportano flag e --output json per risultati leggibili da script.

​
Comandi più comuni

Questi comandi permettono di capire rapidamente cosa fa la CLI. 
noimosai login                              # Accedi (browser OAuth o chiave API)
noimosai chat                               # Avvia una chat interattiva
noimosai chat -p "Draft a launch post"      # Invia un prompt singolo
noimosai chat -p "..." -o json              # Prompt singolo con output JSON
noimosai post posts.json --dry-run          # Anteprima di una pubblicazione
noimosai post posts.json --now              # Pubblica subito
noimosai workspace list                     # Elenca i workspace disponibili
noimosai integration list                   # Elenca gli account collegati

​
Piattaforme di pubblicazione supportate

Sia i post brevi sia gli articoli lunghi possono essere pubblicati da un unico file posts.json.
TipoPiattaforma
SNSX (Twitter), Threads, Facebook, Instagram, YouTube, LinkedIn, TikTok, Bluesky, Pinterest
ArticoloWordPress, note

​
Requisiti

  • Node.js >= 18
  • Un account NoimosAI attivo (registrati)

​
Installazione

Installa la CLI globalmente con il gestore di pacchetti che preferisci. 
pnpm add -g @agos-labs/noimosai-cli

npm install -g @agos-labs/noimosai-cli
Dopo l’installazione, il comando noimosai sarà disponibile nella shell.

​
Avvio rapido

​
1. Accedi

noimosai login
Puoi autenticarti in due modi:
  • Accesso via browser (OAuth) — apre il browser per completare l’autenticazione.
  • Chiave API — usa una chiave API generata nelle impostazioni del team NoimosAI.
Per ambienti non interattivi come CI/CD: 
noimosai login --api-key "$NOIMOS_API_KEY"

​
2. Avvia una chat

noimosai chat
Questo comando apre una sessione interattiva con l’agente NoimosAI. Da lì puoi chiedere analisi, contenuti o rifinire i risultati. Sessione di chat NoimosAI CLI nel terminale

​
3. Scopri tutti i comandi

noimosai --help
Usa --help su qualsiasi sottocomando per vedere tutte le opzioni disponibili nella versione installata.

​
Comandi

​
Autenticazione

  • noimosai login — accesso interattivo tramite browser OAuth o chiave API
  • noimosai login --oauth — forza OAuth via browser
  • noimosai login --api-key <key> — accesso non interattivo con chiave API
  • noimosai logout — rimuove le credenziali salvate

​
chat

  • noimosai chat — avvia una sessione di chat interattiva
  • noimosai chat -p "<message>" — invia un prompt singolo
  • noimosai chat -r <session-id> — riprende una sessione precedente
  • noimosai chat -p "<message>" -o json — output JSON per script
  • noimosai chat -w <workspace-id> — sovrascrive il workspace predefinito

​
Pubblicazione

Usa noimosai post per fare un’anteprima, pubblicare subito o programmare contenuti da posts.json. 
noimosai post posts.json --dry-run                     # Mostra un’anteprima di invio
noimosai post posts.json --now                         # Pubblica subito
noimosai post posts.json --schedule "2026-04-10 09:00" # Programma la pubblicazione
noimosai post posts.json --now -o json                 # Risultato JSON per script
posts.json viene normalmente prodotto da una sessione di chat. Se lo prepari a mano, lo schema è questo: 
{
  "version": "1",
  "metadata": { "generatedAt": "2026-04-27T09:00:00Z" },
  "posts": [
    {
      "platform": "WordPress",
      "dataKey": "wpPostData",
      "providerAccountId": "...",
      "textBlocks": [{ "text": "..." }],
      "media": []
    }
  ]
}
Il campo dataKey controlla il reale instradamento verso la destinazione di pubblicazione.
PiattaformadataKey
X (Twitter)xPostData
ThreadsthPostData
FacebookfbPostData
InstagramigPostData
YouTubeytPostData
LinkedInlinkedinPostData
TikTokttPostData
BlueskyblueskyPostData
PinterestpinterestPostData
NotenotePostData
WordPresswpPostData

​
Workspace e integrazioni

  • noimosai workspace list — elenca i workspace a cui hai accesso
  • noimosai integration list — elenca le integrazioni esterne collegate

​
Configurazione

  • noimosai config show — mostra la configurazione corrente
  • noimosai config get <key> — legge un valore di configurazione
  • noimosai config set <key> <val> — imposta un valore di configurazione
  • noimosai config path — stampa il percorso del file di configurazione

​
Opzioni globali

  • -o, --output <text|json> — formato di output (text o json)
  • --help — mostra l’aiuto per qualsiasi comando o sottocomando

​
Utilizzo in CI o con agenti

La CLI è pensata sia per l’uso umano sia per l’automazione. 
# Accesso headless
noimosai login --api-key "$NOIMOS_API_KEY" -o json

# Prompt singolo con output JSON
noimosai chat -p "Draft a LinkedIn post about our launch" -o json

# Dry-run prima della pubblicazione
noimosai post posts.json --dry-run
noimosai post posts.json --now -o json

​
Risoluzione dei problemi

  • Cannot find package 'zod' — l’installazione globale è vecchia; reinstalla la CLI.
  • Not authenticated — esegui di nuovo noimosai login.
  • Workspace ID not configured — accedi di nuovo oppure passa -w <workspace-id> al comando.

​
Correlati