@enjoys/context-engine 1.0.0

package/data/commands/cat.json

@@ -0,0 +1,18 @@
+{
+  "name": "cat",
+  "description": "Concatenate and display file contents",
+  "category": "text-processing",
+  "platforms": ["linux", "macos"],
+  "shells": ["bash", "zsh", "fish"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "-n", "description": "Number all output lines" },
+    { "name": "-b", "description": "Number non-blank output lines" },
+    { "name": "-s", "description": "Squeeze multiple blank lines" },
+    { "name": "-E", "description": "Display $ at end of each line" },
+    { "name": "-T", "description": "Display TAB as ^I" },
+    { "name": "-A", "description": "Show all (equivalent to -vET)" }
+  ],
+  "examples": ["cat file.txt", "cat -n file.txt", "cat file1.txt file2.txt > combined.txt", "cat -b script.sh"],
+  "relatedCommands": ["less", "more", "head", "tail", "bat", "tac"]
+}

package/data/commands/cd.json

@@ -0,0 +1,48 @@
+{
+  "name": "cd",
+  "description": "Change the current working directory",
+  "category": "Linux Coreutils",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell", "fish"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "-L", "description": "Follow symbolic links (default)" },
+    { "name": "-P", "description": "Use physical directory structure (no symlinks)" },
+    { "name": "-e", "description": "Exit with non-zero if -P and pwd fails" },
+    { "name": "-@", "description": "Present file with extended attributes as directory (macOS)" }
+  ],
+  "examples": [
+    { "command": "cd /var/log", "description": "Change to absolute path" },
+    { "command": "cd ..", "description": "Go up one directory" },
+    { "command": "cd ~", "description": "Go to home directory" },
+    { "command": "cd -", "description": "Go to previous directory" },
+    { "command": "cd ~/projects/myapp", "description": "Go to project directory" },
+    { "command": "cd \"dir with spaces\"", "description": "Directory with spaces" }
+  ],
+  "relatedCommands": ["ls", "pwd"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "subdirectories",
+        "description": "Directories in current location",
+        "command": "ls -d */ 2>/dev/null | head -30",
+        "parser": "lines",
+        "cacheFor": 5
+      },
+      {
+        "name": "recent_dirs",
+        "description": "Recently used directories",
+        "command": "dirs -v 2>/dev/null | head -10",
+        "parser": "lines",
+        "cacheFor": 5
+      },
+      {
+        "name": "home_dirs",
+        "description": "Home directory contents",
+        "command": "ls -d ~/*/ 2>/dev/null | head -15",
+        "parser": "lines",
+        "cacheFor": 30
+      }
+    ]
+  }
+}

package/data/commands/certbot.json

