@enjoys/context-engine 1.0.0

package/data/commands/scp.json

@@ -0,0 +1,60 @@
+{
+  "name": "scp",
+  "description": "Secure copy files between hosts over SSH",
+  "category": "Linux Coreutils",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell", "fish"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "-r", "description": "Recursively copy directories" },
+    { "name": "-P", "description": "Port number", "takesValue": true },
+    { "name": "-i", "description": "Identity file (private key)", "takesValue": true },
+    { "name": "-p", "description": "Preserve modification times, access times, and modes" },
+    { "name": "-q", "description": "Quiet mode (no progress meter)" },
+    { "name": "-v", "description": "Verbose mode" },
+    { "name": "-C", "description": "Enable compression" },
+    { "name": "-l", "description": "Limit bandwidth (Kbit/s)", "takesValue": true },
+    { "name": "-o", "description": "SSH option", "takesValue": true },
+    { "name": "-F", "description": "SSH config file", "takesValue": true },
+    { "name": "-S", "description": "Program for encrypted connection", "takesValue": true },
+    { "name": "-c", "description": "Cipher to use", "takesValue": true },
+    { "name": "-3", "description": "Copy between two remote hosts through local" },
+    { "name": "-T", "description": "Disable strict filename checking" },
+    { "name": "-O", "description": "Use legacy SCP protocol" }
+  ],
+  "examples": [
+    { "command": "scp file.txt user@host:/path/", "description": "Upload file" },
+    { "command": "scp user@host:/path/file.txt .", "description": "Download file" },
+    { "command": "scp -r dir/ user@host:/path/", "description": "Upload directory" },
+    { "command": "scp -P 2222 file.txt user@host:/path/", "description": "Custom port" },
+    { "command": "scp -i ~/.ssh/key.pem file.txt user@host:/path/", "description": "With key file" },
+    { "command": "scp user@host1:/file user@host2:/path/", "description": "Copy between remotes" },
+    { "command": "scp -C -l 1000 large.tar.gz user@host:/path/", "description": "Compressed with bandwidth limit" }
+  ],
+  "relatedCommands": ["ssh", "rsync", "sftp"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "ssh_hosts",
+        "description": "Known SSH hosts",
+        "command": "grep -E '^Host ' ~/.ssh/config 2>/dev/null | awk '{print $2}' | head -20",
+        "parser": "lines",
+        "cacheFor": 60
+      },
+      {
+        "name": "ssh_keys",
+        "description": "Available SSH keys",
+        "command": "ls ~/.ssh/*.pub 2>/dev/null | sed 's/\\.pub$//' | head -10",
+        "parser": "lines",
+        "cacheFor": 120
+      },
+      {
+        "name": "known_hosts",
+        "description": "Known host entries",
+        "command": "awk '{print $1}' ~/.ssh/known_hosts 2>/dev/null | sort -u | head -20",
+        "parser": "lines",
+        "cacheFor": 60
+      }
+    ]
+  }
+}

package/data/commands/sed.json

@@ -0,0 +1,28 @@
+{
+  "name": "sed",
+  "description": "Stream editor for filtering and transforming text",
+  "category": "text-processing",
+  "platforms": ["linux", "macos"],
+  "shells": ["bash", "zsh", "fish"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "-e", "description": "Add script command", "type": "string" },
+    { "name": "-f", "description": "Script file", "type": "file" },
+    { "name": "-i", "description": "Edit files in-place (optionally create backup)", "type": "string" },
+    { "name": "-n", "description": "Suppress automatic printing" },
+    { "name": "-r", "description": "Use extended regex (GNU)" },
+    { "name": "-E", "description": "Use extended regex (POSIX)" }
+  ],
+  "examples": [
+    "sed 's/old/new/g' file.txt",
+    "sed -i 's/old/new/g' file.txt",
+    "sed -i.bak 's/old/new/g' file.txt",
+    "sed -n '10,20p' file.txt",
+    "sed '/pattern/d' file.txt",
+    "sed '5i\\new line' file.txt",
+    "sed -n '/start/,/end/p' file.txt",
+    "sed 's/^/  /' file.txt",
+    "sed '$ a\\last line' file.txt"
+  ],
+  "relatedCommands": ["awk", "grep", "tr", "cut", "perl"]
+}

