Merge twenty-cli into twenty-sdk (#16150)

- Moves twenty-cli content into twenty-sdk
- add a new twenty-sdk:0.1.0 version
- this new twenty-sdk exports a cli command called 'twenty' (like
twenty-cli before)
- deprecates twenty-cli
- simplify app init command base-project
- use `twenty-sdk:0.1.0` in base project
- move the "twenty-sdk/application" barrel to "twenty-sdk"
- add `create-twenty-app` package

<img width="1512" height="919" alt="image"
src="https://github.com/user-attachments/assets/007bef45-4e71-419a-9213-cebed376adbf"
/>

<img width="1506" height="929" alt="image"
src="https://github.com/user-attachments/assets/3de2fec6-1624-4923-ae13-f4e1cf165eb5"
/>

packages/create-twenty-app/src/cli.ts

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import chalk from 'chalk';
+import { Command, CommanderError } from 'commander';
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { CreateAppCommand } from './create-app.command';
+
+const packageJson = JSON.parse(
+  readFileSync(join(__dirname, '../package.json'), 'utf-8'),
+);
+
+const program = new Command(packageJson.name)
+  .description('CLI tool to initialize a new Twenty application')
+  .version(
+    packageJson.version,
+    '-v, --version',
+    'Output the current version of create-twenty-app.',
+  )
+  .argument('[directory]')
+  .helpOption('-h, --help', 'Display this help message.')
+  .action(async (directory?: string) => {
+    if (directory && !/^[a-z0-9-]+$/.test(directory)) {
+      console.error(
+        chalk.red(
+          `Invalid directory "${directory}". Must contain only lowercase letters, numbers, and hyphens`,
+        ),
+      );
+      process.exit(1);
+    }
+    await new CreateAppCommand().execute(directory);
+  });
+
+program.exitOverride();
+
+try {
+  program.parse();
+} catch (error) {
+  if (error instanceof CommanderError) {
+    process.exit(error.exitCode);
+  }
+  if (error instanceof Error) {
+    console.error(chalk.red('Error:'), error.message);
+    process.exit(1);
+  }
+}

packages/create-twenty-app/src/create-app.command.ts

@@ -0,0 +1,137 @@
+import chalk from 'chalk';
+import * as fs from 'fs-extra';
+import inquirer from 'inquirer';
+import * as path from 'path';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { copyBaseApplicationProject } from './utils/app-template';
+import kebabCase from 'lodash.kebabcase';
+import { convertToLabel } from './utils/convert-to-label';
+
+const CURRENT_EXECUTION_DIRECTORY = process.env.INIT_CWD || process.cwd();
+
+const execPromise = promisify(exec);
+
+export class CreateAppCommand {
+  async execute(directory?: string): Promise<void> {
+    try {
+      const { appName, appDisplayName, appDirectory, appDescription } =
+        await this.getAppInfos(directory);
+
+      await this.validateDirectory(appDirectory);
+
+      this.logCreationInfo({ appDirectory, appName });
+
+      await fs.ensureDir(appDirectory);
+
+      await copyBaseApplicationProject({
+        appName,
+        appDisplayName,
+        appDescription,
+        appDirectory,
+      });
+
+      try {
+        const result = await execPromise('yarn --version', {
+          cwd: appDirectory,
+        });
+        console.log('Installing dependencies using yarn', result.stdout);
+        await execPromise('yarn', { cwd: appDirectory });
+      } catch (error: any) {
+        console.error(chalk.red('yarn install failed:'), error.stdout);
+        process.exit(1);
+      }
+
+      await this.logSuccess(appDirectory);
+    } catch (error) {
+      console.error(
+        chalk.red('Initialization failed:'),
+        error instanceof Error ? error.message : error,
+      );
+      process.exit(1);
+    }
+  }
+
+  private async getAppInfos(directory?: string): Promise<{
+    appName: string;
+    appDisplayName: string;
+    appDescription: string;
+    appDirectory: string;
+  }> {
+    const { name, displayName, description } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'name',
+        message: 'Application name:',
+        when: () => !directory,
+        default: 'my-awesome-app',
+        validate: (input) => {
+          if (input.length === 0) return 'Application name is required';
+          return true;
+        },
+      },
+      {
+        type: 'input',
+        name: 'displayName',
+        message: 'Application display name:',
+        default: (answers: any) => {
+          return convertToLabel(answers?.name ?? directory);
+        },
+      },
+      {
+        type: 'input',
+        name: 'description',
+        message: 'Application description (optional):',
+        default: '',
+      },
+    ]);
+
+    const computedName = name ?? directory;
+
+    const appName = computedName.trim();
+
+    const appDisplayName = displayName.trim();
+
+    const appDescription = description.trim();
+
+    const appDirectory = directory
+      ? path.join(CURRENT_EXECUTION_DIRECTORY, directory)
+      : path.join(CURRENT_EXECUTION_DIRECTORY, kebabCase(appName));
+
+    return { appName, appDisplayName, appDirectory, appDescription };
+  }
+
+  private async validateDirectory(appDirectory: string): Promise<void> {
+    if (!(await fs.pathExists(appDirectory))) {
+      return;
+    }
+
+    const files = await fs.readdir(appDirectory);
+    if (files.length > 0) {
+      throw new Error(
+        `Directory ${appDirectory} already exists and is not empty`,
+      );
+    }
+  }
+
+  private logCreationInfo({
+    appDirectory,
+    appName,
+  }: {
+    appDirectory: string;
+    appName: string;
+  }): void {
+    console.log(chalk.blue('🎯 Creating Twenty Application'));
+    console.log(chalk.gray(`📁 Directory: ${appDirectory}`));
+    console.log(chalk.gray(`📝 Name: ${appName}`));
+    console.log('');
+  }
+
+  private logSuccess(appDirectory: string): void {
+    console.log(chalk.green('✅ Application created successfully!'));
+    console.log('');
+    console.log(chalk.blue('Next steps:'));
+    console.log(`  cd ${appDirectory.split('/').reverse()[0] ?? ''}`);
+    console.log('  twenty app dev');
+  }
+}

