Skip to Content
CLI referencegensx new

gensx new

The gensx new command creates a new GenSX project with a predefined structure and dependencies.

Usage

gensx new <project-directory> [options]

Arguments

ArgumentDescription
<project-directory>Directory to create the project in. If it doesn’t exist, it will be created.

Options

OptionDescription
-t, --template <type>Template to use. Currently supports ts (TypeScript).
-f, --forceOverwrite existing files in the target directory.
--skip-ide-rulesSkip IDE rules selection.
--ide-rules <rules>Comma-separated list of IDE rules to install. Options: cline, windsurf, claude, cursor.
-d, --description <desc>Optional project description.
-h, --helpDisplay help for the command.

Description

This command scaffolds a new GenSX project with the necessary files and folder structure. It sets up:

  • Project configuration files (package.json, tsconfig.json)
  • Basic project structure with example workflows
  • Development dependencies
  • IDE integrations based on selected rules

Examples

# Create a basic project gensx new my-gensx-app # Create a project with a specific template and description gensx new my-gensx-app --template ts --description "My AI workflow app" # Create a project with specific IDE rules gensx new my-gensx-app --ide-rules cursor,claude # Force create even if directory has existing files gensx new my-gensx-app --force

Notes

  • If no template is specified, ts (TypeScript) is used by default.
  • The command will install all required dependencies, so make sure you have npm installed.
  • After creation, you can navigate to the project directory and start the development server with gensx start.
Last updated on