package/data/commands/sqlite3.json

@@ -0,0 +1,68 @@
+{
+  "name": "sqlite3",
+  "description": "SQLite command-line interface for managing SQLite databases",
+  "category": "Database",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell", "fish"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "-cmd", "description": "Run command before reading stdin", "takesValue": true },
+    { "name": "-csv", "description": "CSV output mode" },
+    { "name": "-column", "description": "Column-aligned output" },
+    { "name": "-html", "description": "HTML table output" },
+    { "name": "-json", "description": "JSON output" },
+    { "name": "-line", "description": "One value per line" },
+    { "name": "-list", "description": "Delimiter-separated output" },
+    { "name": "-markdown", "description": "Markdown table output" },
+    { "name": "-table", "description": "ASCII table output" },
+    { "name": "-tabs", "description": "Tab-separated output" },
+    { "name": "-separator", "description": "Column separator", "takesValue": true },
+    { "name": "-header", "description": "Show column headers" },
+    { "name": "-noheader", "description": "Hide column headers" },
+    { "name": "-readonly", "description": "Open database in read-only mode" },
+    { "name": "-batch", "description": "Batch mode (non-interactive)" },
+    { "name": "-init", "description": "Read and execute init file", "takesValue": true },
+    { "name": "-echo", "description": "Echo commands" },
+    { "name": "-bail", "description": "Stop on error" },
+    { "name": "-version", "description": "Show version" },
+    { "name": "-help", "description": "Show help" }
+  ],
+  "examples": [
+    { "command": "sqlite3 mydb.db", "description": "Open or create database" },
+    { "command": "sqlite3 mydb.db '.tables'", "description": "List tables" },
+    { "command": "sqlite3 mydb.db '.schema users'", "description": "Show table schema" },
+    { "command": "sqlite3 -json mydb.db 'SELECT * FROM users'", "description": "JSON query output" },
+    { "command": "sqlite3 mydb.db < schema.sql", "description": "Import SQL file" },
+    { "command": "sqlite3 mydb.db '.dump' > backup.sql", "description": "Dump database" },
+    { "command": "sqlite3 -csv mydb.db 'SELECT * FROM users' > users.csv", "description": "Export CSV" },
+    { "command": "sqlite3 :memory:", "description": "In-memory database" }
+  ],
+  "relatedCommands": ["mysql", "psql"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "db_files",
+        "description": "SQLite database files",
+        "command": "find . -maxdepth 2 -name '*.db' -o -name '*.sqlite' -o -name '*.sqlite3' 2>/dev/null | head -10",
+        "parser": "lines",
+        "cacheFor": 30
+      },
+      {
+        "name": "tables",
+        "description": "Tables in database",
+        "command": "sqlite3 $(find . -maxdepth 1 -name '*.db' -o -name '*.sqlite' -o -name '*.sqlite3' 2>/dev/null | head -1) '.tables' 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 30,
+        "requiresCmd": "sqlite3"
+      },
+      {
+        "name": "version",
+        "description": "SQLite version",
+        "command": "sqlite3 --version 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 300,
+        "requiresCmd": "sqlite3"
+      }
+    ]
+  }
+}

package/data/commands/ssh-keygen.json

