@enjoys/context-engine 1.3.1 → 1.4.2

package/data/commands/sparql.json

@@ -1,16 +1,30 @@
 {
   "name": "sparql",
-  "description": "SPARQL command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "SPARQL query tools for RDF/linked data (Apache Jena, Blazegraph, rdflib)",
+  "category": "tool",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "query", "description": "Execute a SPARQL query against an endpoint or local file", "args": ["query"], "options": ["--service", "--data", "--output"] },
+    { "name": "update", "description": "Execute a SPARQL UPDATE operation", "args": ["update"], "options": ["--service", "--data"] },
+    { "name": "validate", "description": "Validate RDF data using SHACL shapes", "args": ["data", "shapes"], "options": ["--format"] },
+    { "name": "load", "description": "Load RDF data into a triplestore", "args": ["file"], "options": ["--graph", "--format"] },
+    { "name": "export", "description": "Export triplestore data to file", "args": [], "options": ["--graph", "--format", "--output"] },
+    { "name": "server", "description": "Start SPARQL endpoint server (Fuseki)", "args": [], "options": ["--port", "--dataset"] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "--service", "description": "SPARQL endpoint URL" },
+    { "name": "--data", "description": "Path to local RDF data file" },
+    { "name": "--output", "description": "Output format (json, xml, csv, tsv, turtle)" },
+    { "name": "--timeout", "description": "Query timeout in milliseconds" },
+    { "name": "--graph", "description": "Named graph URI" }
   ],
-  "subcommands": []
+  "examples": [
+    "rsparql --service http://dbpedia.org/sparql --query 'SELECT ?s WHERE { ?s a dbo:Country } LIMIT 10'",
+    "arq --data data.ttl --query query.rq",
+    "fuseki-server --mem /dataset --port 3030",
+    "riot --validate data.ttl",
+    "s-update --service http://localhost:3030/ds/update --update insert.ru"
+  ],
+  "relatedCommands": ["sql", "graphql", "curl", "jq"]
 }

package/data/commands/sql.json

@@ -4,8 +4,22 @@
   "category": "database",
   "platforms": ["linux", "macos", "windows"],
   "shells": ["bash", "zsh", "fish", "powershell"],
-  "subcommands": [],
-  "globalOptions": [],
+  "subcommands": [
+    { "name": "sqlite3", "description": "SQLite3 interactive shell and command-line tool", "args": ["database"], "options": ["-cmd", "-csv", "-json", "-header"] },
+    { "name": "mysql", "description": "MySQL command-line client", "args": ["database"], "options": ["-u", "-p", "-h", "-e", "--batch"] },
+    { "name": "psql", "description": "PostgreSQL interactive terminal", "args": ["database"], "options": ["-U", "-h", "-c", "-f", "--csv"] },
+    { "name": "sqlcmd", "description": "SQL Server command-line utility", "args": [], "options": ["-S", "-U", "-P", "-Q", "-i"] },
+    { "name": "sqlfmt", "description": "SQL formatter for standardized code style", "args": ["file.sql"], "options": ["--uppercase", "--indent"] },
+    { "name": "sqlfluff", "description": "SQL linter and auto-fixer", "args": ["file.sql"], "options": ["--dialect", "--fix"] }
+  ],
+  "globalOptions": [
+    { "name": "-h / --host", "description": "Database server hostname" },
+    { "name": "-p / --port", "description": "Database server port" },
+    { "name": "-U / --user", "description": "Database username" },
+    { "name": "-d / --database", "description": "Target database name" },
+    { "name": "-f / --file", "description": "Execute SQL from file" },
+    { "name": "-o / --output", "description": "Write results to output file" }
+  ],
   "examples": [
     "SELECT * FROM users;",
     "SELECT id, name FROM users WHERE active = 1;",

package/data/commands/ssh_config.json

@@ -1,35 +1,36 @@
 {
   "name": "ssh",
-  "description": "SSH Config command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "SSH client — secure remote shell and tunneling",
+  "category": "tool",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "-T git@github.com", "description": "Test SSH connection without allocating TTY", "args": ["host"], "options": [] },
+    { "name": "-i key host", "description": "Connect using a specific identity file", "args": ["key", "host"], "options": [] },
+    { "name": "-L port:host:port user@host", "description": "Local port forwarding (tunnel remote port to local)", "args": ["binding"], "options": [] },
+    { "name": "-R port:host:port user@host", "description": "Remote port forwarding (tunnel local port to remote)", "args": ["binding"], "options": [] },
+    { "name": "-D port user@host", "description": "Dynamic SOCKS proxy via SSH tunnel", "args": ["port", "host"], "options": [] },
+    { "name": "-J jumphost user@destination", "description": "Connect via jump/bastion host", "args": ["jumphost", "destination"], "options": [] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "-i", "description": "Identity file (private key) for authentication" },
+    { "name": "-p", "description": "Port to connect to on remote host" },
+    { "name": "-L", "description": "Local port forwarding" },
+    { "name": "-R", "description": "Remote port forwarding" },
+    { "name": "-D", "description": "Dynamic SOCKS proxy" },
+    { "name": "-J", "description": "Jump host (ProxyJump)" },
+    { "name": "-N", "description": "Do not execute remote command (for tunnels)" },
+    { "name": "-F", "description": "Specify alternative SSH config file" },
+    { "name": "-o", "description": "Set SSH option (e.g., StrictHostKeyChecking=no)" },
+    { "name": "-v / -vv / -vvv", "description": "Increase verbosity for debugging" }
   ],