@@ -0,0 +1,148 @@
+{
+  "name": "certbot",
+  "description": "Let's Encrypt client — obtain and manage TLS/SSL certificates automatically",
+  "category": "security",
+  "platforms": ["linux", "macos"],
+  "shells": ["bash", "zsh", "fish"],
+  "subcommands": [
+    {
+      "name": "certonly",
+      "description": "Obtain a certificate without installing it",
+      "options": [
+        { "name": "--standalone", "description": "Use built-in web server for validation" },
+        { "name": "--webroot", "description": "Use webroot directory for validation" },
+        { "name": "--webroot-path", "short": "-w", "description": "Web root path for webroot plugin", "type": "directory" },
+        { "name": "--nginx", "description": "Use Nginx plugin for validation and installation" },
+        { "name": "--apache", "description": "Use Apache plugin for validation and installation" },
+        { "name": "--dns-cloudflare", "description": "Use Cloudflare DNS plugin for validation" },
+        { "name": "--dns-route53", "description": "Use AWS Route 53 DNS plugin for validation" },
+        { "name": "--manual", "description": "Manual mode for domain validation" },
+        { "name": "--preferred-challenges", "description": "Preferred challenge type (http-01, dns-01, tls-alpn-01)", "type": "string" }
+      ],
+      "examples": [
+        "certbot certonly --standalone -d example.com",
+        "certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com",
+        "certbot certonly --nginx -d example.com",
+        "certbot certonly --dns-cloudflare -d '*.example.com' -d example.com"
+      ]
+    },
+    {
+      "name": "install",
+      "description": "Install a previously obtained certificate",
+      "options": [
+        { "name": "--nginx", "description": "Install in Nginx" },
+        { "name": "--apache", "description": "Install in Apache" },
+        { "name": "--cert-path", "description": "Path to certificate", "type": "file" },
+        { "name": "--key-path", "description": "Path to private key", "type": "file" }
+      ],
+      "examples": ["certbot install --nginx -d example.com"]
+    },
+    {
+      "name": "renew",
+      "description": "Renew all certificates that are near expiry",
+      "options": [
+        { "name": "--dry-run", "description": "Test renewal without making changes" },
+        { "name": "--force-renewal", "description": "Force renewal even if not yet due" },
+        { "name": "--deploy-hook", "description": "Command to run after successful renewal", "type": "string" },
+        { "name": "--pre-hook", "description": "Command to run before renewal", "type": "string" },
+        { "name": "--post-hook", "description": "Command to run after renewal (success or fail)", "type": "string" },
+        { "name": "--quiet", "description": "Suppress output except errors" }
+      ],
+      "examples": [
+        "certbot renew",
+        "certbot renew --dry-run",
+        "certbot renew --force-renewal",
+        "certbot renew --deploy-hook 'systemctl reload nginx'"
+      ]
+    },
+    {
+      "name": "certificates",
+      "description": "List all managed certificates",
+      "examples": ["certbot certificates"]
+    },
+    {
+      "name": "revoke",
+      "description": "Revoke a certificate",
+      "options": [
+        { "name": "--cert-path", "description": "Path to certificate to revoke", "type": "file" },
+        { "name": "--reason", "description": "Reason for revocation", "type": "string" },
+        { "name": "--delete-after-revoke", "description": "Delete cert files after revoking" }
+      ],
+      "examples": ["certbot revoke --cert-path /etc/letsencrypt/live/example.com/cert.pem"]
+    },
+    {
+      "name": "delete",
+      "description": "Delete a certificate",
+      "options": [
+        { "name": "--cert-name", "description": "Name of certificate to delete", "type": "string" }
+      ],
+      "examples": ["certbot delete --cert-name example.com"]
+    }
+  ],
+  "globalOptions": [
+    { "name": "--domain", "short": "-d", "description": "Domain name(s) for the certificate", "type": "string" },
+    { "name": "--email", "description": "Email for registration and recovery", "type": "string" },
+    { "name": "--agree-tos", "description": "Agree to the ACME terms of service" },
+    { "name": "--non-interactive", "short": "-n", "description": "Run non-interactively" },
+    { "name": "--dry-run", "description": "Test without making permanent changes" },
+    { "name": "--staging", "description": "Use Let's Encrypt staging server" },
+    { "name": "--cert-name", "description": "Certificate name", "type": "string" },
+    { "name": "--expand", "description": "Expand existing certificate with additional domains" },
+    { "name": "--rsa-key-size", "description": "RSA key size", "type": "number", "default": "2048" },
+    { "name": "--key-type", "description": "Key type (rsa or ecdsa)", "type": "string", "default": "ecdsa" },
+    { "name": "--config-dir", "description": "Configuration directory", "type": "directory" },
+    { "name": "--logs-dir", "description": "Logs directory", "type": "directory" }
+  ],
+  "examples": [
+    "certbot --nginx -d example.com",
+    "certbot certonly --standalone -d example.com",
+    "certbot renew --dry-run",
+    "certbot certificates",
+    "certbot delete --cert-name example.com"
+  ],
+  "relatedCommands": ["openssl", "nginx", "apache", "caddy"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "managed_certificates",
+        "description": "All Let's Encrypt certificates managed by certbot",
+        "command": "certbot certificates 2>/dev/null | grep -E '(Certificate Name|Domains|Expiry Date|Certificate Path|Private Key Path)' | sed 's/^[[:space:]]*//'",
+        "parser": "lines",
+        "cacheFor": 300,
+        "requiresCmd": "certbot"
+      },
+      {
+        "name": "certificate_names",
+        "description": "Names of managed certificates",
+        "command": "certbot certificates 2>/dev/null | grep 'Certificate Name:' | awk '{print $3}'",
+        "parser": "lines",
+        "cacheFor": 300,
+        "requiresCmd": "certbot"
+      },
+      {
+        "name": "expiring_soon",
+        "description": "Certificates expiring within 30 days",
+        "command": "certbot certificates 2>/dev/null | grep -A3 'Certificate Name' | grep -B1 'INVALID\\|days)' || echo 'none'",
+        "parser": "lines",
+        "cacheFor": 3600,
+        "requiresCmd": "certbot"
+      },
+      {
+        "name": "renewal_configs",
+        "description": "Renewal configuration files",
+        "command": "ls /etc/letsencrypt/renewal/ 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 300,
+        "requiresCmd": "certbot"
+      },
+      {
+        "name": "live_certs_dir",
+        "description": "Certificate directories in /etc/letsencrypt/live/",
+        "command": "ls /etc/letsencrypt/live/ 2>/dev/null | grep -v README",
+        "parser": "lines",
+        "cacheFor": 300,
+        "requiresCmd": "certbot"
+      }
+    ]
+  }
+}

