Update twenty sdk commands (#20735)

Performs twenty-sdk cli command migration: Summary ``` ┌─────┬──────────────────────────┬────────────────────────────┬───────────────────────┐ │ # │ Old command │ New command │ Status │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 1 │ twenty dev [appPath] │ twenty dev [appPath] │ Unchanged (now also │ │ │ │ │ DEFAULT) │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 2 │ twenty dev --once │ twenty dev --once │ Unchanged │ │ │ [appPath] │ [appPath] │ │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 3 │ twenty dev --watch │ twenty dev [appPath] │ --watch flag removed │ │ │ [appPath] │ │ (was default) │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 4 │ twenty dev --verbose │ twenty dev --verbose │ Unchanged │ │ │ [appPath] │ [appPath] │ │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 5 │ twenty dev --debug │ twenty dev --debug │ Unchanged │ │ │ [appPath] │ [appPath] │ │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 6 │ twenty dev --debounceMs │ twenty dev --debounceMs │ Unchanged │ │ │ <ms> [appPath] │ <ms> [appPath] │ │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 7 │ twenty build [appPath] │ twenty dev:build [appPath] │ Deprecated → colon │ │ │ │ │ command │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 8 │ twenty build --tarball │ twenty dev:build --tarball │ Deprecated → colon │ │ │ [appPath] │ [appPath] │ command │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 9 │ twenty typecheck │ twenty dev:typecheck │ Deprecated → colon │ │ │ [appPath] │ [appPath] │ command │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 10 │ twenty logs [appPath] │ twenty dev:fn-logs │ Deprecated → colon │ │ │ │ [appPath] │ command │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 11 │ twenty logs -n <name> │ twenty dev:fn-logs -n │ Deprecated → colon │ │ │ [appPath] │ <name> [appPath] │ command │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 12 │ twenty logs -u <id> │ twenty dev:fn-logs -u <id> │ Deprecated → colon │ │ │ [appPath] │ [appPath] │ command │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 13 │ twenty exec [appPath] │ twenty dev:fn-exec │ Deprecated → colon │ │ │ │ [appPath] │ command │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 14 │ twenty exec -n <name> │ twenty dev:fn-exec -n │ Deprecated → colon │ │ │ [appPath] │ <name> [appPath] │ command │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 15 │ twenty exec -u <id> │ twenty dev:fn-exec -u <id> │ Deprecated → colon │ │ │ [appPath] │ [appPath] │ command │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 16 │ twenty exec -p <json> │ twenty dev:fn-exec -p │ Deprecated → colon │ │ │ [appPath] │ <json> [appPath] │ command │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 17 │ twenty exec │ twenty dev:fn-exec │ Deprecated → colon │ │ │ --postInstall [appPath] │ --postInstall [appPath] │ command │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 18 │ twenty exec --preInstall │ twenty dev:fn-exec │ Deprecated → colon │ │ │ [appPath] │ --preInstall [appPath] │ command │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 19 │ twenty add [entityType] │ twenty dev:add │ Deprecated → colon │ │ │ │ [entityType] │ command │ ├─────┼──────────────────────────┼────────────────────────────┼───────────────────────┤ │ 20 │ twenty add --path <path> │ twenty dev:add --path │ Deprecated → colon │ │ │ [entityType] │ <path> [entityType] │ command │ └─────┴──────────────────────────┴────────────────────────────┴───────────────────────┘ App lifecycle commands ┌─────┬────────────────────────┬────────────────────────────┬─────────────────────────┐ │ # │ Old command │ New command │ Status │ ├─────┼────────────────────────┼────────────────────────────┼─────────────────────────┤ │ 21 │ twenty publish │ twenty app:publish │ Deprecated → colon │ │ │ [appPath] │ [appPath] │ command │ ├─────┼────────────────────────┼────────────────────────────┼─────────────────────────┤ │ 22 │ twenty publish --tag │ twenty app:publish --tag │ Deprecated → colon │ │ │ <tag> [appPath] │ <tag> [appPath] │ command │ ├─────┼────────────────────────┼────────────────────────────┼─────────────────────────┤ │ 23 │ twenty deploy │ twenty app:publish │ Deprecated → colon │ │ │ [appPath] │ --private [appPath] │ command + --private │ ├─────┼────────────────────────┼────────────────────────────┼─────────────────────────┤ │ 24 │ twenty install │ twenty app:install │ Deprecated → colon │ │ │ [appPath] │ [appPath] │ command │ ├─────┼────────────────────────┼────────────────────────────┼─────────────────────────┤ │ 25 │ twenty uninstall │ twenty app:uninstall │ Deprecated → colon │ │ │ [appPath] │ [appPath] │ command │ ├─────┼────────────────────────┼────────────────────────────┼─────────────────────────┤ │ 26 │ twenty uninstall -y │ twenty app:uninstall -y │ Deprecated → colon │ │ │ [appPath] │ [appPath] │ command │ └─────┴────────────────────────┴────────────────────────────┴─────────────────────────┘ Server commands ┌─────┬─────────────────────────┬─────────────────────────────┬──────────────────────┐ │ # │ Old command │ New command │ Status │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 27 │ twenty server start │ twenty docker:start │ Deprecated → colon │ │ │ │ │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 28 │ twenty server start -p │ twenty docker:start -p │ Deprecated → colon │ │ │ <port> │ <port> │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 29 │ twenty server start │ twenty docker:start --test │ Deprecated → colon │ │ │ --test │ │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 30 │ twenty server stop │ twenty docker:stop │ Deprecated → colon │ │ │ │ │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 31 │ twenty server stop │ twenty docker:stop --test │ Deprecated → colon │ │ │ --test │ │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 32 │ twenty server status │ twenty docker:status │ Deprecated → colon │ │ │ │ │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 33 │ twenty server status │ twenty docker:status --test │ Deprecated → colon │ │ │ --test │ │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 34 │ twenty server logs │ twenty docker:logs │ Deprecated → colon │ │ │ │ │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 35 │ twenty server logs -n │ twenty docker:logs -n │ Deprecated → colon │ │ │ <lines> │ <lines> │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 36 │ twenty server logs │ twenty docker:logs --test │ Deprecated → colon │ │ │ --test │ │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 37 │ twenty server reset │ twenty docker:reset │ Deprecated → colon │ │ │ │ │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 38 │ twenty server reset │ twenty docker:reset --test │ Deprecated → colon │ │ │ --test │ │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 39 │ twenty server upgrade │ twenty docker:upgrade │ Deprecated → colon │ │ │ [version] │ [version] │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 40 │ twenty server upgrade │ twenty docker:upgrade │ Deprecated → colon │ │ │ --test [version] │ --test [version] │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 41 │ twenty server │ twenty app:catalog-sync │ Deprecated → colon │ │ │ catalog-sync │ │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 42 │ twenty server │ twenty app:catalog-sync │ Deprecated → colon │ │ │ catalog-sync -r <name> │ -r <name> │ syntax │ ├─────┼─────────────────────────┼─────────────────────────────┼──────────────────────┤ │ 43 │ twenty catalog-sync │ (removed) │ Removed (was already │ │ │ │ │ deprecated) │ └─────┴─────────────────────────┴─────────────────────────────┴──────────────────────┘ Remote commands ┌─────┬────────────────────────┬──────────────────────────┬──────────────────────────┐ │ # │ Old command │ New command │ Status │ ├─────┼────────────────────────┼──────────────────────────┼──────────────────────────┤ │ 44 │ twenty remote add │ twenty remote:add │ Deprecated → colon │ │ │ │ │ syntax │ ├─────┼────────────────────────┼──────────────────────────┼──────────────────────────┤ │ 45 │ twenty remote add --as │ twenty remote:add --as │ Deprecated → colon │ │ │ <name> │ <name> │ syntax │ ├─────┼────────────────────────┼──────────────────────────┼──────────────────────────┤ │ 46 │ twenty remote add │ twenty remote:add │ Deprecated → colon │ │ │ --api-key <key> │ --api-key <key> │ syntax │ ├─────┼────────────────────────┼──────────────────────────┼──────────────────────────┤ │ 47 │ twenty remote add │ twenty remote:add │ Deprecated → colon │ │ │ --api-url <url> │ --api-url <url> │ syntax │ ├─────┼────────────────────────┼──────────────────────────┼──────────────────────────┤ │ 48 │ twenty remote add │ twenty remote:add │ Deprecated → colon │ │ │ --local │ --local │ syntax │ ├─────┼────────────────────────┼──────────────────────────┼──────────────────────────┤ │ 49 │ twenty remote add │ twenty remote:add --test │ Deprecated → colon │ │ │ --test │ │ syntax │ ├─────┼────────────────────────┼──────────────────────────┼──────────────────────────┤ │ 50 │ twenty remote list │ twenty remote:list │ Deprecated → colon │ │ │ │ │ syntax │ ├─────┼────────────────────────┼──────────────────────────┼──────────────────────────┤ │ 51 │ twenty remote switch │ twenty remote:use [name] │ Deprecated → colon │ │ │ [name] │ │ syntax + renamed │ ├─────┼────────────────────────┼──────────────────────────┼──────────────────────────┤ │ 52 │ twenty remote status │ twenty remote:status │ Deprecated → colon │ │ │ │ │ syntax │ ├─────┼────────────────────────┼──────────────────────────┼──────────────────────────┤ │ 53 │ twenty remote remove │ twenty remote:remove │ Deprecated → colon │ │ │ <name> │ <name> │ syntax │ └─────┴────────────────────────┴──────────────────────────┴──────────────────────────┘ ``` --------- Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
2026-05-20 17:12:39 +02:00
parent 6e5e7963b5
commit 237a943947
73 changed files with 1364 additions and 1002 deletions
@@ -18,11 +18,8 @@ const program = new Command(packageJson.name)
  .option('-n, --name <name>', 'Application name')
  .option('-d, --display-name <displayName>', 'Application display name')
  .option('--description <description>', 'Application description')
-  .option(
-    '--workspace-url <workspaceUrl>',
-    'Twenty workspace URL (default: http://localhost:2020)',
-  )
-  .option('--api-url <apiUrl>', '[deprecated: use --workspace-url]')
+  .option('--url <url>', 'Twenty server URL (default: http://localhost:2020)')
+  .option('--api-url <apiUrl>', '[deprecated: use --url]')
  .option(
    '--authentication-method <method>',
    'Authentication method: oauth or apiKey (default: apiKey for local, oauth for remote)',
@@ -35,7 +32,7 @@ const program = new Command(packageJson.name)
        name?: string;
        displayName?: string;
        description?: string;
-        workspaceUrl?: string;
+        url?: string;
        apiUrl?: string;
        authenticationMethod?: AuthenticationMethod;
      },
@@ -68,23 +65,18 @@ const program = new Command(packageJson.name)

      if (options?.apiUrl) {
        console.warn(
-          chalk.yellow(
-            'Warning: --api-url is deprecated. Use --workspace-url instead.',
-          ),
+          chalk.yellow('Warning: --api-url is deprecated. Use --url instead.'),
        );
      }

-      const workspaceUrl = (options?.workspaceUrl ?? options?.apiUrl)?.replace(
-        /\/+$/,
-        '',
-      );
+      const serverUrl = (options?.url ?? options?.apiUrl)?.replace(/\/+$/, '');

      await new CreateAppCommand().execute({
        directory,
        name: options?.name,
        displayName: options?.displayName,
        description: options?.description,
-        workspaceUrl,
+        serverUrl,
        authenticationMethod: options?.authenticationMethod,
      });
    },