-  "subcommands": [
-    {
-      "name": "-T git@github.com",
-      "description": "Test SSH connection",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "-i key host",
-      "description": "Connect with key",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "-L port:host:port user@host",
-      "description": "Port forwarding",
-      "args": [],
-      "options": []
-    }
-  ]
+  "examples": [
+    "ssh -T git@github.com",
+    "ssh -i ~/.ssh/mykey user@server.example.com",
+    "ssh -L 8080:localhost:80 user@remote-server",
+    "ssh -J bastion user@internal-server",
+    "ssh -D 1080 user@proxy-server",
+    "ssh -o StrictHostKeyChecking=no user@host"
+  ],
+  "relatedCommands": ["ssh-keygen", "scp", "rsync", "sftp"]
 }

package/data/commands/st.json

@@ -1,16 +1,28 @@
 {
   "name": "st",
-  "description": "Structured Text command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "Structured Text — IEC 61131-3 PLC programming tools (CODESYS, OpenPLC, matiec)",
+  "category": "language",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "compile", "description": "Compile Structured Text to PLC bytecode", "args": ["file.st"], "options": ["--target", "--output"] },
+    { "name": "check", "description": "Syntax-check Structured Text source files", "args": ["file.st"], "options": ["--strict"] },
+    { "name": "simulate", "description": "Run PLC simulation with Structured Text program", "args": ["file.st"], "options": ["--cycle-time", "--duration"] },
+    { "name": "download", "description": "Download compiled program to PLC controller", "args": ["file"], "options": ["--target-ip", "--protocol"] },
+    { "name": "generate", "description": "Generate C code from Structured Text using matiec", "args": ["file.st"], "options": ["-I", "-T"] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "--target", "description": "Target PLC platform" },
+    { "name": "--output", "description": "Output file or directory" },
+    { "name": "-I", "description": "Include directory for library files" },
+    { "name": "-T", "description": "Build output directory for matiec" },
+    { "name": "--verbose", "description": "Enable verbose compilation output" }
   ],
-  "subcommands": []
+  "examples": [
+    "iec2c -I lib/ -T build/ program.st",
+    "matiec program.st -o output.c",
+    "openplc_editor program.st",
+    "codesys --build project.project --compile"
+  ],
+  "relatedCommands": ["gcc", "make", "systemverilog"]
 }

