CLI Reference

tcl-ls

tcl-ls starts the language server on stdio. It does not currently define additional CLI flags or subcommands.

tcl-check

Usage:

tcl-check [options] path

Options:

--color {auto,always,never}

Control ANSI color output. auto only enables color when stdout is a terminal and NO_COLOR is not set.

--context-lines N

Show N lines of surrounding source context for each diagnostic.

--fail-on-diagnostics

Exit with status 1 if any diagnostics are reported.

-j, --threads N

Analyze source files with N worker processes. The default is 8.

--plugin-path PATH

Load additional metadata from a directory, a .meta.tcl file, or a Tcl plugin script. The flag may be passed more than once.

Exit behavior:

  • 0 when analysis completes successfully

  • 1 for operational failures, or for reported diagnostics when --fail-on-diagnostics is used

  • 130 when interrupted with Ctrl-C

tcl-meta

Usage:

tcl-meta helper-path
tcl-meta build-file output.meta.tcl

Subcommands:

helper-path

Print the bundled tcl_meta.tcl helper path.

build-file

Run the bundled helper through tclsh and write a .meta.tcl file.

tcl-meta requires tclsh to be present on PATH.