Prima di iniziare
Usa Node.js 24 (24.5+) o 26 (26.5.1+) e Yarn 4 (tramite Corepack:corepack enable; su Node 26, installalo prima con npm install -g corepack). Installa il CLI a livello globale; la tua app mantiene le proprie dipendenze SDK.
La compilazione delle app Twenty è supportata ufficialmente solo sui sistemi Unix (macOS e Linux). Su Windows, lavora all’interno di WSL 2.
Crea il progetto
app init scrive solo il modello. Non installa dipendenze, non inizializza Git, non avvia Docker, non esegue l’autenticazione e non sincronizza. Personalizza il nome visualizzato e la descrizione con --display-name e --description; usa --path per una destinazione diversa.
Accedi a Twenty
Utilizza uno spazio di lavoro esistente oppure avvia un server locale, quindi accedi:--name dev salva la connessione come dev; --use la imposta come predefinita per i comandi seguenti. Per selezionarla esplicitamente, aggiungi --remote dev. Le variabili d’ambiente possono sovrascrivere l’impostazione predefinita; consulta la selezione dell’area di lavoro.
Sincronizza le modifiche
Per la prima sincronizzazione, consenti esplicitamente la registrazione e l’installazione:plan mostra un’anteprima delle modifiche. apply carica e sincronizza una volta. Usa --no-prune per mantenere le entità remote mancanti dall’origine, oppure --yes per consentire l’eliminazione di oggetti e campi senza una richiesta di conferma. Tutti e tre i comandi richiedono un ambiente remoto autenticato e la proprietà della registrazione.
Cosa puoi creare
Le app sono composte da entità — ciascuna definita come un file TypeScript con un singoloexport default:
Riferimento completo: Concetti.
Sviluppa con le skill degli agenti IA
Le Agent Skills ufficiali di Twenty insegnano agli agenti di coding l’intero flusso di lavoro dell’app: scaffolding, sviluppo delle entità, operazioni di sincronizzazione e distribuzione e pubblicazione sul marketplace. Si installano in Claude Code, Codex, Cursor, Pi e qualsiasi altro harness supportato dalla CLIskills e funzionano con qualsiasi istanza di Twenty, inclusi domini personalizzati self-hosted e localhost.
agent-skills diventa disponibile dopo la prima pubblicazione riuscita da main; prima di allora, segui le istruzioni per la build locale.
Prossimi passaggi
Config
Identità dell’applicazione, ruolo predefinito, installa e disinstalla hook, beni pubblici.
Data
Oggetti, campi e relazioni bidirezionali.
Logica
Funzioni logiche, competenze, agenti, connessioni e canali di messaggistica.
Layout
Visualizzazioni, navigazione, layout delle pagine, componenti anteriori.
Operations
CLI, testing, remotes, CI, and publishing your app.