package/data/commands/systemverilog.json

@@ -1,29 +1,31 @@
 {
   "name": "vlog",
-  "description": "SystemVerilog command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "SystemVerilog — HDL compiler and simulation tools (ModelSim/QuestaSim, Verilator, Icarus)",
+  "category": "language",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "file.sv", "description": "Compile SystemVerilog file", "args": ["file"], "options": [] },
+    { "name": "-sv file.sv", "description": "Force SystemVerilog language mode", "args": ["file"], "options": [] },
+    { "name": "-lint file.sv", "description": "Run lint checks on SystemVerilog", "args": ["file"], "options": [] },
+    { "name": "+incdir+path file.sv", "description": "Compile with include directory", "args": ["path", "file"], "options": [] },
+    { "name": "-work library file.sv", "description": "Compile into a named library", "args": ["library", "file"], "options": [] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "-sv", "description": "Enable SystemVerilog features" },
+    { "name": "+incdir+<path>", "description": "Add include search directory" },
+    { "name": "+define+<macro>", "description": "Define a preprocessor macro" },
+    { "name": "-work", "description": "Target library for compilation" },
+    { "name": "-lint", "description": "Enable lint-style warnings" },
+    { "name": "-timescale", "description": "Set default timescale" },
+    { "name": "-Wall", "description": "Enable all warnings (Verilator)" }
   ],
-  "subcommands": [
-    {
-      "name": "file.sv",
-      "description": "Compile SystemVerilog",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "-sv file.sv",
-      "description": "Force SystemVerilog mode",
-      "args": [],
-      "options": []
-    }
-  ]
+  "examples": [
+    "vlog -sv design.sv testbench.sv",
+    "verilator --lint-only -Wall design.sv",
+    "iverilog -g2012 -o sim design.sv testbench.sv && vvp sim",
+    "vlog +incdir+./rtl -sv top.sv && vsim work.top",
+    "verilator --cc --exe --build design.sv sim_main.cpp"
+  ],
+  "relatedCommands": ["make", "gtkwave", "pla", "mips"]
 }

package/data/commands/tailwindcss.json