package/data/commands/chmod.json

@@ -0,0 +1,97 @@
+{
+  "name": "chmod",
+  "description": "Change file mode bits (permissions)",
+  "category": "coreutils",
+  "platforms": ["linux", "macos"],
+  "shells": ["bash", "zsh", "fish"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "-R", "description": "Change files and directories recursively" },
+    { "name": "-v", "description": "Verbose — output for each file processed" },
+    { "name": "-c", "description": "Verbose only when a change is made" },
+    { "name": "-f", "description": "Suppress most error messages" },
+    { "name": "--reference", "description": "Use another file's permissions as template", "type": "file" },
+    { "name": "--preserve-root", "description": "Fail to operate recursively on '/'" },
+    { "name": "--no-preserve-root", "description": "Do not treat '/' specially" }
+  ],
+  "examples": [
+    "chmod 755 script.sh",
+    "chmod 644 file.txt",
+    "chmod +x script.sh",
+    "chmod -x file.txt",
+    "chmod u+rwx,g+rx,o+rx file",
+    "chmod -R 755 directory/",
+    "chmod a+r file.txt",
+    "chmod u+s program",
+    "chmod g+s directory/",
+    "chmod o-rwx private.key",
+    "chmod 600 ~/.ssh/id_rsa",
+    "chmod 700 ~/.ssh",
+    "chmod --reference=ref.txt target.txt",
+    "chmod -R u+rw,g+r,o-rwx /var/www",
+    "chmod 400 secret.pem",
+    "find . -type f -exec chmod 644 {} +",
+    "find . -type d -exec chmod 755 {} +"
+  ],
+  "relatedCommands": ["chown", "chgrp", "ls", "stat", "umask", "getfacl", "setfacl"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "cwd_permissions",
+        "description": "File permissions in the current directory",
+        "command": "ls -la 2>/dev/null | head -20",
+        "parser": "lines",
+        "cacheFor": 5,
+        "requiresCmd": "ls"
+      },
+      {
+        "name": "cwd_path",
+        "description": "Current working directory path",
+        "command": "pwd",
+        "parser": "text",
+        "cacheFor": 3,
+        "requiresCmd": "chmod"
+      },
+      {
+        "name": "executable_files",
+        "description": "Executable files in current directory",
+        "command": "find . -maxdepth 1 -type f -executable 2>/dev/null | head -20",
+        "parser": "lines",
+        "cacheFor": 10,
+        "requiresCmd": "find"
+      },
+      {
+        "name": "current_umask",
+        "description": "Current file creation mask",
+        "command": "umask",
+        "parser": "text",
+        "cacheFor": 300,
+        "requiresCmd": "chmod"
+      },
+      {
+        "name": "current_user",
+        "description": "Current user and groups",
+        "command": "id",
+        "parser": "text",
+        "cacheFor": 300,
+        "requiresCmd": "chmod"
+      },
+      {
+        "name": "world_writable",
+        "description": "World-writable files (potential security risks)",
+        "command": "find . -maxdepth 2 -type f -perm -002 2>/dev/null | head -10",
+        "parser": "lines",
+        "cacheFor": 30,
+        "requiresCmd": "find"
+      },
+      {
+        "name": "ssh_key_permissions",
+        "description": "SSH key file permissions (should be 600)",
+        "command": "ls -la ~/.ssh/ 2>/dev/null | grep -E '(id_|authorized)' | head -10",
+        "parser": "lines",
+        "cacheFor": 60,
+        "requiresCmd": "ls"
+      }
+    ]
+  }
+}

package/data/commands/choco.json

