Antes de empezar
Use Node.js 24 (24.5+) o 26 (26.5.1+) y Yarn 4 (mediante Corepack:corepack enable; en Node 26, instálelo primero con npm install -g corepack). Instala la CLI globalmente; tu aplicación conserva sus propias dependencias del SDK.
La compilación de aplicaciones Twenty solo es compatible oficialmente con sistemas Unix (macOS y Linux). En Windows, trabaja dentro de WSL 2.
Crea el proyecto
app init solo escribe la plantilla. No instala dependencias, inicializa Git, inicia Docker, autentica ni sincroniza. Personaliza el nombre para mostrar y la descripción con --display-name y --description; usa --path para un destino diferente.
Conéctate a Twenty
Usa un espacio de trabajo existente o inicia un servidor local y, a continuación, inicia sesión:--name dev guarda la conexión como dev; --use la establece como predeterminada para los comandos siguientes. Para dirigirse a ella explícitamente, agregue --remote dev. Las variables de entorno pueden anular el valor predeterminado; consulte la selección del espacio de trabajo.
Sincroniza tus cambios
Para la primera sincronización, permite explícitamente el registro y la instalación:plan previsualiza los cambios. apply carga y sincroniza una vez. Usa --no-prune para conservar las entidades remotas que faltan en el origen, o --yes para permitir eliminaciones de objetos y campos sin confirmación. Los tres comandos requieren un remoto autenticado y la propiedad del registro.
Lo que puedes crear
Las apps se componen de entidades — cada una definida como un archivo de TypeScript con un únicoexport default:
Referencia completa: Conceptos.
Construye con habilidades para agentes de IA.
Las habilidades para agentes oficiales de Twenty enseñan a los agentes de programación todo el flujo de trabajo de la aplicación: generación de estructura, desarrollo de entidades, operaciones de sincronización y despliegue, y publicación en el marketplace. Se instalan en Claude Code, Codex, Cursor, Pi y cualquier otro entorno compatible con la CLIskills, y funcionan con cualquier instancia de Twenty, incluidos dominios personalizados autoalojados y localhost.
agent-skills está disponible después de la primera publicación correcta desde main; antes de eso, sigue las instrucciones de compilación local.
Próximos pasos
Configurar
identidad de la aplicación, rol predeterminado, instalar y desinstalar ganchos, activos públicos.
datos
Objetos, campos y relaciones bidireccionales.
Lógica
Funciones lógicas, habilidades, agentes, conexiones y canales de mensajería.
Diseño
Visualizaciones, navegación, diseños de páginas, componentes frontales.
Operaciones
CLI, prueba, remotos, CI y publica tu aplicación.