@@ -1,53 +1,60 @@
-{
-  "language": "tailwindcss",
-  "commands": [
-    {
-      "command": "tailwindcss.sortClasses",
-      "title": "Tailwind CSS: Sort Classes",
-      "description": "Sorts Tailwind utility classes in the selected class attribute following the recommended Headwind/Prettier-plugin-tailwindcss order.",
-      "category": "Tailwind CSS"
-    },
-    {
-      "command": "tailwindcss.showGeneratedCSS",
-      "title": "Tailwind CSS: Show Generated CSS",
-      "description": "Displays the compiled CSS output for the Tailwind utility classes under the cursor or in the selection.",
-      "category": "Tailwind CSS"
-    },
-    {
-      "command": "tailwindcss.openConfig",
-      "title": "Tailwind CSS: Open Configuration",
-      "description": "Opens the tailwind.config.js configuration file for the current workspace.",
-      "category": "Tailwind CSS"
-    },
-    {
-      "command": "tailwindcss.extractApply",
-      "title": "Tailwind CSS: Extract to @apply Component",
-      "description": "Extracts selected utility classes into a new CSS component using @apply directive.",
-      "category": "Tailwind CSS"
-    },
-    {
-      "command": "tailwindcss.showColorPalette",
-      "title": "Tailwind CSS: Show Color Palette",
-      "description": "Displays the full Tailwind color palette with hex values from the theme configuration.",
-      "category": "Tailwind CSS"
-    },
-    {
-      "command": "tailwindcss.convertToArbitrary",
-      "title": "Tailwind CSS: Convert to Arbitrary Value",
-      "description": "Converts a standard utility value to arbitrary bracket notation, e.g. p-4 to p-[1rem].",
-      "category": "Tailwind CSS"
-    },
-    {
-      "command": "tailwindcss.removeDuplicates",
-      "title": "Tailwind CSS: Remove Duplicate Classes",
-      "description": "Removes duplicate utility classes from the selected class attribute.",
-      "category": "Tailwind CSS"
-    },
-    {
-      "command": "tailwindcss.wrapResponsive",
-      "title": "Tailwind CSS: Wrap with Responsive Prefix",
-      "description": "Wraps selected utility classes with a chosen responsive breakpoint prefix (sm:, md:, lg:, xl:, 2xl:).",
-      "category": "Tailwind CSS"
-    }
-  ]
-}
+{
+  "name": "tailwindcss",
+  "description": "tailwindcss development commands",
+  "category": "development",
+  "platforms": [
+    "linux",
+    "macos",
+    "windows"
+  ],
+  "shells": [
+    "bash",
+    "zsh",
+    "powershell"
+  ],
+  "subcommands": [
+    {
+      "name": "tailwindcss.sortClasses",
+      "description": "Sorts Tailwind utility classes in the selected class attribute following the recommended Headwind/Prettier-plugin-tailwindcss order.",
+      "options": []
+    },
+    {
+      "name": "tailwindcss.showGeneratedCSS",
+      "description": "Displays the compiled CSS output for the Tailwind utility classes under the cursor or in the selection.",
+      "options": []
+    },
+    {
+      "name": "tailwindcss.openConfig",
+      "description": "Opens the tailwind.config.js configuration file for the current workspace.",
+      "options": []
+    },
+    {
+      "name": "tailwindcss.extractApply",
+      "description": "Extracts selected utility classes into a new CSS component using @apply directive.",
+      "options": []
+    },
+    {
+      "name": "tailwindcss.showColorPalette",
+      "description": "Displays the full Tailwind color palette with hex values from the theme configuration.",
+      "options": []
+    },
+    {
+      "name": "tailwindcss.convertToArbitrary",
+      "description": "Converts a standard utility value to arbitrary bracket notation, e.g. p-4 to p-[1rem].",
+      "options": []
+    },
+    {
+      "name": "tailwindcss.removeDuplicates",
+      "description": "Removes duplicate utility classes from the selected class attribute.",
+      "options": []
+    },
+    {
+      "name": "tailwindcss.wrapResponsive",
+      "description": "Wraps selected utility classes with a chosen responsive breakpoint prefix (sm:, md:, lg:, xl:, 2xl:).",
+      "options": []
+    }
+  ],
+  "globalOptions": [],
+  "examples": [],
+  "relatedCommands": []
+}

package/data/commands/tcl.json

@@ -1,23 +1,28 @@
 {
   "name": "tclsh",
-  "description": "Tcl command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "Tcl — Tool Command Language interpreter",
+  "category": "language",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "script.tcl", "description": "Run a Tcl script file", "args": ["file"], "options": [] },
+    { "name": "<< 'puts hello'", "description": "Evaluate Tcl commands from stdin", "args": [], "options": [] },
+    { "name": "script.tcl arg1 arg2", "description": "Run Tcl script with command-line arguments", "args": ["file", "args"], "options": [] },
+    { "name": "-encoding utf-8 script.tcl", "description": "Run with specified file encoding", "args": ["file"], "options": [] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "-encoding", "description": "Set the encoding for script files" },
+    { "name": "argv0", "description": "Tcl variable containing the script name" },
+    { "name": "argc", "description": "Tcl variable with number of arguments" },
+    { "name": "auto_path", "description": "Tcl variable with package search paths" },
+    { "name": "tcl_interactive", "description": "Variable indicating interactive mode" }
   ],