packages/create-twenty-app/src/utils/__tests__/convert-to-label.spec.ts

@@ -0,0 +1,10 @@
+import { convertToLabel } from '../convert-to-label';
+
+describe('convertToLabel', () => {
+  it('should convert to label', () => {
+    expect(convertToLabel('toto')).toBe('Toto');
+    expect(convertToLabel('totoTata')).toBe('Toto tata');
+    expect(convertToLabel('totoTataTiti')).toBe('Toto tata titi');
+    expect(convertToLabel('toto-tata-titi')).toBe('Toto tata titi');
+  });
+});

packages/create-twenty-app/src/utils/app-template.ts

@@ -0,0 +1,176 @@
+import * as fs from 'fs-extra';
+import { join } from 'path';
+import { v4 } from 'uuid';
+
+export const copyBaseApplicationProject = async ({
+  appName,
+  appDisplayName,
+  appDescription,
+  appDirectory,
+}: {
+  appName: string;
+  appDisplayName: string;
+  appDescription: string;
+  appDirectory: string;
+}) => {
+  await createPackageJson({ appName, appDirectory });
+
+  await createYarnLock(appDirectory);
+
+  await createYarnRc(appDirectory);
+
+  await createNvmRc(appDirectory);
+
+  await createTsConfig(appDirectory);
+
+  await createApplicationConfig({
+    displayName: appDisplayName,
+    description: appDescription,
+    appDirectory,
+  });
+
+  await createReadmeContent({
+    displayName: appDisplayName,
+    appDescription,
+    appDirectory,
+  });
+};
+
+const createYarnLock = async (appDirectory: string) => {
+  const yarnLockContent = `# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
+# yarn lockfile v1
+`;
+
+  await fs.writeFile(join(appDirectory, 'yarn.lock'), yarnLockContent);
+};
+
+const createYarnRc = async (appDirectory: string) => {
+  const yarnRcContent = `nodeLinker: node-modules
+`;
+
+  await fs.writeFile(join(appDirectory, '.yarnrc.yml'), yarnRcContent);
+};
+
+const createNvmRc = async (appDirectory: string) => {
+  const nvmRcContent = `24.5.0
+`;
+
+  await fs.writeFile(join(appDirectory, '.nvmrc'), nvmRcContent);
+};
+
+const createTsConfig = async (appDirectory: string) => {
+  const tsConfigJson = {
+    compileOnSave: false,
+    compilerOptions: {
+      sourceMap: true,
+      declaration: true,
+      outDir: './dist',
+      rootDir: '.',
+      moduleResolution: 'node',
+      allowSyntheticDefaultImports: true,
+      emitDecoratorMetadata: true,
+      experimentalDecorators: true,
+      importHelpers: true,
+      allowUnreachableCode: false,
+      strictNullChecks: true,
+      alwaysStrict: true,
+      noImplicitAny: true,
+      strictBindCallApply: false,
+      target: 'es2018',
+      module: 'esnext',
+      lib: ['es2020', 'dom'],
+      skipLibCheck: true,
+      skipDefaultLibCheck: true,
+      resolveJsonModule: true,
+    },
+
+    exclude: ['node_modules', 'dist', '**/*.test.ts', '**/*.spec.ts'],
+  };
+
+  await fs.writeFile(
+    join(appDirectory, 'tsconfig.json'),
+    JSON.stringify(tsConfigJson, null, 2),
+    'utf8',
+  );
+};
+
+const createApplicationConfig = async ({
+  displayName,
+  description,
+  appDirectory,
+}: {
+  displayName: string;
+  description?: string;
+  appDirectory: string;
+}) => {
+  const content = `import { type ApplicationConfig } from 'twenty-sdk';
+
+const config: ApplicationConfig = {
+  universalIdentifier: '${v4()}',
+  displayName: '${displayName}',
+  description: '${description ?? ''}',
+};
+
+export default config;
+`;
+
+  await fs.writeFile(join(appDirectory, 'application.config.ts'), content);
+};
+
+const createPackageJson = async ({
+  appName,
+  appDirectory,
+}: {
+  appName: string;
+  appDirectory: string;
+}) => {
+  const packageJson = {
+    name: appName,
+    version: '0.0.1',
+    license: 'MIT',
+    engines: {
+      node: '^24.5.0',
+      npm: 'please-use-yarn',
+      yarn: '>=4.0.2',
+    },
+    packageManager: 'yarn@4.9.2',
+    scripts: {
+      'create-entity': 'twenty app add',
+      dev: 'twenty app dev',
+      generate: 'twenty app generate',
+      sync: 'twenty app sync',
+      uninstall: 'twenty app uninstall',
+      auth: 'twenty auth login',
+    },
+    dependencies: {
+      'twenty-sdk': '0.1.0',
+    },
+    devDependencies: {
+      '@types/node': '^24.7.2',
+      typescript: '^5.9.3',
+    },
+  };
+
+  await fs.writeFile(
+    join(appDirectory, 'package.json'),
+    JSON.stringify(packageJson, null, 2),
+    'utf8',
+  );
+};
+
+const createReadmeContent = async ({
+  displayName,
+  appDescription,
+  appDirectory,
+}: {
+  displayName: string;
+  appDescription: string;
+  appDirectory: string;
+}) => {
+  const readmeContent = `# ${displayName}
+
+${appDescription}
+`;
+
+  await fs.writeFile(join(appDirectory, 'README.md'), readmeContent);
+};

packages/create-twenty-app/src/utils/convert-to-label.ts

@@ -0,0 +1,6 @@
+import { startCase } from 'lodash';
+
+export const convertToLabel = (str: string) => {
+  const s = startCase(str).toLowerCase();
+  return s.charAt(0).toUpperCase() + s.slice(1);
+};