@@ -49,19 +49,19 @@

 ## Best practice

-It's highly recommended to create new app entities using `yarn twenty add`. These are the options:
+It's highly recommended to create new app entities using `yarn twenty dev:add`. These are the options:

-| Entity type          | Command                              | Generated file                        |
-| -------------------- | ------------------------------------ | ------------------------------------- |
-| Object               | `yarn twenty add object`             | `src/objects/<name>.ts`               |
-| Field                | `yarn twenty add field`              | `src/fields/<name>.ts`                |
-| Logic function       | `yarn twenty add logicFunction`      | `src/logic-functions/<name>.ts`       |
-| Front component      | `yarn twenty add frontComponent`     | `src/front-components/<name>.tsx`     |
-| Role                 | `yarn twenty add role`               | `src/roles/<name>.ts`                 |
-| Skill                | `yarn twenty add skill`              | `src/skills/<name>.ts`                |
-| Agent                | `yarn twenty add agent`              | `src/agents/<name>.ts`                |
-| View                 | `yarn twenty add view`               | `src/views/<name>.ts`                 |
-| Navigation menu item | `yarn twenty add navigationMenuItem` | `src/navigation-menu-items/<name>.ts` |
-| Page layout          | `yarn twenty add pageLayout`         | `src/page-layouts/<name>.ts`          |
+| Entity type          | Command                                  | Generated file                        |
+| -------------------- | ---------------------------------------- | ------------------------------------- |
+| Object               | `yarn twenty dev:add object`             | `src/objects/<name>.ts`               |
+| Field                | `yarn twenty dev:add field`              | `src/fields/<name>.ts`                |
+| Logic function       | `yarn twenty dev:add logicFunction`      | `src/logic-functions/<name>.ts`       |
+| Front component      | `yarn twenty dev:add frontComponent`     | `src/front-components/<name>.tsx`     |
+| Role                 | `yarn twenty dev:add role`               | `src/roles/<name>.ts`                 |
+| Skill                | `yarn twenty dev:add skill`              | `src/skills/<name>.ts`                |
+| Agent                | `yarn twenty dev:add agent`              | `src/agents/<name>.ts`                |
+| View                 | `yarn twenty dev:add view`               | `src/views/<name>.ts`                 |
+| Navigation menu item | `yarn twenty dev:add navigationMenuItem` | `src/navigation-menu-items/<name>.ts` |
+| Page layout          | `yarn twenty dev:add pageLayout`         | `src/page-layouts/<name>.ts`          |

 This helps automatically generate required IDs etc.