@@ -0,0 +1,112 @@
+{
+  "name": "ssh-keygen",
+  "description": "SSH key generation, management, and conversion utility",
+  "category": "security",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "fish", "powershell"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "-t", "description": "Key type (rsa, ed25519, ecdsa, dsa)", "type": "string" },
+    { "name": "-b", "description": "Number of bits in the key", "type": "number" },
+    { "name": "-C", "description": "Comment for the key", "type": "string" },
+    { "name": "-f", "description": "Key file path", "type": "file" },
+    { "name": "-N", "description": "New passphrase", "type": "string" },
+    { "name": "-P", "description": "Old passphrase", "type": "string" },
+    { "name": "-p", "description": "Change passphrase of existing key" },
+    { "name": "-l", "description": "Show fingerprint of key file" },
+    { "name": "-E", "description": "Hash algorithm for fingerprint (md5, sha256)", "type": "string" },
+    { "name": "-R", "description": "Remove host from known_hosts file", "type": "string" },
+    { "name": "-F", "description": "Search for hostname in known_hosts", "type": "string" },
+    { "name": "-H", "description": "Hash known_hosts file" },
+    { "name": "-y", "description": "Read private key and print public key" },
+    { "name": "-e", "description": "Export key to other formats" },
+    { "name": "-i", "description": "Import key from other formats" },
+    { "name": "-m", "description": "Key format (RFC4716, PKCS8, PEM)", "type": "string" },
+    { "name": "-A", "description": "Generate host keys for all default key types" },
+    { "name": "-q", "description": "Quiet mode" },
+    { "name": "-o", "description": "Use new OpenSSH format for private key" },
+    { "name": "-a", "description": "Number of KDF rounds for new format", "type": "number" },
+    { "name": "-s", "description": "Sign a key (for certificates)", "type": "file" },
+    { "name": "-I", "description": "Certificate identity string", "type": "string" },
+    { "name": "-n", "description": "Certificate principal(s)", "type": "string" },
+    { "name": "-V", "description": "Certificate validity interval", "type": "string" },
+    { "name": "-L", "description": "Print contents of a certificate" }
+  ],
+  "examples": [
+    "ssh-keygen -t ed25519 -C 'user@example.com'",
+    "ssh-keygen -t rsa -b 4096 -C 'user@example.com'",
+    "ssh-keygen -t ecdsa -b 521",
+    "ssh-keygen -t ed25519 -f ~/.ssh/github_key -N ''",
+    "ssh-keygen -l -f ~/.ssh/id_ed25519.pub",
+    "ssh-keygen -l -E md5 -f ~/.ssh/id_rsa.pub",
+    "ssh-keygen -y -f ~/.ssh/id_ed25519 > ~/.ssh/id_ed25519.pub",
+    "ssh-keygen -p -f ~/.ssh/id_rsa",
+    "ssh-keygen -R hostname",
+    "ssh-keygen -F hostname",
+    "ssh-keygen -H",
+    "ssh-keygen -t ed25519 -a 100",
+    "ssh-keygen -s ca_key -I user_key -n user1,user2 -V +52w user_key.pub",
+    "ssh-keygen -L -f certificate.pub"
+  ],
+  "relatedCommands": ["ssh", "ssh-agent", "ssh-copy-id", "ssh-add", "scp", "openssl"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "ssh_keys",
+        "description": "SSH key files in ~/.ssh/",
+        "command": "ls -1 ~/.ssh/id_* 2>/dev/null | grep -v '\\.pub$'",
+        "parser": "lines",
+        "cacheFor": 300,
+        "requiresCmd": "ssh-keygen"
+      },
+      {
+        "name": "ssh_public_keys",
+        "description": "Public key files in ~/.ssh/",
+        "command": "ls -1 ~/.ssh/*.pub 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 300,
+        "requiresCmd": "ssh-keygen"
+      },
+      {
+        "name": "key_fingerprints",
+        "description": "Fingerprints of all SSH keys",
+        "command": "for f in ~/.ssh/id_*.pub; do ssh-keygen -l -f \"$f\" 2>/dev/null; done",
+        "parser": "lines",
+        "cacheFor": 300,
+        "requiresCmd": "ssh-keygen"
+      },
+      {
+        "name": "ssh_config_hosts",
+        "description": "Hosts defined in SSH config",
+        "command": "grep -E '^Host[[:space:]]' ~/.ssh/config 2>/dev/null | awk '{for(i=2;i<=NF;i++) print $i}' | grep -v '[*?]'",
+        "parser": "lines",
+        "cacheFor": 60,
+        "requiresCmd": "ssh-keygen"
+      },
+      {
+        "name": "known_hosts_count",
+        "description": "Number of entries in known_hosts",
+        "command": "wc -l < ~/.ssh/known_hosts 2>/dev/null || echo '0'",
+        "parser": "text",
+        "cacheFor": 60,
+        "requiresCmd": "ssh-keygen"
+      },
+      {
+        "name": "ssh_agent_keys",
+        "description": "Keys currently loaded in ssh-agent",
+        "command": "ssh-add -l 2>/dev/null || echo 'agent not running'",
+        "parser": "lines",
+        "cacheFor": 30,
+        "requiresCmd": "ssh-keygen"
+      },
+      {
+        "name": "authorized_keys",
+        "description": "Number of authorized keys for incoming SSH",
+        "command": "wc -l < ~/.ssh/authorized_keys 2>/dev/null || echo '0'",
+        "parser": "text",
+        "cacheFor": 120,
+        "requiresCmd": "ssh-keygen"
+      }
+    ]
+  }
+}

