Fix documented config options/env vars/flags (#94)

Author: nathanjcochran

CLAUDE.md

@@ -225,17 +225,11 @@ The CLI uses a layered configuration approach:
 3. Environment variables with `TIGER_` prefix
 4. Command-line flags (highest precedence)
 
-Key configuration values:
-- `api_url`: Tiger API endpoint
-- `console_url`: Tiger Console URL
-- `gateway_url`: Tiger Gateway URL
-- `docs_mcp`: Enable/disable proxied docs MCP tools
-- `docs_mcp_url`: URL for docs MCP server
-- `service_id`: Default service ID
-- `output`: Output format (json, yaml, table)
-- `analytics`: Usage analytics toggle
-- `password_storage`: Password storage method (keyring, pgpass, none)
-- `debug`: Debug logging toggle
+For a complete list of valid configuration options, see `internal/tiger/config/config.go`.
+All configuration options also have corresponding `TIGER_` environment variables.
+
+For a complete list of global command-line flags, see `internal/tiger/cmd/root.go`.
+Note that not all config options have corresponding global flags, and not all global flags correspond to config options.
 
 ### MCP Server Architecture
 
@@ -318,14 +312,6 @@ Two-mode logging system using zap:
 - **Production mode**: Minimal output, warn level and above, clean formatting
 - **Debug mode**: Full development logging with colors and debug level
 
-Global flags available on all commands:
-- `--config-dir`: Path to configuration directory
-- `--debug`: Enable debug logging
-- `--output/-o`: Set output format
-- `--service-id`: Override service ID
-- `--analytics`: Toggle analytics
-- `--password-storage`: Password storage method
-
 ### Dependencies
 
 - **Cobra**: CLI framework and command structure

README.md

@@ -213,36 +213,40 @@ tiger config reset
 
 All configuration options can be set via `tiger config set <key> <value>`:
 
+- `analytics` - Enable/disable analytics (default: `true`)
+- `color` - Enable/disable colored output (default: `true`)
+- `debug` - Enable/disable debug logging (default: `false`)
 - `docs_mcp` - Enable/disable docs MCP proxy (default: `true`)
-- `service_id` - Default service ID
 - `output` - Output format: `json`, `yaml`, or `table` (default: `table`)
-- `analytics` - Enable/disable analytics (default: `true`)
 - `password_storage` - Password storage method: `keyring`, `pgpass`, or `none` (default: `keyring`)
-- `debug` - Enable/disable debug logging (default: `false`)
+- `service_id` - Default service ID
+- `version_check_interval` - How often the CLI will check for new versions, 0 to disable (default: `24h`)
 
 ### Environment Variables
 
 Environment variables override configuration file values. All variables use the `TIGER_` prefix:
 
+- `TIGER_ANALYTICS` - Enable/disable analytics
+- `TIGER_COLOR` - Enable/disable colored output
 - `TIGER_CONFIG_DIR` - Path to configuration directory (default: `~/.config/tiger`)
+- `TIGER_DEBUG` - Enable/disable debug logging
 - `TIGER_DOCS_MCP` - Enable/disable docs MCP proxy
-- `TIGER_SERVICE_ID` - Default service ID
 - `TIGER_OUTPUT` - Output format: `json`, `yaml`, or `table`
-- `TIGER_ANALYTICS` - Enable/disable analytics
 - `TIGER_PASSWORD_STORAGE` - Password storage method: `keyring`, `pgpass`, or `none`
-- `TIGER_DEBUG` - Enable/disable debug logging
-- `TIGER_VERSION_CHECK_URL` - URL to check for latest version
-- `TIGER_VERSION_CHECK_INTERVAL` - Seconds between version checks, 0 to disable
+- `TIGER_SERVICE_ID` - Default service ID
+- `TIGER_VERSION_CHECK_INTERVAL` - How often the CLI will check for new versions, 0 to disable
 
 ### Global Flags
 
 These flags are available on all commands and take precedence over both environment variables and configuration file values:
 
-- `--config-dir <path>` - Path to configuration directory (default: `~/.config/tiger`)
-- `--service-id <id>` - Specify service ID
 - `--analytics` - Enable/disable analytics
-- `--password-storage <method>` - Password storage method: `keyring`, `pgpass`, or `none`
+- `--color` - Enable/disable colored output
+- `--config-dir <path>` - Path to configuration directory (default: `~/.config/tiger`)
 - `--debug` - Enable/disable debug logging
+- `--password-storage <method>` - Password storage method: `keyring`, `pgpass`, or `none`
+- `--service-id <id>` - Specify service ID
+- `--skip-update-check` - Skip checking for updates on startup (default: `false`)
 - `-h, --help` - Show help information
 
 ## Contributing

specs/spec.md

@@ -23,32 +23,54 @@ mv tiger /usr/local/bin/
 
 ### Environment Variables
 
-- `TIGER_API_URL`: Base URL for Tiger Cloud API (default: https://api.tigerdata.com/public/v1)
-- `TIGER_SERVICE_ID`: Default service ID to use
-- `TIGER_CONFIG_DIR`: Configuration directory (default: ~/.config/tiger)
-- `TIGER_OUTPUT`: Default output format (json, yaml, table)
-- `TIGER_ANALYTICS`: Enable/disable usage analytics (true/false)
+Environment variables override configuration file values. All variables use the `TIGER_` prefix:
+
+- `TIGER_ANALYTICS` - Enable/disable analytics
+- `TIGER_COLOR` - Enable/disable colored output
+- `TIGER_CONFIG_DIR` - Path to configuration directory (default: ~/.config/tiger)
+- `TIGER_DEBUG` - Enable/disable debug logging
+- `TIGER_DOCS_MCP` - Enable/disable docs MCP proxy
+- `TIGER_OUTPUT` - Output format: json, yaml, or table
+- `TIGER_PASSWORD_STORAGE` - Password storage method: keyring, pgpass, or none
+- `TIGER_SERVICE_ID` - Default service ID
+- `TIGER_VERSION_CHECK_INTERVAL` - How often the CLI will check for new versions, 0 to disable
 
 ### Configuration File
 
 Location: `~/.config/tiger/config.yaml`
 
+All configuration options can be set via `tiger config set <key> <value>`:
+
+- `analytics` - Enable/disable analytics (default: true)
+- `color` - Enable/disable colored output (default: true)
+- `debug` - Enable/disable debug logging (default: false)
+- `docs_mcp` - Enable/disable docs MCP proxy (default: true)
+- `output` - Output format: json, yaml, or table (default: table)
+- `password_storage` - Password storage method: keyring, pgpass, or none (default: keyring)
+- `service_id` - Default service ID
+- `version_check_interval` - How often the CLI will check for new versions, 0 to disable (default: 24h)
+
+#### Example
+
 ```yaml
 api_url: https://api.tigerdata.com/public/v1
 service_id: your-default-service-id
 output: table
 analytics: true
 ```
 
-### Global Options
+### Global Flags
+
+These flags are available on all commands and take precedence over both environment variables and configuration file values:
 
-- `--config-dir`: Path to configuration directory
-- `--service-id`: Override default service ID (can also be specified positionally for single-service commands)
-- `--analytics`: Toggle analytics collection
-- `--password-storage`: Password storage method (keyring, pgpass, none) (default: keyring)
-- `-v, --version`: Show CLI version
-- `-h, --help`: Show help information
-- `--debug`: Enable debug logging
+- `--analytics` - Enable/disable analytics
+- `--color` - Enable/disable colored output
+- `--config-dir <path>` - Path to configuration directory (default: ~/.config/tiger)
+- `--debug` - Enable/disable debug logging
+- `--password-storage <method>` - Password storage method: keyring, pgpass, or none
+- `--service-id <id>` - Specify service ID
+- `--skip-update-check` - Skip checking for updates on startup (default: false)
+- `-h, --help` - Show help information
 
 ## Command Structure