Let's update CLI desciptions and examples

Author: Stanislav (Stas) Katkov

cmd/count.go

@@ -12,15 +12,30 @@ import (
 )
 
 var countCmd = &cobra.Command{
-	Use:   "count",
-	Short: "Character, spaces and word counter",
-	Long:  "Count characters, spaces and words in a string",
+	Use:   "count [string or file]",
+	Short: "Count characters, spaces, and words in text",
+	Long: `Count characters, spaces, and words in text input.
+
+Provides detailed statistics including character count, space count, and word count
+in a formatted table. Input can be a string argument or piped from stdin.`,
 	Example: `  # Count text from a string
   devtui count "test me please"
+  devtui count "hello world"
 
   # Count text from stdin
-  cat testdata/example.csv | devtui count
-  echo "hello world" | devtui count`,
+  echo "hello world" | devtui count
+  cat document.txt | devtui count
+
+  # Count text from file
+  devtui count < document.txt
+  cat README.md | devtui count
+
+  # Output to file
+  devtui count "sample text" > stats.txt
+
+  # Chain with other commands
+  curl -s https://example.com | devtui count
+  cat article.txt | devtui count`,
 	Args: cobra.MaximumNArgs(1),
 	RunE: func(cmd *cobra.Command, args []string) error {
 		text, err := input.ReadFromArgsOrStdin(cmd, args)

cmd/cssfmt.go

@@ -12,13 +12,35 @@ import (
 )
 
 var cssfmtCmd = &cobra.Command{
-	Use:   "cssfmt",
-	Short: "Format CSS files",
-	Long:  "Format CSS files",
-	Example: `
-	cssfmt < testdata/bootstrap.min.css
-	cssfmt < testdata/bootstrap.min.css --tui # Show results in a TUI
-	`,
+	Use:   "cssfmt [string or file]",
+	Short: "Format and prettify CSS files",
+	Long: `Format and prettify CSS files with customizable indentation and formatting options.
+
+By default, uses 2-space indentation. Use --tab for tab indentation or --indent to specify
+custom spacing. Input can be a string argument or piped from stdin.`,
+	Example: `  # Format CSS from stdin
+  devtui cssfmt < styles.css
+  cat minified.css | devtui cssfmt
+
+  # Format CSS string argument
+  devtui cssfmt 'body{margin:0;padding:0}'
+
+  # Use tab indentation
+  devtui cssfmt --tab < styles.css
+  devtui cssfmt -t < styles.css
+
+  # Use custom indent spacing
+  devtui cssfmt --indent 4 < styles.css
+  devtui cssfmt -i 4 < styles.css
+
+  # Output to file
+  devtui cssfmt < input.css > formatted.css
+
+  # Show results in interactive TUI
+  devtui cssfmt --tui < styles.css
+
+  # Chain with other commands
+  curl -s https://example.com/styles.css | devtui cssfmt`,
 	Args: cobra.MaximumNArgs(1),
 	RunE: func(cmd *cobra.Command, args []string) error {
 		if flagTui {

cmd/cssmin.go

@@ -9,11 +9,27 @@ import (
 )
 
 var cssminCmd = &cobra.Command{
-	Use:     "cssmin",
-	Short:   "Minify CSS files",
-	Long:    "Minify CSS files",
-	Example: "cssmin < testdata/bootstrap.min.css",
-	Args:    cobra.MaximumNArgs(1),
+	Use:   "cssmin [string or file]",
+	Short: "Minify CSS files by removing whitespace and unnecessary characters",
+	Long: `Minify CSS files by removing whitespace, line breaks, and unnecessary characters.
+
+This reduces file size for production use while maintaining CSS functionality.
+Input can be a string argument or piped from stdin.`,
+	Example: `  # Minify CSS from stdin
+  devtui cssmin < styles.css
+  cat source.css | devtui cssmin
+
+  # Minify CSS string argument
+  devtui cssmin 'body { margin: 0; padding: 0; }'
+
+  # Output to file
+  devtui cssmin < input.css > minified.css
+  cat styles.css | devtui cssmin > styles.min.css
+
+  # Chain with other commands
+  curl -s https://example.com/styles.css | devtui cssmin
+  devtui cssfmt < messy.css | devtui cssmin`,
+	Args: cobra.MaximumNArgs(1),
 	RunE: func(cmd *cobra.Command, args []string) error {
 		cssformat := csstool.NewCSSFormat(0, false, nil)
 		cssformat.AlwaysSemicolon = false

cmd/csv2md.go

@@ -13,12 +13,31 @@ import (
 //   @see https://git.axenov.dev/anthony/csv2md/src/branch/master
 
 var csv2mdCmd = &cobra.Command{
-	Use:   "csv2md",
-	Short: "Convert CSV to Markdown Table",
-	Long:  "Convert CSV to Markdown Table",
-	Example: `  devtui csv2md -t < example.tsv          - convert tsv from stdin and view result in stdout
-	devtui csv2md < example.tsv > output.md - convert tsv from stdin and write result in new file
-	cat example.tsv | devtui csv2md         - convert tsv from stdin and view result in stdout`,
+	Use:   "csv2md [string or file]",
+	Short: "Convert CSV to Markdown table format",
+	Long: `Convert CSV (Comma-Separated Values) to Markdown table format for documentation.
+
+Input can be piped from stdin or read from a file. Use --align to align column widths
+and --header to add a main heading (h1) to the output.`,
+	Example: `  # Convert CSV from stdin
+  devtui csv2md < example.csv
+  cat data.csv | devtui csv2md
+
+  # Output to file
+  devtui csv2md < input.csv > output.md
+  cat data.csv | devtui csv2md > table.md
+
+  # Add main header to output
+  devtui csv2md --header "User Data" < users.csv
+  devtui csv2md -t "Sales Report" < sales.csv
+
+  # Align column widths for better readability
+  devtui csv2md --align < data.csv
+  devtui csv2md -a < data.csv
+
+  # Combine options
+  devtui csv2md --header "Results" --align < data.csv
+  devtui csv2md -t "Results" -a < data.csv`,
 	Args: cobra.MaximumNArgs(1),
 	RunE: func(cmd *cobra.Command, args []string) error {
 

cmd/gqlquery.go

@@ -15,15 +15,45 @@ import (
 )
 
 var gqlfmtCmd = &cobra.Command{
-	Use:   "gqlquery",
-	Short: "Format GraphQL queries",
-	Long:  "Format GraphQL queries for better readability",
-	Example: `
-	gqlquery < testdata/query.graphql # Format and output to stdout
- 	gqlquery < testdata/query.graphql > formatted.graphql # Output to file
-	gqlquery --indent "    " --with-comments --with-descriptions < testdata/query.graphql # With formatting options
-	gqlquery < testdata/query.graphql --tui # Show results in a TUI
-	`,
+	Use:   "gqlquery [string or file]",
+	Short: "Format and prettify GraphQL queries",
+	Long: `Format and prettify GraphQL queries for better readability with customizable formatting options.
+
+By default, uses 2-space indentation and omits descriptions. Use flags to customize
+indentation, include comments, or include descriptions. Input can be a string argument
+or piped from stdin.`,
+	Example: `  # Format GraphQL query from stdin
+  devtui gqlquery < query.graphql
+  cat query.graphql | devtui gqlquery
+
+  # Format GraphQL string argument
+  devtui gqlquery 'query { user(id: 1) { name email } }'
+
+  # Output to file
+  devtui gqlquery < input.graphql > formatted.graphql
+  cat query.graphql | devtui gqlquery > pretty.graphql
+
+  # Custom indentation (4 spaces)
+  devtui gqlquery --indent "    " < query.graphql
+  devtui gqlquery -i "    " < query.graphql
+
+  # Include comments in output
+  devtui gqlquery --with-comments < query.graphql
+  devtui gqlquery -c < query.graphql
+
+  # Include descriptions in output
+  devtui gqlquery --with-descriptions < query.graphql
+  devtui gqlquery -d < query.graphql
+
+  # Combine formatting options
+  devtui gqlquery -i "    " -c -d < query.graphql
+
+  # Show results in interactive TUI
+  devtui gqlquery --tui < query.graphql
+  devtui gqlquery -t < query.graphql
+
+  # Chain with other commands
+  curl -s https://api.example.com/schema.graphql | devtui gqlquery`,
 	Args: cobra.MaximumNArgs(1),
 	RunE: func(cmd *cobra.Command, args []string) error {
 		data, err := input.ReadBytesFromArgsOrStdin(cmd, args)

cmd/jsonfmt.go

@@ -9,13 +9,26 @@ import (
 )
 
 var jsonfmtCmd = &cobra.Command{
-	Use:   "jsonfmt",
-	Short: "Format JSON",
-	Long:  "Format JSON",
-	Example: `
-	devtui jsonfmt < testdata/example.json # Format and output to stdout
- 	devtui jsonfmt < testdata/example.json > formatted.json # Output to file
-	`,
+	Use:   "jsonfmt [string or file]",
+	Short: "Format and prettify JSON",
+	Long: `Format and prettify JSON input with proper indentation and syntax highlighting.
+
+Input can be a string argument, piped from stdin, or read from a file.
+The output is always valid, properly indented JSON.`,
+	Example: `  # Format JSON from stdin
+  devtui jsonfmt < example.json
+  echo '{"name":"John","age":30}' | devtui jsonfmt
+
+  # Format JSON string argument
+  devtui jsonfmt '{"name":"John","age":30}'
+
+  # Output to file
+  devtui jsonfmt < input.json > formatted.json
+  cat compact.json | devtui jsonfmt > pretty.json
+
+  # Chain with other commands
+  curl -s https://api.example.com/data | devtui jsonfmt
+  devtui jsonrepair < broken.json | devtui jsonfmt`,
 	Args: cobra.MaximumNArgs(1),
 	RunE: func(cmd *cobra.Command, args []string) error {
 		data, err := input.ReadBytesFromArgsOrStdin(cmd, args)

cmd/tomlfmt.go

@@ -11,10 +11,30 @@ import (
 )
 
 var tomlfmtCmd = &cobra.Command{
-	Use:   "tomlfmt",
-	Short: "Format TOML files",
-	Long:  "Format TOML files",
-	Args:  cobra.MaximumNArgs(1),
+	Use:   "tomlfmt [string or file]",
+	Short: "Format and prettify TOML files",
+	Long: `Format and prettify TOML (Tom's Obvious Minimal Language) files with proper indentation.
+
+Input can be a string argument or piped from stdin. Use --tui flag to view results
+in an interactive terminal interface.`,
+	Example: `  # Format TOML from stdin
+  devtui tomlfmt < config.toml
+  cat app.toml | devtui tomlfmt
+
+  # Format TOML string argument
+  devtui tomlfmt '[package]\nname = "myapp"'
+
+  # Output to file
+  devtui tomlfmt < input.toml > formatted.toml
+  cat config.toml | devtui tomlfmt > pretty.toml
+
+  # Show results in interactive TUI
+  devtui tomlfmt --tui < config.toml
+  devtui tomlfmt -t < config.toml
+
+  # Chain with other commands
+  curl -s https://example.com/config.toml | devtui tomlfmt`,
+	Args: cobra.MaximumNArgs(1),
 	RunE: func(cmd *cobra.Command, args []string) error {
 		data, err := input.ReadBytesFromArgsOrStdin(cmd, args)
 		if err != nil {

cmd/tsv2md.go

@@ -13,12 +13,31 @@ import (
 //   @see https://git.axenov.dev/anthony/csv2md/src/branch/master
 
 var tsv2mdCmd = &cobra.Command{
-	Use:   "tsv2md",
-	Short: "Convert TSV to Markdown Table",
-	Long:  "Convert TSV to Markdown Table",
-	Example: `  devtui tsv2md -t < example.tsv          # convert tsv from stdin and view result in stdout
-	devtui tsv2md < example.tsv > output.md # convert tsv from stdin and write result in new file
-	cat example.tsv | devtui tsv2md         # convert tsv from stdin and view result in stdout`,
+	Use:   "tsv2md [string or file]",
+	Short: "Convert TSV to Markdown table format",
+	Long: `Convert TSV (Tab-Separated Values) to Markdown table format for documentation.
+
+Input can be piped from stdin or read from a file. Use --align to align column widths
+and --header to add a main heading (h1) to the output.`,
+	Example: `  # Convert TSV from stdin
+  devtui tsv2md < example.tsv
+  cat data.tsv | devtui tsv2md
+
+  # Output to file
+  devtui tsv2md < input.tsv > output.md
+  cat data.tsv | devtui tsv2md > table.md
+
+  # Add main header to output
+  devtui tsv2md --header "User Data" < users.tsv
+  devtui tsv2md -t "Sales Report" < sales.tsv
+
+  # Align column widths for better readability
+  devtui tsv2md --align < data.tsv
+  devtui tsv2md -a < data.tsv
+
+  # Combine options
+  devtui tsv2md --header "Results" --align < data.tsv
+  devtui tsv2md -t "Results" -a < data.tsv`,
 	Args: cobra.MaximumNArgs(1),
 	RunE: func(cmd *cobra.Command, args []string) error {
 		// Read from args or stdin - the function handles both cases

cmd/xmlfmt.go

@@ -12,14 +12,41 @@ import (
 )
 
 var xmlfmtCmd = &cobra.Command{
-	Use:   "xmlfmt",
-	Short: "Format XML",
-	Long:  "Format XML",
-	Example: `
-	xmlfmt < testdata/sample.xml   # Format XML from stdin
-	xmlfmt < testdata/sample.xml > output.xml # Output formatted XML to file
-	xmlfmt < testdata/sample.xml --tui # Open XML formatter in TUI
-	`,
+	Use:   "xmlfmt [string or file]",
+	Short: "Format and prettify XML files",
+	Long: `Format and prettify XML files with customizable indentation and formatting options.
+
+By default, uses 2-space indentation. Customize with --indent, --prefix, and --nested flags.
+Input can be a string argument or piped from stdin.`,
+	Example: `  # Format XML from stdin
+  devtui xmlfmt < document.xml
+  cat unformatted.xml | devtui xmlfmt
+
+  # Format XML string argument
+  devtui xmlfmt '<root><item>value</item></root>'
+
+  # Output to file
+  devtui xmlfmt < input.xml > formatted.xml
+  cat document.xml | devtui xmlfmt > pretty.xml
+
+  # Custom indentation
+  devtui xmlfmt --indent "    " < document.xml
+  devtui xmlfmt -i "\t" < document.xml
+
+  # Add prefix to each line
+  devtui xmlfmt --prefix "  " < document.xml
+  devtui xmlfmt -p "  " < document.xml
+
+  # Handle nested tags in comments
+  devtui xmlfmt --nested < document.xml
+  devtui xmlfmt -n < document.xml
+
+  # Show results in interactive TUI
+  devtui xmlfmt --tui < document.xml
+  devtui xmlfmt -t < document.xml
+
+  # Chain with other commands
+  curl -s https://example.com/feed.xml | devtui xmlfmt`,
 	Args: cobra.MaximumNArgs(1),
 	RunE: func(cmd *cobra.Command, args []string) error {
 		// Read all input data from stdin or args

go.mod

@@ -1,6 +1,6 @@
 module github.com/skatkov/devtui
 
-go 1.25.3
+go 1.25.4
 
 require (
 	github.com/RealAlexandreAI/json-repair v0.0.14