Debugging (zeysdk run)

Execute a script asset on the ZeyOS platform and display execution results.

zeysdk run <ASSET_CLASS>/<FILENAME> [options]

Parameters

Parameter	Description	Required	Example
ASSET_CLASS	Asset type (services, resources, weblets)	✅	services
FILENAME	Script file to execute	✅	daily-backup.ixml

Options

Option	Description	Default
--verbose	Show detailed execution progress	false
Execution Results

The command outputs detailed execution metrics:

Execution Results:
LOAD TIME: 1.2 ms
EXECUTION TIME: 45.3 ms
MEMORY USAGE: 2.5 MB
OUTPUT SIZE: 128 KB
ENGINE: iXML
OUTPUT: Operation completed successfully
DEBUG OUTPUT: Detailed execution trace...

Metric	Description	Format
LOAD TIME	Script loading duration	milliseconds/seconds
EXECUTION TIME	Processing duration	milliseconds/seconds
MEMORY USAGE	Peak memory consumption	Bytes/KB/MB/GB
OUTPUT SIZE	Result data size	Bytes/KB/MB/GB
ENGINE	Execution engine version	String
OUTPUT	Script execution result	String
DEBUG OUTPUT	Debug information	String
ERROR	Error message (if failed)	String

Examples

# Run a service script
zeysdk run services/backup.ixml --verbose
# Output:
# Input validation completed.
# Loading sync info and package info.
# Making REST call to run file on the server.
# Run completed successfully.
# Execution Results:
# LOAD TIME: 0.8 ms
# EXECUTION TIME: 123.4 ms
# MEMORY USAGE: 1.2 MB
# OUTPUT: Backup completed successfully

# Run a weblet script
zeysdk run weblets/dashboard.zymba
# Output:
# Execution Results:
# LOAD TIME: 1.1 ms
# EXECUTION TIME: 67.2 ms
# MEMORY USAGE: 3.4 MB
# OUTPUT: Dashboard rendered successfully

Error Handling

Error	Description	Resolution
Invalid asset class	Wrong type specified	Use correct asset class
Missing sync.json	No sync file	Run zeysdk link first
Invalid sync.json	Missing id/url	Relink instance
Missing asset	File not found	Check file path
Invalid script type	Wrong extension	Use .ixml or .zymba
Authentication error	Token expired	Auto-relinks
Execution error	Runtime error	Check error output