Riferimento CLI

La CLI di i1n è l'interfaccia principale per la gestione della localizzazione. Installala globalmente con npm i -g i1n.

Tutti i comandi vengono eseguiti nel contesto della directory del progetto corrente, utilizzando la configurazione da i1n.config.json.

Inizializza i1n in un progetto. Esegue una configurazione interattiva che rileva il framework del tuo progetto, imposta il formato e la directory del file di localizzazione, configura la lingua di origine e crea i1n.config.json.

Questo comando deve essere eseguito una sola volta per progetto. Eseguilo di nuovo per riconfigurare le impostazioni.

Carica i file di traduzione locali su i1n. La CLI analizza i tuoi file di localizzazione (ad es. locales/**/*.json) e sincronizza tutte le chiavi con il progetto.

Usa --translate [langs] per attivare la traduzione AI dopo il push. Esempio: i1n push --translate es,fr,de,ja traduce in spagnolo, francese, tedesco e giapponese.

Se una chiave e una lingua sono state modificate su entrambi i lati dall'ultima sincronizzazione (un vero conflitto), la CLI richiede un'azione interattiva: mantenere il valore locale, accettare il valore del server o annullare il push. Le modifiche apportate solo sul server (modifiche effettuate da un altro utente o nella dashboard mentre stavi lavorando) vengono scritte automaticamente nei file locali al momento del push e i1n.d.ts viene rigenerato quando necessario.

Flag disponibili: --translate [langs] attiva la traduzione tramite IA dopo il push (esempio: i1n push --translate es,fr,de,ja); --strategy <mode> imposta la politica di conflitto su interactive (predefinita nel terminale), ours (vince il locale), theirs (vince il server) o abort (interrompe in caso di conflitto). --force è una scorciatoia per --strategy ours e sovrascrive i valori sul server, operazione distruttiva che elimina eventuali modifiche apportate sul server da altri utenti.

Recupera le traduzioni da i1n e scrivi file locali. Recupera tutte le traduzioni, scrive i file di localizzazione nel formato configurato e genera le definizioni dei tipi TypeScript i1n.d.ts.

Esegui questo dopo che le traduzioni sono state completate, o come parte della tua pipeline CI/CD per garantire che i file siano sempre sincronizzati.

Aggiungi interattivamente nuove lingue di destinazione al tuo progetto. Il comando controlla gli slot linguistici disponibili sul tuo piano e consente la riattivazione di lingue precedentemente utilizzate senza consumare nuovi slot.

La disponibilità delle lingue dipende dal tuo piano: Starter supporta 2 lingue, Pro ne supporta 5, Business ne supporta 12 e Enterprise supporta tutte le 182 lingue.

Visualizza i limiti del progetto e l'utilizzo corrente. Mostra le chiavi utilizzate rispetto al limite, i crediti di traduzione AI utilizzati rispetto al limite, gli slot linguistici utilizzati rispetto a quelli disponibili e un elenco delle lingue attive.

Usa questo comando per monitorare i consumi e determinare quando potrebbe essere necessario un upgrade del piano.

Genera regole di contesto per agenti AI per il progetto. Crea file di regole per Cursor (.cursor/rules/i1n.mdc), Claude Code (CLAUDE.md), Windsurf (.windsurfrules), GitHub Copilot (.github/copilot-instructions.md), Codex (AGENTS.md) e Antigravity (.antigravity/rules.md).

Questi file insegnano agli agenti AI a usare chiavi di traduzione invece di stringhe hardcoded, a posizionare le chiavi nei file di namespace corretti, a preservare le variabili di interpolazione ed eseguire i1n push dopo le modifiche.

Avvia un server del Model Context Protocol (MCP) che espone gli strumenti i1n agli assistenti di codifica AI. Ciò consente a Cursor, Claude Code, Windsurf e altri agenti compatibili con MCP di eseguire comandi i1n direttamente — push, pull, traduci, aggiungi lingue e altro ancora — senza lasciare l'IDE.

Il server MCP espone 7 strumenti: i1n_status, i1n_push, i1n_pull, i1n_translate, i1n_add_language, i1n_extract_and_translate e i1n_search. La caratteristica distintiva è i1n_extract_and_translate: il tuo agente AI estrae stringhe hardcoded da un componente, le passa a i1n e vengono istantaneamente inviate, tradotte in tutte le lingue attive e le definizioni di tipo vengono rigenerate. Configuralo con: claude mcp add i1n -- npx i1n mcp.