Documentation

Commands Overview

Complete reference for all GoMask CLI commands

Commands Overview

Complete reference for all GoMask CLI commands and options.

Quick Reference

CommandDescription
gomask initInitialize CLI configuration
gomask versionDisplay version info
gomask setupInteractive routine wizard
gomask exampleCreate example routine
gomask validateValidate YAML configuration
gomask importImport YAML to database
gomask exportExport routine to YAML
gomask runExecute a routine
gomask connectorsManage database connectors
gomask functionsExplore generation functions
gomask routinesManage routines
gomask executionsMonitor executions

Global Options

These options are available on all commands:

OptionDescription
--debugEnable debug logging for troubleshooting
--api-url URLOverride the GoMask API URL (for self-hosted)
--secret SECRETOverride API authentication secret
--versionDisplay CLI version information
-h, --helpShow help text for any command

Configuration

Set up and configure the CLI:

CommandDescription
initInitialize credentials and create gomask.toml
versionCheck CLI version and configuration status

Routine Workflow

Create, validate, and execute routines:

CommandDescription
setupInteractive wizard to create routines from your database
exampleGenerate starter templates for learning
validateCheck YAML configuration for errors
importUpload routine to GoMask platform
exportDownload routine as YAML
runExecute a routine with progress tracking

Resource Management

Manage connectors, functions, routines, and executions:

CommandDescription
connectorsCreate, test, and manage database connections
functionsExplore available data generation functions
routinesList and inspect routines
executionsMonitor and manage running jobs

Exit Codes

CodeMeaning
0Success
1General error
130Interrupted (Ctrl+C)

Getting Help

# General help
gomask --help

# Command-specific help
gomask run --help
gomask connectors create --help

See Also