@enjoys/context-engine 1.0.1 → 1.0.2

package/data/commands/nvim.json

@@ -0,0 +1,91 @@
+{
+  "name": "nvim",
+  "description": "Neovim - hyperextensible Vim-based text editor with Lua scripting, built-in LSP, and modern terminal features",
+  "category": "Text Editors",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "fish", "powershell"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "--help", "shorthand": "-h", "description": "Show usage summary and exit" },
+    { "name": "--version", "shorthand": "-v", "description": "Print version information and exit" },
+    { "name": "-c", "description": "Execute an Ex command after loading the first file", "takesValue": true },
+    { "name": "--cmd", "description": "Execute an Ex command before loading any config", "takesValue": true },
+    { "name": "-S", "description": "Source (execute) a Vim/Lua script file after loading the first file", "takesValue": true },
+    { "name": "-u", "description": "Use specified init file instead of default init.vim/init.lua (NONE to skip)", "takesValue": true },
+    { "name": "-N", "description": "Start in nocompatible mode (always enabled in Neovim, accepted for compatibility)" },
+    { "name": "-R", "description": "Read-only mode - set 'readonly' option" },
+    { "name": "-b", "description": "Binary mode - set options for editing binary files" },
+    { "name": "-d", "description": "Diff mode - open files and show differences" },
+    { "name": "-o", "description": "Open N files in horizontally split windows", "takesValue": true },
+    { "name": "-O", "description": "Open N files in vertically split windows", "takesValue": true },
+    { "name": "-p", "description": "Open N files in separate tab pages", "takesValue": true },
+    { "name": "-r", "description": "Recovery mode - recover a file from swap file", "takesValue": true },
+    { "name": "-n", "description": "No swap file - do not create .swp files" },
+    { "name": "-e", "description": "Start in Ex mode (line-oriented editing)" },
+    { "name": "-s", "description": "Silent (batch) mode - read Normal mode commands from a file", "takesValue": true },
+    { "name": "--noplugin", "description": "Skip loading all plugins" },
+    { "name": "--clean", "description": "Start with default settings, no config, no plugins (mimics factory defaults)" },
+    { "name": "-t", "description": "Jump to a tag", "takesValue": true },
+    { "name": "+", "description": "Start at the end of the file" },
+    { "name": "+N", "description": "Start at line number N", "takesValue": true },
+    { "name": "+/pattern", "description": "Start at the first occurrence of search pattern", "takesValue": true },
+    { "name": "--headless", "description": "Start without a UI (for scripting, LSP, automation)" },
+    { "name": "--listen", "description": "Start an RPC server listening on the given address (pipe or TCP)", "takesValue": true },
+    { "name": "--remote", "description": "Edit files in an already running Neovim instance via --listen address", "takesValue": true },
+    { "name": "--embed", "description": "Use stdin/stdout as an msgpack-RPC channel (for GUI frontends)" },
+    { "name": "--startuptime", "description": "Write startup timing messages to specified file", "takesValue": true },
+    { "name": "--api-info", "description": "Print msgpack-encoded API metadata to stdout and exit" },
+    { "name": "-l", "description": "Execute a Lua script (non-editor mode, Neovim acts as Lua interpreter)", "takesValue": true },
+    { "name": "-ll", "description": "Execute a Lua module (like require('module'), non-editor mode)", "takesValue": true },
+    { "name": "-i", "description": "Use specified ShaDa (shared data) file instead of default", "takesValue": true },
+    { "name": "-V", "description": "Verbose mode - set verbosity level for debugging", "takesValue": true },
+    { "name": "-w", "description": "Record all typed characters to a script file (append)", "takesValue": true },
+    { "name": "-W", "description": "Record all typed characters to a script file (overwrite)", "takesValue": true },
+    { "name": "--luamod-dev", "description": "Enable Lua module development mode (add cwd to package.path)" }
+  ],
+  "examples": [
+    { "command": "nvim file.txt", "description": "Open a file for editing" },
+    { "command": "nvim --headless -c 'q'", "description": "Start headless and quit (verify startup works)" },
+    { "command": "nvim -d file1 file2", "description": "Open two files in diff mode" },
+    { "command": "nvim --listen /tmp/nvim.sock", "description": "Start Neovim as an RPC server on a Unix socket" },
+    { "command": "nvim --startuptime startup.log file.txt", "description": "Profile startup time and save to log" },
+    { "command": "nvim -l script.lua", "description": "Execute a Lua script using Neovim as interpreter" },
+    { "command": "nvim -o file1 file2", "description": "Open files in horizontal splits" },
+    { "command": "nvim -p *.py", "description": "Open all Python files in tabs" },
+    { "command": "nvim +42 file.txt", "description": "Open file and jump to line 42" },
+    { "command": "nvim --clean file.txt", "description": "Open file with no config or plugins" },
+    { "command": "nvim -c 'set number' -c 'colorscheme desert' file.txt", "description": "Open file with line numbers and a colorscheme" },
+    { "command": "nvim --headless -c 'TSInstall python' -c 'q'", "description": "Install a Treesitter parser headlessly" },
+    { "command": "nvim --remote file.txt", "description": "Open file in an already running Neovim instance" },
+    { "command": "nvim -ll luamodule", "description": "Execute a Lua module in non-editor mode" }
+  ],
+  "relatedCommands": ["vim", "vi", "nano", "emacs"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "version",
+        "description": "Neovim version and build info",
+        "command": "nvim --version 2>/dev/null | head -3",
+        "parser": "lines",
+        "cacheFor": 600,
+        "requiresCmd": "nvim"
+      },
+      {
+        "name": "config",
+        "description": "Detect Neovim config location",
+        "command": "ls ~/.config/nvim/init.lua 2>/dev/null || ls ~/.config/nvim/init.vim 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 300,
+        "requiresCmd": "nvim"
+      },
+      {
+        "name": "plugins",
+        "description": "Detect plugin manager and installed plugins",
+        "command": "ls ~/.local/share/nvim/lazy/ 2>/dev/null | head -15 || ls ~/.local/share/nvim/site/pack/*/start/ 2>/dev/null | head -15",
+        "parser": "lines",
+        "cacheFor": 300,
+        "requiresCmd": "nvim"
+      }
+    ]
+  }
+}

