Root Command¶

The Root command is the entry point for every GTB CLI. It orchestrates the primary lifecycle of the application, including service initialization and global feature registration.

Usage¶

mytool [subcommand] [flags]

Description¶

The root command provides the base structure for your tool. It manages the persistent state (flags, logging, config) for all subcommands. It does not perform a specific domain action on its own but ensures the environment is correctly set up before any subcommand runs.

Built-in Commands¶

The root command automatically registers the following subcommands:

Command	Description	Can be Disabled?
`version`	Display version information and check for updates	No
`init`	Initialize tool configuration and setup	Yes
`update`	Update the tool to the latest version	Yes
`docs`	Interactive documentation browser with AI Q&A	Yes
`mcp`	Expose tool as a Model Context Protocol server	Yes
`doctor`	Environment and configuration health checks, plus `doctor report`	Yes
`changelog`	Display the embedded changelog	Yes
`config`	Programmatic config access (`get`/`set`/`list`/`validate`) — opt-in, off by default	Yes
`telemetry`	Opt-in usage telemetry status and management — off by default	Yes
`man`	Hidden roff man-page emitter for packaging — opt-in, off by default	Yes

See the Commands Overview for the full list and which commands are default-enabled versus opt-in.

Disabling Built-in Commands

Use the Features property to remove optional commands from your tool:

Tool: props.Tool{
    Features: props.SetFeatures(
        props.Disable(props.UpdateCmd), // Remove update command
        props.Disable(props.McpCmd),    // Remove MCP server
    ),
}

Global Flags¶

These flags are available to every subcommand:

Flag	Description
`--config stringArray`	Path(s) to configuration files (default: `~/.mytool/config.yaml` and `/etc/mytool/config.yaml`).
`--debug`	Forces debug-level logging and enables detailed error stack traces.
`--ci`	Indicates the tool is running in a Continuous Integration environment (disables interactive update prompts).
`--output`	Output format: `text` or `json` (default: `text`).