@@ -0,0 +1,134 @@
+{
+  "name": "choco",
+  "description": "Chocolatey package manager for Windows",
+  "category": "Package Managers",
+  "platforms": ["windows"],
+  "shells": ["powershell", "cmd"],
+  "subcommands": [
+    { "name": "install", "description": "Install packages", "args": [{ "name": "packages", "description": "Package names", "required": true }], "options": [
+      { "name": "-y", "description": "Confirm all prompts" },
+      { "name": "--version", "description": "Specific version", "takesValue": true },
+      { "name": "--pre", "description": "Include prerelease" },
+      { "name": "--force", "shorthand": "-f", "description": "Force install" },
+      { "name": "--params", "description": "Package parameters", "takesValue": true },
+      { "name": "--install-arguments", "shorthand": "-ia", "description": "Install arguments", "takesValue": true },
+      { "name": "--override-arguments", "shorthand": "-o", "description": "Override default arguments" },
+      { "name": "--x86", "description": "Force 32-bit" },
+      { "name": "--ignore-checksums", "description": "Ignore checksums" },
+      { "name": "--no-progress", "description": "Hide progress" },
+      { "name": "--source", "shorthand": "-s", "description": "Package source", "takesValue": true }
+    ]},
+    { "name": "uninstall", "description": "Uninstall packages", "args": [{ "name": "packages", "description": "Package names", "required": true }], "options": [
+      { "name": "-y", "description": "Confirm all" },
+      { "name": "--force", "description": "Force uninstall" },
+      { "name": "--all-versions", "description": "Remove all versions" }
+    ]},
+    { "name": "upgrade", "description": "Upgrade packages", "args": [{ "name": "packages", "description": "Package names (or all)", "required": true }], "options": [
+      { "name": "-y", "description": "Confirm all" },
+      { "name": "--except", "description": "Exclude packages", "takesValue": true },
+      { "name": "--pre", "description": "Include prerelease" },
+      { "name": "--noop", "description": "Dry run / simulation" }
+    ]},
+    { "name": "search", "description": "Search packages", "args": [{ "name": "query", "description": "Search term", "required": true }], "options": [
+      { "name": "--exact", "description": "Exact match" },
+      { "name": "--source", "shorthand": "-s", "description": "Source", "takesValue": true },
+      { "name": "--pre", "description": "Include prerelease" },
+      { "name": "--page", "description": "Page number", "takesValue": true },
+      { "name": "--page-size", "description": "Page size", "takesValue": true }
+    ]},
+    { "name": "list", "description": "List installed packages", "options": [
+      { "name": "--local-only", "shorthand": "-l", "description": "Local only (installed)" },
+      { "name": "--pre", "description": "Include prerelease" }
+    ]},
+    { "name": "info", "description": "Get package info", "args": [{ "name": "package", "description": "Package name", "required": true }] },
+    { "name": "outdated", "description": "Show outdated packages" },
+    { "name": "pin", "description": "Pin a package version", "subcommands": [
+      { "name": "add", "description": "Pin a package" },
+      { "name": "remove", "description": "Unpin a package" },
+      { "name": "list", "description": "List pinned packages" }
+    ]},
+    { "name": "source", "description": "Manage sources", "subcommands": [
+      { "name": "add", "description": "Add source" },
+      { "name": "remove", "description": "Remove source" },
+      { "name": "list", "description": "List sources" },
+      { "name": "enable", "description": "Enable source" },
+      { "name": "disable", "description": "Disable source" }
+    ]},
+    { "name": "config", "description": "Manage config", "subcommands": [
+      { "name": "get", "description": "Get config value" },
+      { "name": "set", "description": "Set config value" },
+      { "name": "unset", "description": "Unset config" },
+      { "name": "list", "description": "List config" }
+    ]},
+    { "name": "feature", "description": "Manage features", "subcommands": [
+      { "name": "list", "description": "List features" },
+      { "name": "enable", "description": "Enable feature" },
+      { "name": "disable", "description": "Disable feature" }
+    ]},
+    { "name": "pack", "description": "Create a package from nuspec" },
+    { "name": "push", "description": "Push package to repository" },
+    { "name": "new", "description": "Create new package template" },
+    { "name": "export", "description": "Export installed packages to file" }
+  ],
+  "globalOptions": [
+    { "name": "-y", "description": "Confirm all prompts" },
+    { "name": "-f", "description": "Force" },
+    { "name": "--verbose", "shorthand": "-v", "description": "Verbose output" },
+    { "name": "--debug", "description": "Debug output" },
+    { "name": "--trace", "description": "Trace output" },
+    { "name": "--no-color", "description": "No colors" },
+    { "name": "--limit-output", "shorthand": "-r", "description": "Limit output for parsing" },
+    { "name": "--timeout", "description": "Command timeout", "takesValue": true },
+    { "name": "--cache-location", "shorthand": "-c", "description": "Cache location", "takesValue": true },
+    { "name": "--allow-unofficial-build", "description": "Allow unofficial build" }
+  ],
+  "examples": [
+    { "command": "choco install git -y", "description": "Install Git" },
+    { "command": "choco install nodejs python3 -y", "description": "Install multiple packages" },
+    { "command": "choco install nodejs --version 18.0.0", "description": "Specific version" },
+    { "command": "choco upgrade all -y", "description": "Upgrade all packages" },
+    { "command": "choco search redis", "description": "Search packages" },
+    { "command": "choco list -l", "description": "List installed" },
+    { "command": "choco outdated", "description": "Show outdated" },
+    { "command": "choco uninstall nodejs -y", "description": "Uninstall" },
+    { "command": "choco pin add -n nodejs --version 18.0.0", "description": "Pin version" },
+    { "command": "choco export packages.config", "description": "Export package list" }
+  ],
+  "relatedCommands": ["winget", "scoop"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "installed",
+        "description": "Installed packages",
+        "command": "choco list -l -r 2>$null | Select-Object -Last 20",
+        "parser": "lines",
+        "cacheFor": 120,
+        "requiresCmd": "choco"
+      },
+      {
+        "name": "outdated",
+        "description": "Outdated packages",
+        "command": "choco outdated -r 2>$null | Select-Object -First 15",
+        "parser": "lines",
+        "cacheFor": 300,
+        "requiresCmd": "choco"
+      },
+      {
+        "name": "sources",
+        "description": "Configured sources",
+        "command": "choco source list -r 2>$null",
+        "parser": "lines",
+        "cacheFor": 300,
+        "requiresCmd": "choco"
+      },
+      {
+        "name": "pinned",
+        "description": "Pinned packages",
+        "command": "choco pin list -r 2>$null",
+        "parser": "lines",
+        "cacheFor": 300,
+        "requiresCmd": "choco"
+      }
+    ]
+  }
+}

