Clone Application (zeysdk clone)

Copy an existing application from a remote instance.

zeysdk clone <INSTANCE_ID> <APP_IDENTIFIER> [TARGET_DIRECTORY]

Parameters

Parameter	Description	Required	Default	Example
INSTANCE_ID	Source instance ID	✅	-	dev-instance
APP_IDENTIFIER	Application to clone	✅	-	my-app
TARGET_DIRECTORY	Destination path	❌	Same as APP_IDENTIFIER	apps/my-app

Options

Option	Description
--verbose	Display detailed progress output

Cloning Process

1. Directory Setup

   • If TARGET_DIRECTORY not provided, uses APP_IDENTIFIER as directory name
   • Checks if target directory already exists
   • Creates new directory at specified location

2. App Creation

   • Creates temporary local version of the app
   • Sets up initial scaffolding

3. Instance Linking

   • Links to specified instance
   • Validates connection

4. Data Sync

   • Performs force pull to sync all app data
   • Retrieves complete application state

Error Handling

Error	Description	Resolution
Directory exists	Target directory already exists	Choose different target directory
Creation failed	App creation error	Check app identifier and permissions
Link failed	Instance linking error	Verify instance ID and connectivity
Pull failed	Data sync error	Check network and try again