package/data/commands/ssh.json

@@ -0,0 +1,37 @@
+{
+  "name": "ssh",
+  "description": "OpenSSH remote login client",
+  "category": "networking",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "fish", "powershell"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "-p", "description": "Port to connect to", "type": "number" },
+    { "name": "-i", "description": "Identity file (private key)", "type": "file" },
+    { "name": "-l", "description": "Login name", "type": "string" },
+    { "name": "-L", "description": "Local port forwarding (local:host:remote)", "type": "string" },
+    { "name": "-R", "description": "Remote port forwarding (remote:host:local)", "type": "string" },
+    { "name": "-D", "description": "Dynamic SOCKS proxy port", "type": "number" },
+    { "name": "-N", "description": "Don't execute remote command" },
+    { "name": "-f", "description": "Go to background before command execution" },
+    { "name": "-v", "description": "Verbose mode" },
+    { "name": "-o", "description": "Specify option (key=value)", "type": "string" },
+    { "name": "-A", "description": "Enable agent forwarding" },
+    { "name": "-X", "description": "Enable X11 forwarding" },
+    { "name": "-C", "description": "Enable compression" },
+    { "name": "-J", "description": "ProxyJump (jump host)", "type": "string" },
+    { "name": "-t", "description": "Force pseudo-terminal allocation" },
+    { "name": "-q", "description": "Quiet mode" }
+  ],
+  "examples": [
+    "ssh user@hostname",
+    "ssh -p 2222 user@hostname",
+    "ssh -i ~/.ssh/mykey.pem user@hostname",
+    "ssh -L 8080:localhost:80 user@hostname",
+    "ssh -R 9090:localhost:3000 user@hostname",
+    "ssh -D 1080 user@hostname",
+    "ssh -J jumphost user@destination",
+    "ssh user@hostname 'ls -la /var/log'"
+  ],
+  "relatedCommands": ["scp", "sftp", "ssh-keygen", "ssh-copy-id", "ssh-agent", "rsync", "mosh"]
+}

package/data/commands/sudo.json