package/data/commands/chown.json

@@ -0,0 +1,59 @@
+{
+  "name": "chown",
+  "description": "Change file owner and group",
+  "category": "Linux Coreutils",
+  "platforms": ["linux", "macos"],
+  "shells": ["bash", "zsh", "fish"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "--recursive", "shorthand": "-R", "description": "Operate recursively on directories" },
+    { "name": "--verbose", "shorthand": "-v", "description": "Verbose output" },
+    { "name": "--changes", "shorthand": "-c", "description": "Report only when changes are made" },
+    { "name": "--silent", "shorthand": "-f", "description": "Suppress error messages" },
+    { "name": "--no-dereference", "shorthand": "-h", "description": "Affect symbolic links (not referenced file)" },
+    { "name": "--from", "description": "Change only if current owner/group matches", "takesValue": true },
+    { "name": "--reference", "description": "Use reference file's owner/group", "takesValue": true },
+    { "name": "--dereference", "description": "Affect dereferenced file (default)" },
+    { "name": "-H", "description": "If -R, traverse symlinks on command line" },
+    { "name": "-L", "description": "If -R, traverse all symlinks" },
+    { "name": "-P", "description": "If -R, never traverse symlinks (default)" },
+    { "name": "--preserve-root", "description": "Don't recurse on /" },
+    { "name": "--no-preserve-root", "description": "Allow recursion on /" },
+    { "name": "--help", "description": "Show help" }
+  ],
+  "examples": [
+    { "command": "chown user:group file.txt", "description": "Change owner and group" },
+    { "command": "chown -R www-data:www-data /var/www", "description": "Recursive ownership change" },
+    { "command": "chown user file.txt", "description": "Change only owner" },
+    { "command": "chown :group file.txt", "description": "Change only group" },
+    { "command": "chown --reference=ref.txt target.txt", "description": "Match reference file" },
+    { "command": "chown -Rv deploy:deploy /opt/app", "description": "Verbose recursive change" },
+    { "command": "sudo chown root:root /etc/config", "description": "Change to root ownership" }
+  ],
+  "relatedCommands": ["chmod", "ls"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "users",
+        "description": "System users",
+        "command": "cut -d: -f1 /etc/passwd 2>/dev/null | sort | head -30",
+        "parser": "lines",
+        "cacheFor": 120
+      },
+      {
+        "name": "groups",
+        "description": "System groups",
+        "command": "cut -d: -f1 /etc/group 2>/dev/null | sort | head -30",
+        "parser": "lines",
+        "cacheFor": 120
+      },
+      {
+        "name": "current_ownership",
+        "description": "Current file ownership",
+        "command": "ls -la 2>/dev/null | head -20",
+        "parser": "lines",
+        "cacheFor": 10
+      }
+    ]
+  }
+}

