Skip to main content

CLI Commands

texpand expand

Expand a trigger string and output the result.

texpand expand <input> [--config-dir <path>]
ArgumentDescription
inputThe text to search for triggers
--config-dirPath to match files directory (default: ~/.config/texpand/matches)

Exit codes:

  • 0: Success, expansion printed to stdout
  • 1: No match found

Examples:

texpand expand ":hello"
texpand expand "say :hello to the team"
texpand expand ":greet" --config-dir ./my-matches

texpand list

List all available triggers from your match files.

texpand list [--config-dir <path>]
OptionDescription
--config-dirPath to match files directory (default: ~/.config/texpand/matches)

Example output:

Trigger Replace/Form Type
-------------------- ---------------------------------------- ----------
:hello Hello World! text
:today {{today}} text
:greet form
:choose form

texpand form

Open an interactive form directly.

texpand form <layout> [--title <title>]
ArgumentDescription
layoutForm layout text with [[field]] placeholders
--titleTitle for the form window (default: texpand)

Example:

texpand form "Name: [[name]], Age: [[age]]" --title "User Info"

texpand config

Show configuration information.

texpand config

Outputs:

  • Config directory path
  • Config file path
  • Available shell plugins

texpand --help

Print help information.

texpand --help
texpand expand --help
texpand list --help