Presentazione di Quire CLI: gestione dei progetti dal tuo terminale

Riepilogo
Quire CLI è lo strumento a riga di comando standalone per gestire Quire da un terminale. Installalo una volta tramite npm o Homebrew, accedi con OAuth ed esegui sottocomandi strutturati (quire project list, quire task create, quire mine) che puoi collegare in pipe, inserire in script e pianificare con cron. È una categoria diversa dal server Quire MCP, pensato per agenti AI come Claude Code o ChatGPT che chiamano Quire come strumenti. Scegli la CLI se vivi nel terminale e vuoi velocità, possibilità di scripting e comandi prevedibili.

La maggior parte degli utenti Quire lavora nel browser. L'app web è la superficie giusta per la pianificazione visiva, le sottoliste drag-and-drop e le revisioni con gli stakeholder. Ma esiste un gruppo più silenzioso di utenti — sviluppatori, operations, PM tecnici, chiunque viva già in un terminale — per cui aprire una scheda del browser solo per contrassegnare tre attività come completate sembra un inutile spreco di tempo. Quire CLI è pensato per loro.

Non è uno strumento AI. Non porta con sé un modello linguistico. È il tipo di strumento che sono git, gh o aws: un'interfaccia a riga di comando strutturata per un servizio che già utilizzi, in cui ogni azione corrisponde a un comando prevedibile che puoi collegare in pipe, inserire in script o pianificare. Accedi una volta sola e la prossima volta che devi creare un'attività non devi interrompere il flusso per trovare la scheda Quire giusta.

Quello che segue è la versione onesta di cosa è Quire CLI, come installarlo, i comandi che vale la pena conoscere e i cinque flussi di lavoro di esempio che ripagano il tempo di configurazione nella prima settimana.

Cos'è Quire CLI?

Quire CLI (@quire-io/quire-cli su npm, quire una volta installato) è un singolo eseguibile che comunica con Quire API tramite OAuth.

Cosa è:

• Uno strumento a riga di comando classico con sottocomandi strutturati che puoi collegare in pipe e inserire in script.
• Autenticato via OAuth. Esegui quire login una volta sola, niente gestione di chiavi API, niente configurazioni di account di servizio.
• Multipiattaforma. macOS, Linux, Windows: ovunque giri Node.js o un singolo binario.
• Un'interfaccia diretta a Quire API. Ogni comando CLI corrisponde a un endpoint API reale, quindi nulla di ciò che fa la CLI è nascosto dietro una superficie ridotta.

Cosa non è:

• Uno strumento AI. Quire CLI non comprende il linguaggio naturale. I comandi sono strutturati (quire task create "Marketing_Q4" --name "Draft launch email"), non prompt in Chat.
• Legato a un particolare client AI. Se vuoi che agenti AI leggano e scrivano su Quire per tuo conto, è compito del server Quire MCP. Superficie diversa, pubblico diverso.

Perché una CLI per Quire?

Tre motivi precisi, non impressioni.

Motivo 1: Velocità. Aprire Quire, trovare il progetto giusto, trovare l'attività giusta, fare clic su "completa" richiede dai 15 ai 20 secondi anche nelle giornate migliori. quire task complete <task-id> richiede un secondo da un terminale già aperto. Moltiplica questo per i 30 e più interventi giornalieri di un utente intensivo di Quire, e la differenza di tempo si accumula.

Motivo 2: Script e cron. Una CLI è un mattone per l'automazione. Uno script shell mattutino può raccogliere le tue attività Scadute in un digest Markdown. Un target make weekly-status può cercare in ogni progetto gli elementi completati questa settimana e scrivere un aggiornamento di Stato. Un cron job può pubblicare il risultato su Slack il venerdì alle 16. Niente di tutto ciò è possibile da una finestra Chat o da una scheda web.

Motivo 3: Output trasparente. Ogni comando CLI stampa ciò che ha fatto. Vedi l'ID dell'attività appena creata, la risposta dell'API, l'errore se qualcosa è andato storto. Non ci sono chiamate di strumenti nascoste, nessun "vado avanti e le creo per te" senza modo di verificare cosa è atterrato. Quando 40 attività stanno per entrare in uno spazio di lavoro condiviso, questa visibilità è la differenza tra uno strumento utile e un rischio.

Quire CLI vs server Quire MCP vs Quire REST API

Quire offre tre superfici programmatiche. Usa quella più adatta al lavoro.

Il server MCP e la CLI si autenticano entrambi tramite OAuth. La REST API usa token di accesso. Tutti e tre operano sugli stessi dati e rispettano gli stessi permessi, quindi un'attività creata da uno qualsiasi di essi appare immediatamente negli altri.

Se vuoi il lato AI, la guida alla configurazione di Quire MCP illustra come collegare il server MCP a Claude Code, ChatGPT o qualsiasi altro client compatibile. La CLI e MCP sono complementari, non alternative.

Prerequisiti