@@ -0,0 +1,147 @@
+{
+  "name": "sudo",
+  "description": "Execute a command as another user (typically root) with elevated privileges",
+  "category": "coreutils",
+  "platforms": ["linux", "macos"],
+  "shells": ["bash", "zsh", "fish"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "-u", "description": "Run command as specified user", "type": "string" },
+    { "name": "-g", "description": "Run command as specified group", "type": "string" },
+    { "name": "-i", "description": "Run the shell specified as login shell" },
+    { "name": "-s", "description": "Run the shell specified in SHELL env variable" },
+    { "name": "-l", "description": "List allowed (and forbidden) commands" },
+    { "name": "-k", "description": "Invalidate the user's cached credentials" },
+    { "name": "-K", "description": "Remove user's cached credentials entirely" },
+    { "name": "-v", "description": "Update the user's cached credentials (extend timeout)" },
+    { "name": "-n", "description": "Non-interactive mode (fail instead of prompting)" },
+    { "name": "-b", "description": "Run command in the background" },
+    { "name": "-E", "description": "Preserve user environment variables" },
+    { "name": "-H", "description": "Set HOME variable to target user's home" },
+    { "name": "-S", "description": "Read password from standard input" },
+    { "name": "-p", "description": "Custom password prompt", "type": "string" },
+    { "name": "--preserve-env", "description": "Preserve specified environment variables", "type": "string" },
+    { "name": "-e", "description": "Edit files (sudoedit)", "type": "file" }
+  ],
+  "examples": [
+    "sudo apt update",
+    "sudo apt install nginx",
+    "sudo systemctl restart nginx",
+    "sudo -i",
+    "sudo -s",
+    "sudo -u postgres psql",
+    "sudo -u www-data whoami",
+    "sudo -l",
+    "sudo -k",
+    "sudo visudo",
+    "sudo -E env",
+    "sudo bash -c 'echo hello > /etc/motd'",
+    "sudo tee /etc/myconfig.conf <<< 'setting=value'",
+    "sudo chown root:root /etc/config",
+    "sudo chmod 644 /etc/config",
+    "echo 'password' | sudo -S command",
+    "sudo !!",
+    "sudo -n /usr/bin/command"
+  ],
+  "relatedCommands": ["su", "doas", "visudo", "chown", "chmod", "systemctl"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "current_user",
+        "description": "Current user information",
+        "command": "id",
+        "parser": "text",
+        "cacheFor": 300,
+        "requiresCmd": "sudo"
+      },
+      {
+        "name": "sudo_privileges",
+        "description": "Commands the current user can run via sudo",
+        "command": "sudo -l 2>/dev/null | tail -20",
+        "parser": "lines",
+        "cacheFor": 120,
+        "requiresCmd": "sudo"
+      },
+      {
+        "name": "os_info",
+        "description": "Operating system information",
+        "command": "cat /etc/os-release 2>/dev/null | grep -E '^(NAME|VERSION_ID|ID)=' | head -3",
+        "parser": "keyvalue",
+        "cacheFor": 3600,
+        "requiresCmd": "sudo"
+      },
+      {
+        "name": "package_manager",
+        "description": "Detect installed package manager",
+        "command": "command -v apt >/dev/null && echo 'apt (Debian/Ubuntu)' || command -v dnf >/dev/null && echo 'dnf (Fedora/RHEL)' || command -v yum >/dev/null && echo 'yum (CentOS/RHEL)' || command -v pacman >/dev/null && echo 'pacman (Arch)' || command -v brew >/dev/null && echo 'brew (macOS)' || echo 'unknown'",
+        "parser": "text",
+        "cacheFor": 3600,
+        "requiresCmd": "sudo"
+      },
+      {
+        "name": "running_services",
+        "description": "Active system services",
+        "command": "systemctl list-units --type=service --state=running --no-pager --no-legend 2>/dev/null | head -20 | awk '{print $1}'",
+        "parser": "lines",
+        "cacheFor": 30,
+        "requiresCmd": "systemctl"
+      },
+      {
+        "name": "failed_services",
+        "description": "Failed system services",
+        "command": "systemctl list-units --type=service --state=failed --no-pager --no-legend 2>/dev/null | awk '{print $1}'",
+        "parser": "lines",
+        "cacheFor": 30,
+        "requiresCmd": "systemctl"
+      },
+      {
+        "name": "system_users",
+        "description": "System users with login shell",
+        "command": "awk -F: '$7 !~ /(nologin|false)$/ {print $1}' /etc/passwd 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 300,
+        "requiresCmd": "sudo"
+      },
+      {
+        "name": "network_interfaces",
+        "description": "Network interfaces and IP addresses",
+        "command": "ip -br addr 2>/dev/null || ifconfig 2>/dev/null | grep -E '(^[a-z]|inet )' | head -20",
+        "parser": "lines",
+        "cacheFor": 60,
+        "requiresCmd": "sudo"
+      },
+      {
+        "name": "firewall_status",
+        "description": "Firewall status (ufw or firewalld)",
+        "command": "ufw status 2>/dev/null || firewall-cmd --state 2>/dev/null || iptables -L -n 2>/dev/null | head -5 || echo 'no firewall detected'",
+        "parser": "lines",
+        "cacheFor": 60,
+        "requiresCmd": "sudo"
+      },
+      {
+        "name": "disk_space",
+        "description": "Disk space usage overview",
+        "command": "df -h 2>/dev/null | grep -E '^(/dev|tmpfs)' | head -10",
+        "parser": "lines",
+        "cacheFor": 60,
+        "requiresCmd": "df"
+      },
+      {
+        "name": "memory_usage",
+        "description": "Memory usage overview",
+        "command": "free -h 2>/dev/null | head -3",
+        "parser": "lines",
+        "cacheFor": 15,
+        "requiresCmd": "free"
+      },
+      {
+        "name": "uptime",
+        "description": "System uptime and load average",
+        "command": "uptime",
+        "parser": "text",
+        "cacheFor": 30,
+        "requiresCmd": "sudo"
+      }
+    ]
+  }
+}

