Быстрый старт

Перед началом

Используйте Node.js 24.5+ или 26.5+ и Yarn 4 (через Corepack: corepack enable; в Node 26 сначала установите его с помощью npm install -g corepack). Установите CLI глобально; ваше приложение сохраняет собственные зависимости SDK.

Сборка приложений Twenty официально поддерживается только в системах Unix (macOS и Linux). В Windows работайте в WSL 2.

Создайте проект

npm install -g twenty
twenty app init my-twenty-app
cd my-twenty-app
yarn install

app init записывает только шаблон. Он не устанавливает зависимости, не инициализирует Git, не запускает Docker, не выполняет аутентификацию и не синхронизирует. Настройте отображаемое имя и описание с помощью --display-name и --description; используйте --path для другого места назначения.

Подключиться к Twenty

Используйте существующее рабочее пространство или запустите локальный сервер, затем войдите в систему:

twenty auth login --url https://your-workspace.twenty.com --name dev

Синхронизируйте изменения

Для первой синхронизации явно разрешите регистрацию и установку:

twenty app apply --create

Затем запустите наблюдатель разработки:

twenty app dev

Используйте ограниченные команды для скриптов и агентов:

twenty app plan
twenty app apply

plan предварительно просматривает изменения. apply однократно загружает и синхронизирует. Используйте --no-prune, чтобы сохранить удалённые сущности, отсутствующие в источнике, или --yes, чтобы разрешить удаление объектов и полей без запроса. Для всех трех команд требуется аутентифицированное удаленное подключение и владение регистрацией.

Что вы можете создать

Приложения состоят из сущностей — каждая определена как файл TypeScript с одним export default:

Сущность	Что делает
Объекты и поля	Пользовательские модели данных (почтовая открытка, счёт и т. д.) с типизированными полями
Логические функции	Серверный TypeScript, запускаемый HTTP-маршрутами, расписаниями cron или событиями базы данных
Фронтенд-компоненты	React-компоненты, которые отображаются внутри интерфейса Twenty (боковая панель, виджеты, командное меню)
Навыки и агенты	Возможности ИИ — многократно используемые инструкции и автономные помощники
Представления и навигация	Предварительно настроенные представления списков и элементы бокового меню
Макеты страниц	Пользовательские страницы сведений о записи с вкладками и виджетами

Полная справка: Концепции.

Разрабатывайте с помощью навыков ИИ-агентов.

Официальные навыки агентов Twenty обучают агентов для программирования полному рабочему процессу приложения: созданию каркаса, разработке сущностей, операциям синхронизации и развертывания, а также публикации на маркетплейсе. Они устанавливаются в Claude Code, Codex, Cursor, Pi и любую другую среду, поддерживаемую CLI skills, и работают с любым экземпляром Twenty, включая самостоятельно размещенные пользовательские домены и localhost.

# List the available skills
npx skills add https://github.com/twentyhq/twenty/tree/agent-skills --list

# Install the scaffolding and development skills
npx skills add https://github.com/twentyhq/twenty/tree/agent-skills --skill create-app
npx skills add https://github.com/twentyhq/twenty/tree/agent-skills --skill develop-app

Каждый навык устанавливается вместе с собственной справочной документацией. Ветка agent-skills становится доступной после первой успешной публикации из main; до этого следуйте инструкциям по локальной сборке.

Следующие шаги

Конфигурация

Идентификатор приложения, роль по умолчанию, установка и удаление хуков, публичные активы.

Данные

Объекты, поля и двунаправленные связи.

Логика

Логические функции, навыки, агенты, подключения и каналы обмена сообщениями.

Макет

просмотра, навигация, макеты страниц, передние компоненты.

Операции

CLI, тестирование, удаление, CI и публикация вашего приложения.

Разработчики

Приложения

API

Самостоятельный хостинг

Внести вклад

Библиотека интерфейса

Перед началом

Создайте проект

Подключиться к Twenty

Синхронизируйте изменения

Что вы можете создать

Разрабатывайте с помощью навыков ИИ-агентов.

Следующие шаги

​Перед началом

​Создайте проект

​Подключиться к Twenty

​Синхронизируйте изменения

​Что вы можете создать

​Разрабатывайте с помощью навыков ИИ-агентов.

​Следующие шаги

Перед началом

Создайте проект

Подключиться к Twenty

Синхронизируйте изменения

Что вы можете создать

Разрабатывайте с помощью навыков ИИ-агентов.

Следующие шаги