package/data/commands/screen.json

@@ -0,0 +1,101 @@
+{
+  "name": "screen",
+  "description": "GNU Screen terminal multiplexer - manage multiple terminal sessions within a single window",
+  "category": "Terminal Multiplexers",
+  "platforms": ["linux", "macos"],
+  "shells": ["bash", "zsh", "fish"],
+  "subcommands": [
+    { "name": "-S", "description": "Create a new named session", "args": [{ "name": "session_name", "description": "Name for the new screen session", "required": true }], "options": [
+      { "name": "-d", "description": "Detach the session elsewhere before attaching" },
+      { "name": "-m", "description": "Force creation of a new session (ignore $STY)" },
+      { "name": "-A", "description": "Adapt window sizes to current terminal" },
+      { "name": "-L", "description": "Enable output logging to screenlog.N files" },
+      { "name": "-T", "description": "Set terminal type for the session", "takesValue": true }
+    ]},
+    { "name": "-r", "description": "Reattach to a detached session", "args": [{ "name": "session", "description": "Session name or PID to reattach to", "required": false }], "options": [
+      { "name": "-d", "description": "Detach the session first if attached elsewhere" },
+      { "name": "-D", "description": "Detach and logout remote session before reattaching" },
+      { "name": "-e", "description": "Change command character (default: ^Aa)", "takesValue": true },
+      { "name": "-p", "description": "Preselect a named window", "takesValue": true }
+    ]},
+    { "name": "-d", "description": "Detach a running session remotely", "args": [{ "name": "session", "description": "Session name or PID to detach", "required": false }], "options": [
+      { "name": "-r", "description": "Reattach after detaching" },
+      { "name": "-R", "description": "Reattach if possible, otherwise start new session" },
+      { "name": "-RR", "description": "Use the first session if multiple detached" }
+    ]},
+    { "name": "-ls", "description": "List all screen sessions and their states", "options": [
+      { "name": "-S", "description": "Filter listed sessions by name prefix", "takesValue": true }
+    ]},
+    { "name": "-x", "description": "Multiattach - attach to an already attached session (shared screen)", "args": [{ "name": "session", "description": "Session name or PID to multi-attach to", "required": false }], "options": [
+      { "name": "-S", "description": "Specify session name", "takesValue": true },
+      { "name": "-p", "description": "Preselect a named window", "takesValue": true },
+      { "name": "-r", "description": "Reattach if session is detached instead" }
+    ]},
+    { "name": "-X", "description": "Send a command to a running session", "args": [{ "name": "command", "description": "Screen command to execute (e.g., quit, stuff, select)", "required": true }], "options": [
+      { "name": "-S", "description": "Target session name", "takesValue": true },
+      { "name": "-p", "description": "Target window number or name", "takesValue": true },
+      { "name": "-Q", "description": "Send command and wait for query response" }
+    ]}
+  ],
+  "globalOptions": [
+    { "name": "--help", "shorthand": "-h", "description": "Show usage information" },
+    { "name": "--version", "shorthand": "-v", "description": "Print version and compile date" },
+    { "name": "-S", "description": "Specify session name", "takesValue": true },
+    { "name": "-r", "description": "Reattach to a detached session", "takesValue": true },
+    { "name": "-R", "description": "Reattach or create session if none exists" },
+    { "name": "-d", "description": "Detach a running session" },
+    { "name": "-D", "description": "Detach and logout" },
+    { "name": "-ls", "description": "List all screen sessions" },
+    { "name": "-list", "description": "Same as -ls" },
+    { "name": "-x", "description": "Multi-attach to an attached session" },
+    { "name": "-X", "description": "Send a command to a named session", "takesValue": true },
+    { "name": "-m", "description": "Ignore $STY, create a new session" },
+    { "name": "-c", "description": "Use specified screenrc file instead of default", "takesValue": true },
+    { "name": "-e", "description": "Change command characters (default ^Aa)", "takesValue": true },
+    { "name": "-fn", "description": "Turn off flow control" },
+    { "name": "-fa", "description": "Turn on automatic flow control" },
+    { "name": "-A", "description": "Adapt all windows to current terminal size" },
+    { "name": "-L", "description": "Turn on output logging" },
+    { "name": "-Logfile", "description": "Set logfile name", "takesValue": true },
+    { "name": "-p", "description": "Preselect a window", "takesValue": true },
+    { "name": "-q", "description": "Quiet mode, suppress error messages" },
+    { "name": "-Q", "description": "Query a running session command and return result" },
+    { "name": "-t", "description": "Set window title", "takesValue": true },
+    { "name": "-T", "description": "Set terminal type ($TERM)", "takesValue": true },
+    { "name": "-U", "description": "Run in UTF-8 mode" },
+    { "name": "-wipe", "description": "Remove dead sessions instead of listing them" }
+  ],
+  "examples": [
+    { "command": "screen -S mysession", "description": "Start a new named session called 'mysession'" },
+    { "command": "screen -r mysession", "description": "Reattach to the detached session 'mysession'" },
+    { "command": "screen -ls", "description": "List all screen sessions" },
+    { "command": "screen -d -r", "description": "Detach elsewhere and reattach here" },
+    { "command": "screen -X quit", "description": "Send quit command to a running session" },
+    { "command": "screen -x mysession", "description": "Multi-attach to 'mysession' (shared viewing)" },
+    { "command": "screen -d -m -S bg_task ./long_script.sh", "description": "Start a detached session running a script" },
+    { "command": "screen -S mysession -X stuff 'ls\\n'", "description": "Type 'ls' and Enter into a running session" },
+    { "command": "screen -wipe", "description": "Clean up dead screen sessions" },
+    { "command": "screen -r -d mysession", "description": "Force detach from elsewhere and reattach here" }
+  ],
+  "relatedCommands": ["tmux"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "version",
+        "description": "Screen version",
+        "command": "screen --version 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 600,
+        "requiresCmd": "screen"
+      },
+      {
+        "name": "sessions",
+        "description": "Active screen sessions",
+        "command": "screen -ls 2>/dev/null | grep -E '\\(|Socket'",
+        "parser": "lines",
+        "cacheFor": 30,
+        "requiresCmd": "screen"
+      }
+    ]
+  }
+}

