wtfutil/wtf · error

maximumCmd execution failed: %w

Error message

maximumCmd execution failed: %w

What it means

Raised in the progress widget's Refresh when the configured maximumCmd shell command fails (non-zero exit, not found, or no output) — the widget cannot determine the maximum value of the progress range and stores the error for display.

Source

Thrown at modules/progress/widget.go:75

/* -------------------- Exported Functions -------------------- */

// Refresh updates the onscreen contents of the widget
func (widget *Widget) Refresh() {
	var err error

	if cmd := widget.settings.minimumCmd; cmd != "" {
		widget.minimum, err = widget.execValueCmd(cmd)
		if err != nil {
			widget.err = fmt.Errorf("minimumCmd execution failed: %w", err)
			widget.display()
			return
		}
	}

	if cmd := widget.settings.maximumCmd; cmd != "" {
		widget.maximum, err = widget.execValueCmd(cmd)
		if err != nil {
			widget.err = fmt.Errorf("maximumCmd execution failed: %w", err)
			widget.display()
			return
		}
	}

	if cmd := widget.settings.currentCmd; cmd != "" {
		widget.current, err = widget.execValueCmd(cmd)
		if err != nil {
			widget.err = fmt.Errorf("currentCmd execution failed: %w", err)
			widget.display()
			return
		}
	}

	widget.calcPercent()

	widget.display()
}

View on GitHub (pinned to bb838c1ccb)

Solutions

1. Run maximumCmd manually in the configured shell to reproduce the failure
2. Check the command exists on PATH or use an absolute path
3. Ensure the command prints a numeric value to stdout and exits 0
4. Verify the SHELL environment variable is set

When it happens

Trigger: Thrown at modules/progress/widget.go:75 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of wtfutil/wtf@bb838c1ccb (2026-09-03). Data as JSON: /api/errors/fa1c9b214af62e72. Report an issue: GitHub.