• Un account Quire Free o a pagamento con almeno un'organizzazione e un progetto che vuoi controllare dal terminale.
• Un terminale: macOS Terminal, iTerm2, Windows Terminal o qualsiasi shell Linux.
• Uno dei seguenti: Node.js 18 o versione successiva (per l'installazione npm), Homebrew (macOS o Linux) o la possibilità di scaricare un binario a file singolo da GitHub Releases.
• La possibilità di ricevere un callback OAuth su localhost. La maggior parte delle reti lo consente. Alcune VPN aziendali lo bloccano. Se quire login va in timeout in attesa del reindirizzamento, chiedi all'IT di consentire i reindirizzamenti loopback.

Installazione di Quire CLI

Quire CLI viene distribuito come un singolo binario a riga di comando. Scegli il metodo di installazione più adatto a come gestisci già le CLI. Il README su GitHub elenca tutte le opzioni.

npm (per la maggior parte degli utenti):

npm i -g @quire-io/quire-cli

Homebrew (macOS o Linux):

brew install quire-io/quire/quire

Prova senza installare:

npx @quire-io/quire-cli --help

Oppure scarica un binario a file singolo dalla pagina GitHub Releases.

Una volta installato, esegui il login OAuth una tantum. Si apre una scheda del browser, accedi a Quire e approva l'accesso allo spazio di lavoro, e la CLI memorizza il suo token in ~/.config/quire/credentials.json (o nel portachiavi del sistema operativo, se disponibile):

quire login
quire whoami

Se quire whoami stampa il tuo account, sei connesso. Prova alcuni comandi reali:

quire project list
quire task list "Marketing_Q4"
quire mine --all-orgs --json

Cosa può fare Quire CLI

La superficie completa dei sottocomandi è documentata nel README su GitHub, ma i comandi che vale la pena conoscere il primo giorno stanno tutti in una schermata.

quire login                                       # configurazione OAuth una tantum
quire whoami                                      # conferma di essere connesso
quire logout                                      # rimuove le credenziali locali

quire project list                                # elenca i tuoi progetti
quire task list "<project>"                       # elenca le attività in un progetto
quire task tree <task-id> --depth full            # vista ad albero ricorsiva
quire task search "release notes" --mine          # cerca attività (solo le tue)
quire task create "<project>" --name "Ship CLI v1" --due 2026-06-30
quire task complete <task-id>                     # segna un'attività come completata
quire mine --all-orgs --json                      # elenca le tue attività in tutte le org

Ogni comando supporta --help per le opzioni complete. La maggior parte supporta anche --json per output leggibile dalla macchina, che è la base di tutti i flussi di lavoro di esempio qui sotto.

Ogni azione corrisponde 1:1 a un endpoint Quire REST API.

Flussi di lavoro di esempio

Cinque piccoli pattern che ripagano il tempo di installazione nella prima settimana.

Digest per il daily standup

quire mine --all-orgs --json \
  | jq -r '.[] | select(.due == "2026-05-11") | "- [" + .name + "](" + .url + ") (" + .project + ")"'

Eseguilo alle 9, incolla il markdown in Slack o nel documento dello stato giornaliero. Aggiungi un alias a .zshrc così il mattino dopo basta una parola:

alias standup='quire mine --all-orgs --json | jq -r "..."'

Creazione di attività in blocco dalle note di riunione

grep "^TODO:" ./meetings/2026-05-04-sync.md \
  | sed 's/^TODO: //' \
  | while read task; do
      quire task create "Marketing_Q4" \
        --name "$task" \
        --tag "from-monday-sync" \
        --due 2026-05-08
    done

Dodici minuti di lavoro amministrativo del lunedì ridotti a un loop shell. Mettilo in un Makefile e lo stesso target funzionerà ogni lunedì senza dover ricordare la sintassi.

Cron job: digest delle attività scadute del venerdì

0 17 * * 5  cd ~/work && /usr/local/bin/quire task search "overdue" --mine --json > friday.json

Abbinalo a uno script successivo che pubblica il JSON su un webhook Slack, genera una pagina Notion o te lo invia semplicemente per email. La CLI gestisce il trasporto dei dati; quello che ci colleghi dopo dipende da te.

Convertire un CSV di calendario editoriale in attività

tail -n +2 ./calendar/2026-Q2.csv \
  | while IFS=, read -r publish_date channel title; do
      quire task create "Content_Pipeline" \
        --name "$title" \
        --due "$publish_date" \
        --tag "$channel"
    done

CSV in attività con un solo pipeline. Idempotente se tagghi anche le righe con un identificatore di origine, così puoi fare pulizia se un'esecuzione va storta.

Completare attività tramite ID da un file

cat finished_today.txt | xargs -n 1 quire task complete

Dove finished_today.txt è semplicemente un elenco di ID attività, uno per riga. Utile alle 17 di venerdì quando hai otto cose da chiudere in una volta sola e fare clic su ognuna nel browser sembra una punizione.

Quando Quire CLI non è la scelta giusta

Alcuni compromessi onesti.

• Non usi il terminale. Se cd ti mette a disagio, l'app web di Quire è la superficie giusta. Non c'è nulla che faccia la CLI e che l'app web non faccia; la CLI è semplicemente più veloce per chi vive già in una shell.
• Vuoi che sia l'AI a ragionare. Quando il lavoro è "trova ogni progetto bloccato e dimmi quale escalare", questa è attività adatta all'AI. Collega il server Quire MCP a Claude Code, Codex CLI, ChatGPT o Claude Desktop, e lascia che il modello decida quali strumenti chiamare. La CLI gestisce il trasporto dei dati; MCP si occupa del ragionamento.
• Hai bisogno di un'integrazione server-side completamente gestita. Per i flussi di lavoro che si attivano su webhooks o girano su un servizio che gestisci, la Quire REST API è più solida di una CLI autenticata via OAuth che risiede sul laptop di uno sviluppatore.
• La tua rete blocca i reindirizzamenti OAuth loopback. Alcune VPN aziendali lo fanno. Se quire login si blocca in attesa del reindirizzamento, chiedi all'IT di consentire i callback su 127.0.0.1 prima di arrenderti.

Consigli e buone pratiche

• Usa --json e jq per tutto ciò che vuoi riutilizzare. L'output in testo semplice è comodo da leggere; il JSON è comodo per tutto il resto. La maggior parte dei comandi CLI accetta --json.
• Metti tra virgolette i nomi dei progetti esattamente. "Marketing_Q4" è inequivocabile, "quello del marketing" non è un nome di progetto che la CLI conosce. I nomi dei progetti sono sensibili alle maiuscole.
• Tagga le attività create in blocco. Aggiungere --tag from-cli (o --tag bulk-import-2026-05-11) rende banale trovarle e fare pulizia se un'esecuzione dello script va storta.
• Includi il login OAuth nel tuo script di configurazione per le nuove macchine. Un singolo comando quire login && quire whoami dopo una nuova installazione porta un nuovo laptop a uno stato funzionante in 30 secondi.
• Leggi quire <command> --help. È più breve e più preciso di qualsiasi post di blog. Tutte le opzioni per ogni sottocomando si trovano lì.
• Combina la CLI con il server MCP. Usa la CLI per la metà deterministica (crea, completa, elenca, cerca) e un client AI connesso a MCP per la metà ambigua (classificazione, riepiloghi, pianificazione). Stessi dati, due superfici complementari.

Conclusioni

Il cambiamento interessante del 2026 non è che i client AI possano gestire i progetti. È che le persone che svolgono la maggior parte della gestione dei progetti avevano già uno strumento di cui si fidavano: il terminale. Quire CLI offre loro un punto di accesso di prima classe al proprio spazio di lavoro, senza AI nel percorso a meno che non la vogliano.

Se vivi in un terminale, installalo questa settimana. Integra uno dei flussi di lavoro di esempio qui sopra nella tua routine mattutina o del venerdì. La configurazione richiede cinque minuti. Il rendimento si accumula per tutto il tempo in cui continui a usare Quire.

Il server MCP è ancora lo strumento giusto quando il ragionamento è il lavoro. I due non sono in competizione; sono superfici complementari sullo stesso spazio di lavoro.

Domande frequenti

Cos'è Quire CLI?

Quire CLI è uno strumento a riga di comando standalone per Quire. Installalo tramite npm, Homebrew o un binario, esegui quire login e gestisci attività, progetti e documenti da qualsiasi terminale.

Quire CLI è la stessa cosa del server Quire MCP?

No. Quire CLI è per gli utenti che digitano comandi. Il server Quire MCP è per gli agenti AI che chiamano Quire come strumenti. Stessi dati, pubblico diverso.

Devo essere uno sviluppatore per usare Quire CLI?

No. Se sai aprire un terminale ed eseguire due comandi, puoi usarlo.

Cosa posso fare con Quire CLI?

Elencare e cercare attività, crearle in blocco, completarle, organizzare sub attività, gestire progetti e membri, pubblicare commenti, creare documenti. Ogni oggetto Quire è raggiungibile.

Quando dovrei usare il server MCP invece?

Quando il lavoro richiede ragionamento. Classificazione, riepiloghi, trasformazione di note non strutturate in attività. Quire CLI è per la metà deterministica.

Quire CLI funziona nei cron job?

Sì. Usa l'output --json, pianifica con cron, pubblica i risultati dove ne hai bisogno.

Esiste un piano Free?

Sì. Il Free plan di Quire offre lo stesso accesso alla CLI dei piani a pagamento.

Pronto a gestire il tuo spazio di lavoro Quire dal terminale?

Installa Quire CLI da npm, Homebrew o GitHub Releases. Account Quire Free, accesso completo, nessuna carta di credito.