package/data/commands/top.json

@@ -0,0 +1,61 @@
+{
+  "name": "top",
+  "description": "Display and manage Linux processes in real-time with an interactive full-screen interface",
+  "category": "System Monitoring",
+  "platforms": ["linux", "macos"],
+  "shells": ["bash", "zsh", "fish"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "-h", "description": "Show usage information and exit" },
+    { "name": "-v", "description": "Show version info and exit" },
+    { "name": "-b", "description": "Batch mode - send output to stdout or file (useful for scripting, no interactive input)" },
+    { "name": "-c", "description": "Toggle full command line display vs. program name only" },
+    { "name": "-d", "description": "Delay time interval in seconds between screen updates (supports fractional seconds)", "takesValue": true },
+    { "name": "-H", "description": "Show individual threads instead of aggregating by process" },
+    { "name": "-i", "description": "Toggle idle process display - when set, tasks that have not used any CPU since the last update are hidden" },
+    { "name": "-n", "description": "Maximum number of iterations (refreshes) before exiting", "takesValue": true },
+    { "name": "-o", "description": "Sort by specified field name (e.g., %CPU, %MEM, TIME+, RES, PID)", "takesValue": true },
+    { "name": "-O", "description": "Print all available sort field names and exit" },
+    { "name": "-p", "description": "Monitor only processes with specified PIDs (comma-separated, max 20)", "takesValue": true },
+    { "name": "-u", "description": "Show only processes owned by the specified user (name or UID)", "takesValue": true },
+    { "name": "-U", "description": "Show only processes owned by the specified user (matches real, effective, saved, filesystem UID)", "takesValue": true },
+    { "name": "-1", "description": "Toggle single/separate CPU states display (show per-CPU stats)" },
+    { "name": "-E", "description": "Scale summary area memory units (k, m, g, t, p, e)", "takesValue": true },
+    { "name": "-e", "description": "Scale task area memory units (k, m, g, t, p, e)", "takesValue": true },
+    { "name": "-w", "description": "Set output width (in batch mode); without value uses 512 columns", "takesValue": true },
+    { "name": "-S", "description": "Toggle cumulative time mode (include dead child process time)" }
+  ],
+  "examples": [
+    { "command": "top", "description": "Launch interactive process viewer" },
+    { "command": "top -b -n 1", "description": "Batch mode with single iteration (for scripting)" },
+    { "command": "top -u www-data", "description": "Show only processes owned by www-data" },
+    { "command": "top -p 1234,5678", "description": "Monitor specific processes by PID" },
+    { "command": "top -o %MEM", "description": "Sort processes by memory usage" },
+    { "command": "top -d 5", "description": "Update display every 5 seconds" },
+    { "command": "top -b -n 5 -d 2 > top_output.txt", "description": "Capture 5 iterations at 2s intervals to a file" },
+    { "command": "top -H -p 1234", "description": "Show threads for a specific process" },
+    { "command": "top -1", "description": "Show individual CPU core statistics" },
+    { "command": "top -c -b -n 1 | head -30", "description": "Show full command lines in batch mode" }
+  ],
+  "relatedCommands": ["htop", "btop", "ps", "vmstat", "iostat"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "version",
+        "description": "top version information",
+        "command": "top -v 2>&1 | head -1",
+        "parser": "lines",
+        "cacheFor": 600,
+        "requiresCmd": "top"
+      },
+      {
+        "name": "snapshot",
+        "description": "Current top snapshot summary",
+        "command": "top -b -n 1 2>/dev/null | head -5",
+        "parser": "lines",
+        "cacheFor": 30,
+        "requiresCmd": "top"
+      }
+    ]
+  }
+}