-  "subcommands": [
-    {
-      "name": "script.tcl",
-      "description": "Run Tcl script",
-      "args": [],
-      "options": []
-    }
-  ]
+  "examples": [
+    "tclsh script.tcl",
+    "wish gui_app.tcl",
+    "echo 'puts [expr {2 + 3}]' | tclsh",
+    "expect script.exp",
+    "tclsh -encoding utf-8 unicode_script.tcl"
+  ],
+  "relatedCommands": ["expect", "wish", "python", "perl"]
 }

package/data/commands/toml.json

@@ -1,16 +1,30 @@
 {
   "name": "toml",
-  "description": "TOML command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "TOML file manipulation and validation tools (taplo, toml-cli, dasel)",
+  "category": "tool",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "format", "description": "Format TOML files with taplo", "args": ["files"], "options": ["--config", "--check"] },
+    { "name": "lint", "description": "Lint TOML files for schema compliance", "args": ["files"], "options": ["--schema"] },
+    { "name": "get", "description": "Get a value from a TOML file by key path", "args": ["file", "key"], "options": [] },
+    { "name": "set", "description": "Set a value in a TOML file", "args": ["file", "key", "value"], "options": ["--type"] },
+    { "name": "validate", "description": "Validate TOML file syntax", "args": ["file"], "options": ["--schema"] },
+    { "name": "convert", "description": "Convert TOML to JSON or YAML", "args": ["file"], "options": ["--to"] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "--config", "description": "Path to taplo configuration file" },
+    { "name": "--schema", "description": "JSON Schema URL or path for validation" },
+    { "name": "--check", "description": "Check formatting without writing changes" },
+    { "name": "--output", "description": "Output file path" },
+    { "name": "--colors", "description": "Enable or disable colored output" }
   ],
-  "subcommands": []
+  "examples": [
+    "taplo format Cargo.toml",
+    "taplo lint pyproject.toml --schema https://json.schemastore.org/pyproject",
+    "taplo format --check '**/*.toml'",
+    "toml get Cargo.toml package.version",
+    "dasel -f config.toml '.database.port'"
+  ],
+  "relatedCommands": ["yaml", "json", "ini", "jq"]
 }

package/data/commands/twig.json

@@ -1,16 +1,29 @@
 {
   "name": "twig",
-  "description": "Twig command-line tool",
+  "description": "Twig template engine tools — linting, debugging (Symfony, Craft CMS)",
   "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "lint", "description": "Lint Twig template files for syntax errors", "args": ["path"], "options": ["--format", "--show-deprecations"] },
+    { "name": "debug", "description": "Display Twig functions, filters, and tests available", "args": [], "options": ["--filter", "--format"] },
+    { "name": "render", "description": "Render a Twig template with given data", "args": ["template"], "options": ["--data", "--output"] },
+    { "name": "cache:clear", "description": "Clear compiled Twig template cache", "args": [], "options": [] },
+    { "name": "check", "description": "Check Twig templates for deprecated features", "args": ["path"], "options": ["--show-deprecations"] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "--format", "description": "Output format (txt, json, github)" },
+    { "name": "--show-deprecations", "description": "Show deprecation warnings" },
+    { "name": "--env", "description": "Symfony environment (dev, prod, test)" },
+    { "name": "--no-debug", "description": "Disable debug mode" },
+    { "name": "--ansi", "description": "Force colored output" }
   ],
-  "subcommands": []
+  "examples": [
+    "php bin/console lint:twig templates/",
+    "php bin/console debug:twig --filter=date",
+    "php bin/console lint:twig templates/ --format=json",
+    "php bin/console cache:clear",
+    "twig-lint lint templates/"
+  ],
+  "relatedCommands": ["php", "composer", "symfony", "html"]
 }

package/data/commands/vb.json