package/data/commands/clickhouse-client.json

@@ -0,0 +1,74 @@
+{
+  "name": "clickhouse-client",
+  "description": "ClickHouse native command-line client for analytics queries",
+  "category": "Database",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell", "fish"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "--host", "shorthand": "-h", "description": "Server hostname", "takesValue": true },
+    { "name": "--port", "description": "Server port (default: 9000 native, 8123 HTTP)", "takesValue": true },
+    { "name": "--user", "shorthand": "-u", "description": "Username", "takesValue": true },
+    { "name": "--password", "description": "Password", "takesValue": true },
+    { "name": "--database", "shorthand": "-d", "description": "Database name", "takesValue": true },
+    { "name": "--query", "shorthand": "-q", "description": "Execute query and exit", "takesValue": true },
+    { "name": "--multiquery", "shorthand": "-n", "description": "Allow multiple queries separated by semicolons" },
+    { "name": "--multiline", "shorthand": "-m", "description": "Multiline mode (use ;; to execute)" },
+    { "name": "--format", "shorthand": "-f", "description": "Output format (TabSeparated, CSV, JSON, Pretty, etc.)", "takesValue": true },
+    { "name": "--vertical", "shorthand": "-E", "description": "Vertical format" },
+    { "name": "--time", "shorthand": "-t", "description": "Print query execution time" },
+    { "name": "--stacktrace", "description": "Show stack trace on exceptions" },
+    { "name": "--progress", "description": "Show query progress" },
+    { "name": "--secure", "description": "Use TLS" },
+    { "name": "--config-file", "shorthand": "-C", "description": "Config file path", "takesValue": true },
+    { "name": "--history_file", "description": "Path to command history file", "takesValue": true },
+    { "name": "--max_insert_block_size", "description": "Max rows per insert block", "takesValue": true },
+    { "name": "--max_threads", "description": "Max query threads", "takesValue": true }
+  ],
+  "examples": [
+    { "command": "clickhouse-client", "description": "Connect to local server" },
+    { "command": "clickhouse-client -q 'SELECT 1'", "description": "Execute query" },
+    { "command": "clickhouse-client -h analytics.example.com -u admin --password secret -d mydb", "description": "Remote connection" },
+    { "command": "clickhouse-client -q 'SELECT * FROM events' --format JSON", "description": "JSON output" },
+    { "command": "clickhouse-client -n -q 'CREATE TABLE t(x UInt32) ENGINE=MergeTree ORDER BY x; INSERT INTO t VALUES (1)'", "description": "Multiple queries" },
+    { "command": "cat data.csv | clickhouse-client -q 'INSERT INTO events FORMAT CSV'", "description": "Import CSV" },
+    { "command": "clickhouse-client -q 'SHOW DATABASES'", "description": "List databases" }
+  ],
+  "relatedCommands": ["psql", "mysql", "influx"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "databases",
+        "description": "Available databases",
+        "command": "clickhouse-client -q 'SHOW DATABASES' --format=TabSeparatedRaw 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 30,
+        "requiresCmd": "clickhouse-client"
+      },
+      {
+        "name": "tables",
+        "description": "Tables in current database",
+        "command": "clickhouse-client -q 'SHOW TABLES' --format=TabSeparatedRaw 2>/dev/null | head -30",
+        "parser": "lines",
+        "cacheFor": 30,
+        "requiresCmd": "clickhouse-client"
+      },
+      {
+        "name": "version",
+        "description": "ClickHouse version",
+        "command": "clickhouse-client -q 'SELECT version()' 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 300,
+        "requiresCmd": "clickhouse-client"
+      },
+      {
+        "name": "engines",
+        "description": "Available table engines",
+        "command": "clickhouse-client -q 'SELECT name FROM system.table_engines ORDER BY name' --format=TabSeparatedRaw 2>/dev/null | head -20",
+        "parser": "lines",
+        "cacheFor": 300,
+        "requiresCmd": "clickhouse-client"
+      }
+    ]
+  }
+}