package/data/commands/vim.json

@@ -0,0 +1,85 @@
+{
+  "name": "vim",
+  "description": "Vi IMproved - a highly configurable, powerful text editor for efficient text editing",
+  "category": "Text Editors",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "fish", "powershell"],
+  "subcommands": [],
+  "globalOptions": [
+    { "name": "--help", "description": "Show usage summary and exit" },
+    { "name": "--version", "description": "Print version and feature information, then exit" },
+    { "name": "-c", "description": "Execute given Ex command after loading the first file", "takesValue": true },
+    { "name": "--cmd", "description": "Execute given Ex command before loading any vimrc", "takesValue": true },
+    { "name": "-S", "description": "Source (execute) a Vim script file after loading the first file", "takesValue": true },
+    { "name": "-u", "description": "Use specified vimrc file instead of default (use NONE to skip all)", "takesValue": true },
+    { "name": "-N", "description": "Start in nocompatible mode (not Vi compatible)" },
+    { "name": "-R", "description": "Read-only mode - set 'readonly' option to prevent accidental writes" },
+    { "name": "-b", "description": "Binary mode - set options for editing binary files" },
+    { "name": "-d", "description": "Diff mode - open two or more files and show differences side by side" },
+    { "name": "-o", "description": "Open N files in horizontally split windows (one above the other)", "takesValue": true },
+    { "name": "-O", "description": "Open N files in vertically split windows (side by side)", "takesValue": true },
+    { "name": "-p", "description": "Open N files in separate tab pages", "takesValue": true },
+    { "name": "-r", "description": "Recovery mode - recover a previously edited file from swap file", "takesValue": true },
+    { "name": "-n", "description": "No swap file - editing will not create a .swp file (for fast editing of temp files)" },
+    { "name": "-e", "description": "Start in Ex mode (line-oriented editing, like running ex)" },
+    { "name": "-s", "description": "Silent (batch) mode - used with -e for scripted Ex commands from stdin" },
+    { "name": "-x", "description": "Encryption mode - prompt for an encryption key to encrypt the file on save" },
+    { "name": "--noplugin", "description": "Skip loading all plugins (plugin scripts are not sourced)" },
+    { "name": "--clean", "description": "Start Vim with default settings and no plugins (like -u DEFAULTS --noplugin)" },
+    { "name": "-t", "description": "Jump to a tag - find the tag in the tags file and position cursor there", "takesValue": true },
+    { "name": "+", "description": "Start at the end of the file" },
+    { "name": "+N", "description": "Start at line number N", "takesValue": true },
+    { "name": "+/pattern", "description": "Start at the first occurrence of search pattern", "takesValue": true },
+    { "name": "-i", "description": "Use specified viminfo file instead of default", "takesValue": true },
+    { "name": "-V", "description": "Verbose mode - set verbosity level (0-15) for debugging", "takesValue": true },
+    { "name": "-w", "description": "Record all typed characters to a script file", "takesValue": true },
+    { "name": "-W", "description": "Overwrite and record all typed characters to a script file", "takesValue": true },
+    { "name": "-Z", "description": "Restricted mode - disable shell commands and external programs" },
+    { "name": "--remote", "description": "Open files in an already running Vim server", "takesValue": true },
+    { "name": "--servername", "description": "Set the Vim server name for --remote communication", "takesValue": true }
+  ],
+  "examples": [
+    { "command": "vim file.txt", "description": "Open a file for editing" },
+    { "command": "vim -d file1 file2", "description": "Open two files in diff mode (vimdiff)" },
+    { "command": "vim -o file1 file2", "description": "Open files in horizontal splits" },
+    { "command": "vim -O file1 file2", "description": "Open files in vertical splits" },
+    { "command": "vim +42 file.txt", "description": "Open file and jump to line 42" },
+    { "command": "vim -c 'set number' file.txt", "description": "Open file with line numbers enabled" },
+    { "command": "vim -R /etc/passwd", "description": "Open file in read-only mode" },
+    { "command": "vim -p *.js", "description": "Open all JS files in separate tabs" },
+    { "command": "vim -r file.txt", "description": "Recover file from swap file after a crash" },
+    { "command": "vim --clean file.txt", "description": "Open file with no plugins or custom config" },
+    { "command": "vim -u NONE -N file.txt", "description": "Open file with no vimrc in nocompatible mode" },
+    { "command": "vim +/TODO file.txt", "description": "Open file and jump to first 'TODO'" },
+    { "command": "vim -b binary.dat", "description": "Open a binary file in binary mode" }
+  ],
+  "relatedCommands": ["nvim", "vi", "nano", "emacs"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "version",
+        "description": "Vim version and patch level",
+        "command": "vim --version 2>/dev/null | head -2",
+        "parser": "lines",
+        "cacheFor": 600,
+        "requiresCmd": "vim"
+      },
+      {
+        "name": "features",
+        "description": "Compiled Vim features",
+        "command": "vim --version 2>/dev/null | grep -E '^\\+|^-' | head -5",
+        "parser": "lines",
+        "cacheFor": 600,
+        "requiresCmd": "vim"
+      },
+      {
+        "name": "vimrc",
+        "description": "Detect user vimrc location",
+        "command": "ls ~/.vimrc 2>/dev/null || ls ~/.vim/vimrc 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 300,
+        "requiresCmd": "vim"
+      }
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enjoys/context-engine",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Comprehensive CLI command context engine with 133 tools — subcommands, options, examples, and runtime context detectors for intelligent terminal autocomplete",
   "main": "index.js",
   "types": "index.d.ts",