create-app

Scaffolds new Twenty apps with authentication and initial sync to a Twenty instance.

Updated Aug 3, 2026
One-click install
npx skills add https://github.com/masoodtalha/twenty --skill create-app-masoodtalha
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-app
Source: https://github.com/masoodtalha/twenty/tree/main/packages/twenty-codex-plugin/skills/create-app
Command: npx skills add https://github.com/masoodtalha/twenty --skill create-app-masoodtalha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new Twenty app requires setting up a project, authenticating against a Twenty instance, and syncing entities before any development can begin. This Skill guides the AI through scaffolding a new Twenty app correctly, including choosing the target instance and avoiding common post-scaffold mistakes. ## Core Features & Use Cases - Guided Scaffolding: Runs npx create-twenty-app@latest with the correct flags for app name, display name, description, and instance URL. - Instance Selection: Connects to an existing Twenty instance via OAuth by default, or falls back to a disposable local Docker instance on http://localhost:2020. - Post-Scaffold Guardrails: Prevents redundant validation runs and directs follow-up work to the appropriate development or management workflows. - Use Case: A developer says "scaffold a new Twenty app called deal-tracker" and the Skill confirms the app shape, asks for the instance URL, runs the scaffolder, and reports the app is synced and ready. ## Quick Start Ask the AI to scaffold a new Twenty app with your chosen name and the URL of your Twenty instance.

Frequently Asked Questions about create-app

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new Twenty app from scratch?▼

Run npx create-twenty-app@latest with your app name and the --url flag pointing to your Twenty instance. The scaffolder creates the project, installs dependencies, authenticates via OAuth, and performs an initial sync.

Do I need a Twenty instance to scaffold a Twenty app?▼

Yes, a Twenty app extends a running Twenty instance and must sync to one during development. You can provide an existing instance URL, or use the Docker fallback which starts a disposable local server on http://localhost:2020.

Can I scaffold a Twenty app without Docker?▼

Yes, pass the --url flag with an existing Twenty instance URL, such as https://app.twenty.com or a self-hosted server. This authenticates via OAuth and skips Docker entirely.

What options does create-twenty-app support?▼

Supported create-time options are --name, --display-name, --description, --url, and --authentication-method. The app directory name must contain only lowercase letters, numbers, and hyphens.

Why does the Docker fallback fail when scaffolding?▼

The Docker fallback fails when Docker Desktop is not installed or not running. Either install Docker Desktop, or rerun the scaffolder with --url pointing to an existing Twenty instance to skip Docker.

Should I run tests or sync after scaffolding a Twenty app?▼

No, the scaffolder already performs the initial sync, so follow-up validation commands are unnecessary. Run tests later only when developing features, using the isolated test instance at TWENTY_API_URL=http://localhost:2021.