@@ -1,29 +1,32 @@
 {
   "name": "vbc",
-  "description": "Visual Basic command-line tool",
-  "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "description": "Visual Basic — VB.NET compiler and .NET CLI tools",
+  "category": "language",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "/out:output.exe source.vb", "description": "Compile VB source to executable", "args": ["output", "source"], "options": [] },
+    { "name": "/target:library source.vb", "description": "Compile as class library (DLL)", "args": ["source"], "options": [] },
+    { "name": "/target:winexe source.vb", "description": "Compile as Windows application", "args": ["source"], "options": [] },
+    { "name": "/debug+ source.vb", "description": "Compile with debug information", "args": ["source"], "options": [] },
+    { "name": "/optimize+ source.vb", "description": "Compile with optimizations enabled", "args": ["source"], "options": [] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "/out:<file>", "description": "Output file name" },
+    { "name": "/target:exe|library|winexe", "description": "Output type (console app, library, Windows app)" },
+    { "name": "/reference:<assembly>", "description": "Reference an external assembly" },
+    { "name": "/debug+", "description": "Emit debugging information" },
+    { "name": "/optimize+", "description": "Enable optimizations" },
+    { "name": "/imports:<namespace>", "description": "Import namespace globally" },
+    { "name": "/define:<symbol>=<value>", "description": "Define conditional compilation symbol" },
+    { "name": "/optionstrict+", "description": "Enforce strict type checking" }
   ],
-  "subcommands": [
-    {
-      "name": "/out:output.exe source.vb",
-      "description": "Compile VB",
-      "args": [],
-      "options": []
-    },
-    {
-      "name": "/target:library source.vb",
-      "description": "Compile as library",
-      "args": [],
-      "options": []
-    }
-  ]
+  "examples": [
+    "vbc /out:app.exe Program.vb",
+    "vbc /target:library /out:MyLib.dll Module1.vb",
+    "dotnet new console -lang VB -o MyApp",
+    "dotnet run --project MyApp",
+    "dotnet build --configuration Release"
+  ],
+  "relatedCommands": ["dotnet", "csharp", "sb", "msbuild"]
 }

package/data/commands/wgsl.json

@@ -1,16 +1,29 @@
 {
-  "name": "wgsl",
-  "description": "WGSL command-line tool",
+  "name": "naga",
+  "description": "WGSL shader tools — Naga compiler, validation, and translation (WebGPU)",
   "category": "development",
-  "platforms": [
-    "linux",
-    "macos",
-    "windows"
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell"],
+  "subcommands": [
+    { "name": "validate", "description": "Validate WGSL shader syntax and semantics", "args": ["file.wgsl"], "options": [] },
+    { "name": "convert", "description": "Convert WGSL to SPIR-V, GLSL, HLSL, or Metal", "args": ["input"], "options": ["--output", "--target"] },
+    { "name": "info", "description": "Display shader module information (entry points, bindings)", "args": ["file.wgsl"], "options": [] },
+    { "name": "compact", "description": "Minify WGSL shader removing whitespace and comments", "args": ["file.wgsl"], "options": ["--output"] },
+    { "name": "lint", "description": "Check WGSL for common issues and performance hints", "args": ["file.wgsl"], "options": ["--strict"] }
   ],
-  "shells": [
-    "bash",
-    "zsh",
-    "powershell"
+  "globalOptions": [
+    { "name": "--output", "description": "Output file path" },
+    { "name": "--target", "description": "Target shading language (spirv, glsl, hlsl, msl)" },
+    { "name": "--version", "description": "Target shader model version" },
+    { "name": "--validate", "description": "Run validation in addition to conversion" },
+    { "name": "--compact", "description": "Produce compact output" }
   ],
-  "subcommands": []
+  "examples": [
+    "naga shader.wgsl shader.spv",
+    "naga shader.wgsl shader.metal",
+    "naga --validate shader.wgsl",
+    "naga shader.wgsl shader.glsl --target glsl",
+    "tint shader.wgsl --format spvasm"
+  ],
+  "relatedCommands": ["glslc", "spirv-cross", "cargo", "wasm-pack"]
 }