@@ -11,8 +11,8 @@ Run `yarn twenty help` to list all available commands.
 ## Useful Commands

 - `yarn twenty dev` - Start the development server and sync your app
- `yarn twenty server status` - Check the local Twenty server status
- `yarn twenty server start` - Start the local Twenty server
+- `yarn twenty docker:status` - Check the local Twenty server status
+- `yarn twenty docker:start` - Start the local Twenty server
 - `yarn test` - Run integration tests

 ## Learn More
@@ -14,7 +14,7 @@ function validateEnv(): { apiUrl: string; apiKey: string } {
  if (!apiUrl || !apiKey) {
    throw new Error(
      'TWENTY_API_URL and TWENTY_API_KEY must be set.\n' +
-        'Start a local server: yarn twenty server start\n' +
+        'Start a local server: yarn twenty docker:start\n' +
        'Or set them in vitest env config.',
    );
  }
@@ -33,7 +33,7 @@ type CreateAppOptions = {
  name?: string;
  displayName?: string;
  description?: string;
-  workspaceUrl?: string;
+  serverUrl?: string;
  authenticationMethod?: AuthenticationMethod;
 };

@@ -45,9 +45,9 @@ export class CreateAppCommand {
    const { appName, appDisplayName, appDirectory, appDescription } =
      this.getAppInfos(options);

-    const workspaceUrl = options.workspaceUrl ?? DEV_API_URL;
+    const serverUrl = options.serverUrl ?? DEV_API_URL;

-    const skipLocalInstance = workspaceUrl !== DEV_API_URL;
+    const skipLocalInstance = serverUrl !== DEV_API_URL;

    if (!skipLocalInstance && !isDockerInstalled()) {
      console.log(chalk.yellow('\n' + getDockerInstallInstructions() + '\n'));
@@ -118,7 +118,7 @@ export class CreateAppCommand {
      console.log('');

      let authSucceeded = false;
-      let resolvedWorkspaceUrl = workspaceUrl;
+      let resolvedServerUrl = serverUrl;
      let serverReady = skipLocalInstance;

      if (!skipLocalInstance) {
@@ -126,7 +126,7 @@ export class CreateAppCommand {
        const serverResult = await this.ensureDockerServer(dockerPullPromise);

        if (isDefined(serverResult.url)) {
-          resolvedWorkspaceUrl = serverResult.url;
+          resolvedServerUrl = serverResult.url;
          serverReady = true;
        }
      }
@@ -134,18 +134,16 @@ export class CreateAppCommand {
      if (serverReady) {
        this.logNextStep('Authenticating');

-        authSucceeded = await this.tryExistingAuth(resolvedWorkspaceUrl);
+        authSucceeded = await this.tryExistingAuth(resolvedServerUrl);

        if (authSucceeded) {
          this.logDetail('Reusing existing credentials');
        } else if (authenticationMethod === 'oauth') {
          this.logDetail('Starting OAuth flow');
-          authSucceeded =
-            await this.authenticateWithOAuth(resolvedWorkspaceUrl);
+          authSucceeded = await this.authenticateWithOAuth(resolvedServerUrl);
        } else {
          this.logDetail('Using development API key');
-          authSucceeded =
-            await this.authenticateWithDevKey(resolvedWorkspaceUrl);
+          authSucceeded = await this.authenticateWithDevKey(resolvedServerUrl);
        }
      }

@@ -165,10 +163,10 @@ export class CreateAppCommand {
      }

      if (syncSucceeded) {
-        await this.openMainPage(appDirectory, resolvedWorkspaceUrl);
+        await this.openMainPage(appDirectory, resolvedServerUrl);
      }

-      this.logSuccess(appDirectory, resolvedWorkspaceUrl, authSucceeded);
+      this.logSuccess(appDirectory, resolvedServerUrl, authSucceeded);
    } catch (error) {
      console.error(
        chalk.red('\nCreate application failed:'),
@@ -315,7 +313,7 @@ export class CreateAppCommand {

  private async openMainPage(
    appDirectory: string,
-    workspaceUrl: string,
+    serverUrl: string,
  ): Promise<void> {
    try {
      const configService = new ConfigService();
@@ -328,7 +326,7 @@ export class CreateAppCommand {

      const [universalIdentifier, frontUrl] = await Promise.all([
        this.readMainPageLayoutUniversalIdentifier(appDirectory),
-        this.resolveWorkspaceFrontUrl(workspaceUrl, token),
+        this.resolveWorkspaceFrontUrl(serverUrl, token),
      ]);

      if (!universalIdentifier || !frontUrl) {
@@ -336,7 +334,7 @@ export class CreateAppCommand {
      }

      const pageLayoutId = await this.resolvePageLayoutId(
-        workspaceUrl,
+        serverUrl,
        universalIdentifier,
        token,
      );
@@ -355,12 +353,12 @@ export class CreateAppCommand {
  }

  private async resolveWorkspaceFrontUrl(
-    workspaceUrl: string,
+    serverUrl: string,
    token: string,
  ): Promise<string | null> {
    const query = `{ currentWorkspace { workspaceUrls { subdomainUrl customUrl } } }`;

-    const response = await fetch(`${workspaceUrl}/metadata`, {
+    const response = await fetch(`${serverUrl}/metadata`, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
@@ -410,13 +408,13 @@ export class CreateAppCommand {
  }

  private async resolvePageLayoutId(
-    workspaceUrl: string,
+    serverUrl: string,
    universalIdentifier: string,
    token: string,
  ): Promise<string | null> {
    const query = `{ getPageLayouts { id universalIdentifier } }`;

-    const response = await fetch(`${workspaceUrl}/metadata`, {
+    const response = await fetch(`${serverUrl}/metadata`, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
@@ -503,7 +501,7 @@ export class CreateAppCommand {
    });
  }

-  private async tryExistingAuth(workspaceUrl: string): Promise<boolean> {
+  private async tryExistingAuth(serverUrl: string): Promise<boolean> {
    try {
      const configService = new ConfigService();
      const remoteNames = await configService.getRemotes();
@@ -511,7 +509,7 @@ export class CreateAppCommand {
      for (const remoteName of remoteNames) {
        const remoteConfig = await configService.getConfigForRemote(remoteName);

-        if (remoteConfig.apiUrl !== workspaceUrl) {
+        if (remoteConfig.apiUrl !== serverUrl) {
          continue;
        }

@@ -521,7 +519,7 @@ export class CreateAppCommand {
          continue;
        }

-        const response = await fetch(`${workspaceUrl}/metadata`, {
+        const response = await fetch(`${serverUrl}/metadata`, {
          method: 'POST',
          headers: {
            'Content-Type': 'application/json',
@@ -555,11 +553,11 @@ export class CreateAppCommand {
    }
  }

-  private async authenticateWithDevKey(workspaceUrl: string): Promise<boolean> {
+  private async authenticateWithDevKey(serverUrl: string): Promise<boolean> {
    try {
      const result = await authLogin({
        apiKey: DEV_API_KEY,
-        apiUrl: workspaceUrl,
+        apiUrl: serverUrl,
        remote: 'local',
      });

@@ -574,7 +572,7 @@ export class CreateAppCommand {

      console.log(
        chalk.yellow(
-          '  Authentication failed. Run `yarn twenty remote add --local` manually.',
+          '  Authentication failed. Run `yarn twenty remote:add --local` manually.',
        ),
      );

@@ -582,7 +580,7 @@ export class CreateAppCommand {
    } catch {
      console.log(
        chalk.yellow(
-          '  Authentication failed. Run `yarn twenty remote add --local` manually.',
+          '  Authentication failed. Run `yarn twenty remote:add --local` manually.',
        ),
      );

@@ -598,21 +596,21 @@ export class CreateAppCommand {
    }
  }

-  private async authenticateWithOAuth(workspaceUrl: string): Promise<boolean> {
+  private async authenticateWithOAuth(serverUrl: string): Promise<boolean> {
    try {
-      const remoteName = this.deriveRemoteName(workspaceUrl);
+      const remoteName = this.deriveRemoteName(serverUrl);

      ConfigService.setActiveRemote(remoteName);

      this.logDetail('Opening browser for OAuth...');

-      const result = await authLoginOAuth({ apiUrl: workspaceUrl });
+      const result = await authLoginOAuth({ apiUrl: serverUrl });

      if (result.success) {
        const configService = new ConfigService();

        await configService.setDefaultRemote(remoteName);
-        this.logDetail(`Authenticated via OAuth to ${workspaceUrl}`);
+        this.logDetail(`Authenticated via OAuth to ${serverUrl}`);

        return true;
      }
@@ -620,7 +618,7 @@ export class CreateAppCommand {
      console.log(
        chalk.yellow(
          `  OAuth failed: ${result.error.message}\n` +
-            `  Run \`yarn twenty remote add --api-url ${workspaceUrl}\` manually.`,
+            `  Run \`yarn twenty remote:add --url ${serverUrl}\` manually.`,
        ),
      );

@@ -628,7 +626,7 @@ export class CreateAppCommand {
    } catch {
      console.log(
        chalk.yellow(
-          `  Authentication failed. Run \`yarn twenty remote add --api-url ${workspaceUrl}\` manually.`,
+          `  Authentication failed. Run \`yarn twenty remote:add --url ${serverUrl}\` manually.`,
        ),
      );

@@ -638,7 +636,7 @@ export class CreateAppCommand {

  private logSuccess(
    appDirectory: string,
-    workspaceUrl: string,
+    serverUrl: string,
    authSucceeded: boolean,
  ): void {
    const dirName = basename(appDirectory);
@@ -656,9 +654,7 @@ export class CreateAppCommand {
    if (!authSucceeded) {
      console.log(chalk.white(`  ${stepNumber}. Connect to a Twenty instance`));
      console.log(
-        chalk.cyan(
-          '     yarn twenty remote add --api-url <your-instance-url>\n',
-        ),
+        chalk.cyan('     yarn twenty remote:add --url <your-instance-url>\n'),
      );
      stepNumber++;
    }
@@ -668,7 +664,7 @@ export class CreateAppCommand {
    stepNumber++;

    console.log(chalk.white(`  ${stepNumber}. Open your twenty instance`));
-    console.log(chalk.cyan(`     ${workspaceUrl}\n`));
+    console.log(chalk.cyan(`     ${serverUrl}\n`));

    console.log(
      chalk.gray(
@@ -28,6 +28,6 @@ export const getDockerInstallInstructions = (): string => {
    '  Then run this command again.',
    '',
    '  Alternatively, connect to an existing Twenty instance:',
-    '  npx create-twenty-app@latest my-twenty-app --workspace-url <your-instance-url>',
+    '  npx create-twenty-app@latest my-twenty-app --url <your-instance-url>',
  ].join('\n');
 };