package/data/commands/supabase.json

@@ -0,0 +1,108 @@
+{
+  "name": "supabase",
+  "description": "Supabase CLI for managing Supabase projects locally and in the cloud",
+  "category": "Cloud CLIs",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "powershell", "fish"],
+  "subcommands": [
+    { "name": "init", "description": "Initialize a Supabase project" },
+    { "name": "start", "description": "Start local Supabase stack", "options": [{ "name": "--ignore-health-check", "description": "Skip health check" }] },
+    { "name": "stop", "description": "Stop local Supabase stack", "options": [{ "name": "--backup", "description": "Backup local database" }] },
+    { "name": "status", "description": "Show local Supabase status" },
+    { "name": "login", "description": "Log in to Supabase" },
+    { "name": "link", "description": "Link to a remote Supabase project", "options": [{ "name": "--project-ref", "description": "Project reference ID", "takesValue": true }] },
+    { "name": "db", "description": "Manage database", "subcommands": [
+      { "name": "push", "description": "Push local migrations to remote database", "options": [{ "name": "--dry-run", "description": "Print SQL without executing" }] },
+      { "name": "pull", "description": "Pull remote schema changes", "options": [{ "name": "--schema", "shorthand": "-s", "description": "Schemas to pull", "takesValue": true }] },
+      { "name": "reset", "description": "Reset local database to clean state" },
+      { "name": "diff", "description": "Show diff between local and remote", "options": [{ "name": "--schema", "shorthand": "-s", "description": "Schemas to diff", "takesValue": true }, { "name": "--file", "shorthand": "-f", "description": "Save diff to file", "takesValue": true }] },
+      { "name": "dump", "description": "Dump database to file", "options": [{ "name": "--data-only", "description": "Dump only data" }, { "name": "--file", "shorthand": "-f", "description": "Output file", "takesValue": true }] },
+      { "name": "lint", "description": "Lint local database for errors" }
+    ]},
+    { "name": "migration", "description": "Manage migrations", "subcommands": [
+      { "name": "new", "description": "Create a new migration", "args": [{ "name": "name", "description": "Migration name", "required": true }] },
+      { "name": "list", "description": "List migrations" },
+      { "name": "repair", "description": "Repair migration history", "options": [{ "name": "--status", "description": "Set migration status", "takesValue": true }] },
+      { "name": "squash", "description": "Squash migrations", "options": [{ "name": "--version", "description": "Target version", "takesValue": true }] }
+    ]},
+    { "name": "functions", "description": "Manage Edge Functions", "subcommands": [
+      { "name": "new", "description": "Create a new function", "args": [{ "name": "name", "description": "Function name", "required": true }] },
+      { "name": "serve", "description": "Serve functions locally", "options": [{ "name": "--env-file", "description": "Path to env file", "takesValue": true }] },
+      { "name": "deploy", "description": "Deploy functions", "args": [{ "name": "name", "description": "Function name", "required": false }], "options": [{ "name": "--no-verify-jwt", "description": "Disable JWT verification" }] },
+      { "name": "delete", "description": "Delete a function", "args": [{ "name": "name", "description": "Function name", "required": true }] }
+    ]},
+    { "name": "secrets", "description": "Manage secrets", "subcommands": [
+      { "name": "list", "description": "List all secrets" },
+      { "name": "set", "description": "Set secrets from stdin or env file", "options": [{ "name": "--env-file", "description": "Load from env file", "takesValue": true }] },
+      { "name": "unset", "description": "Unset secrets", "args": [{ "name": "names", "description": "Secret names", "required": true }] }
+    ]},
+    { "name": "gen", "description": "Generate types and keys", "subcommands": [
+      { "name": "types", "description": "Generate TypeScript types", "subcommands": [
+        { "name": "typescript", "description": "Generate TS types from schema", "options": [{ "name": "--local", "description": "Use local database" }, { "name": "--linked", "description": "Use linked project" }, { "name": "--schema", "shorthand": "-s", "description": "Schemas to include", "takesValue": true }] }
+      ]},
+      { "name": "keys", "description": "Generate project API keys" }
+    ]},
+    { "name": "projects", "description": "Manage Supabase projects", "subcommands": [
+      { "name": "list", "description": "List all projects" },
+      { "name": "create", "description": "Create a new project", "args": [{ "name": "name", "description": "Project name", "required": true }], "options": [{ "name": "--org-id", "description": "Organization ID", "takesValue": true }, { "name": "--db-password", "description": "Database password", "takesValue": true }, { "name": "--region", "description": "Region", "takesValue": true }] }
+    ]},
+    { "name": "orgs", "description": "Manage organizations", "subcommands": [
+      { "name": "list", "description": "List organizations" }
+    ]}
+  ],
+  "globalOptions": [
+    { "name": "--debug", "description": "Enable debug output" },
+    { "name": "--workdir", "description": "Working directory", "takesValue": true },
+    { "name": "--help", "shorthand": "-h", "description": "Show help" }
+  ],
+  "examples": [
+    { "command": "supabase init", "description": "Initialize new Supabase project" },
+    { "command": "supabase start", "description": "Start local dev stack" },
+    { "command": "supabase db push", "description": "Push migrations to remote" },
+    { "command": "supabase migration new add_users_table", "description": "Create a new migration" },
+    { "command": "supabase gen types typescript --local > types/supabase.ts", "description": "Generate TypeScript types" },
+    { "command": "supabase functions deploy my-function", "description": "Deploy an edge function" }
+  ],
+  "relatedCommands": ["firebase", "psql"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "local_status",
+        "description": "Local Supabase status",
+        "command": "supabase status 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 30,
+        "requiresCmd": "supabase"
+      },
+      {
+        "name": "projects",
+        "description": "Linked Supabase projects",
+        "command": "supabase projects list 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 300,
+        "requiresCmd": "supabase"
+      },
+      {
+        "name": "migrations",
+        "description": "Database migrations",
+        "command": "ls -1 supabase/migrations/*.sql 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 30
+      },
+      {
+        "name": "edge_functions",
+        "description": "Edge functions",
+        "command": "ls -1d supabase/functions/*/ 2>/dev/null | xargs -I{} basename {}",
+        "parser": "lines",
+        "cacheFor": 30
+      },
+      {
+        "name": "config",
+        "description": "Supabase config",
+        "command": "cat supabase/config.toml 2>/dev/null | head -30",
+        "parser": "text",
+        "cacheFor": 60
+      }
+    ]
+  }
+}