chenhg5/cc-connect · error

missing --url

Error message

missing --url

What it means

A sentinel validation error raised by runTuiTuiDownload when the parsed tuitui options contain an empty --url value. It fires because the download operation requires a target URL and the argument was omitted or blank.

Source

Thrown at cmd/cc-connect/tuitui.go:107

		Limit:        opts.limit,
		OrderAsc:     opts.orderAsc,
	})
	if err != nil {
		fatalTuiTui(err)
	}
	if command == "search" {
		result = filterTuiTuiHistory(result, opts.query)
	}
	printJSON(result)
}

func runTuiTuiDownload(args []string) {
	opts, err := parseTuiTuiArgs(args)
	if err != nil {
		fatalTuiTui(err)
	}
	if opts.url == "" {
		fatalTuiTui(errors.New("missing --url"))
	}
	ctx, cancel := context.WithTimeout(context.Background(), 60*time.Second)
	defer cancel()
	data, mimeType, name, err := downloadTuiTuiURL(ctx, opts.url, opts.maxBytes)
	if err != nil {
		fatalTuiTui(err)
	}
	outDir := opts.outDir
	if outDir == "" {
		outDir = "./tmp/tuitui"
	}
	if name == "" || name == "." || name == "/" {
		name = fmt.Sprintf("tuitui_%d", time.Now().Unix())
	}
	if err := os.MkdirAll(outDir, 0o755); err != nil {
		fatalTuiTui(err)
	}
	outPath := filepath.Join(outDir, filepath.Base(name))

View on GitHub (pinned to 4000b2338a)

Solutions

1. Add `--url <file_url>` pointing to the resource to download
2. Verify the URL variable is populated before invoking the command
3. Use the tuitui post/send path instead if the intent was to upload a local file

Example fix

// before
cc-connect tuitui download --max-bytes 1048576
// after
cc-connect tuitui download --url https://example.com/file.png

if url == "" {
    return errors.New("download requires --url")
}

When it happens

Trigger: Running `cc-connect tuitui download` without `--url <url>`, or with an empty --url value.

Common situations: Variable holding the URL was empty in a script, forgot the flag after copy-pasting only the message-related options, or intended to pipe a file via stdin but used the download subcommand.

Understand the failure class

Background: "--flag is required" and "must specify" CLI errors: how missing-required-flag validation works and how to fix it — this error's family across 20 libraries.

Related errors

• missing --chat
• missing --q
• missing --channel
• missing --message or --stdin
• read stdin: %w

AI-assisted analysis of chenhg5/cc-connect@4000b2338a (2026-09-06). Data as JSON: /api/errors/00e3579646e86017. Report an issue: GitHub.