path: root/cards.jsonl

{"id":"glxinfo_opengl_renderer","intent":["show which GPU OpenGL is using","see OpenGL renderer","check OpenGL vendor and renderer","find what graphics device OpenGL is using"],"command":"glxinfo -B","alternatives":["glxinfo | grep \"OpenGL\""],"explanation":"Shows the OpenGL vendor, renderer, and version in a short summary.","requires":["glxinfo"],"packages":{"fedora":["mesa-demos"],"debian":["mesa-utils"], "arch":["mesa-utils"]},"tags":["gpu","opengl","graphics","diagnostics"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"vulkaninfo_gpu","intent":["show which GPU Vulkan is using","see Vulkan driver info","check Vulkan renderer","find Vulkan device information"],"command":"vulkaninfo --summary","alternatives":["vulkaninfo | grep driverName"],"explanation":"Shows a concise summary of Vulkan devices and drivers.","requires":["vulkaninfo"],"packages":{"fedora":["vulkan-tools"],"debian":["vulkan-tools"]},"tags":["gpu","vulkan","graphics","diagnostics"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"lsblk_block_devices","intent":["list disks and partitions","show block devices","see drives and partitions","inspect storage devices"],"command":"lsblk","alternatives":["lsblk -f"],"explanation":"Lists block devices such as disks, partitions, and mount points.","requires":["lsblk"],"packages":{},"tags":["disk","storage","devices"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"df_h_disk_usage","intent":["show disk free space","check filesystem usage","see disk usage by filesystem","how full are my disks"],"command":"df -h","alternatives":[],"explanation":"Shows filesystem size, used space, and available space in human-readable units.","requires":["df"],"packages":{},"tags":["disk","filesystem","space"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"du_sh_directory_size","intent":["show size of current directory","check folder size","how large is this directory","measure directory disk usage"],"command":"du -sh .","alternatives":["du -sh *"],"explanation":"Shows total size of the current directory.","requires":["du"],"packages":{},"tags":["disk","directory","size"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"find_large_files","intent":["find large files","show biggest files under current directory","locate files larger than 500MB","search for huge files"],"command":"find . -type f -size +500M","alternatives":["find /path -type f -size +1G"],"explanation":"Finds files larger than a given size.","requires":["find"],"packages":{},"tags":["find","files","disk","cleanup"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"find_name_case_insensitive","intent":["find a file by name ignoring case","search for filename case insensitive","locate file by partial name","find matching filename"],"command":"find . -iname '*pattern*'","alternatives":[],"explanation":"Searches recursively for files whose names match a case-insensitive pattern.","requires":["find"],"packages":{},"tags":["find","files","search"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"rg_text_recursive","intent":["search text recursively in files","grep through a project","find text in source tree","search contents of files fast"],"command":"rg 'pattern'","alternatives":["grep -R \"pattern\" ."],"explanation":"Searches recursively for text, usually faster and cleaner than grep -R.","requires":["rg"],"packages":{"fedora":["ripgrep"],"debian":["ripgrep"]},"tags":["search","text","grep","files","code"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"ss_listening_ports","intent":["show open listening ports","list listening sockets","see what ports are open locally","check listening network services"],"command":"ss -ltnp","alternatives":["sudo ss -ltnp"],"explanation":"Shows listening TCP sockets and associated processes when permitted.","requires":["ss"],"packages":{},"tags":["network","ports","sockets","diagnostics"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"ss_process_on_port","intent":["find process using port 8080","see what is listening on a port","which program owns port 3000","identify service bound to port"],"command":"ss -ltnp | grep ':8080'","alternatives":["sudo ss -ltnp | grep ':8080'"],"explanation":"Filters listening sockets to the requested port.","requires":["ss","grep"],"packages":{},"tags":["network","ports","process"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"ip_addr_show","intent":["show IP addresses","list network interfaces and addresses","see local IPs","inspect interface addresses"],"command":"ip addr","alternatives":["ip -brief addr"],"explanation":"Shows network interfaces and assigned IP addresses.","requires":["ip"],"packages":{},"tags":["network","ip","interfaces"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"ip_route_show","intent":["show routing table","see default route","inspect routes","what route is this host using"],"command":"ip route","alternatives":[],"explanation":"Displays the kernel routing table, including the default route.","requires":["ip"],"packages":{},"tags":["network","routing"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"ping_basic","intent":["test network reachability","ping a host","check if a machine is reachable","see if DNS and network work"],"command":"ping -c 4 example.com","alternatives":[],"explanation":"Sends a few ICMP echo requests to test reachability and latency.","requires":["ping"],"packages":{},"tags":["network","diagnostics","latency"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"curl_headers","intent":["show HTTP headers","inspect response headers from a URL","check server response headers","see HTTP status and headers"],"command":"curl -I https://example.com","alternatives":["curl -sSI https://example.com"],"explanation":"Fetches only the response headers from a URL.","requires":["curl"],"packages":{},"tags":["http","curl","headers","web"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"curl_download_file","intent":["download a file from a URL","save URL to local file","fetch a file with curl","download file without browser"],"command":"curl -LO https://example.com/file.tar.gz","alternatives":["wget https://example.com/file.tar.gz"],"explanation":"Downloads a file and saves it with the remote name.","requires":["curl"],"packages":{},"tags":["http","download","curl"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"journalctl_boot_errors","intent":["show boot errors","inspect errors from current boot","check systemd errors since boot","look at boot logs"],"command":"journalctl -b -p err","alternatives":["journalctl -b"],"explanation":"Shows error-priority messages from the current boot.","requires":["journalctl"],"packages":{},"tags":["logs","systemd","boot","errors"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"journalctl_service_follow","intent":["follow logs for a systemd service","tail service logs","watch logs from sshd","stream unit logs"],"command":"journalctl -u sshd -f","alternatives":[],"explanation":"Follows logs for a specific systemd unit in real time.","requires":["journalctl"],"packages":{},"tags":["logs","systemd","service"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"ps_grep_process","intent":["find a running process by name","check if process is running","search process list","locate process from command name"],"command":"ps aux | grep '[n]ame'","alternatives":["pgrep -a name"],"explanation":"Searches the process list while avoiding matching the grep process itself.","requires":["ps","grep"],"packages":{},"tags":["process","ps","grep"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"pgrep_full_cmdline","intent":["find process by name with pid","show pid for matching process","lookup running process and command line","find process quickly"],"command":"pgrep -a name","alternatives":[],"explanation":"Prints matching PIDs along with their command lines.","requires":["pgrep"],"packages":{},"tags":["process","pid","lookup"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"free_h_memory","intent":["show memory usage","check RAM usage","how much memory is free","inspect memory consumption summary"],"command":"free -h","alternatives":[],"explanation":"Shows total, used, and available memory in human-readable units.","requires":["free"],"packages":{},"tags":["memory","ram","diagnostics"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"top_overview","intent":["show top processes","inspect CPU usage live","watch system activity","interactive process viewer"],"command":"top","alternatives":["htop"],"explanation":"Shows a live interactive overview of processes and resource usage.","requires":["top"],"packages":{"fedora":["htop"],"debian":["htop"]},"tags":["cpu","memory","process","monitoring"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"chmod_executable","intent":["make a script executable","add execute permission to file","chmod script so it can run directly","set executable bit"],"command":"chmod +x script.sh","alternatives":[],"explanation":"Adds execute permission so the file can be run directly.","requires":["chmod"],"packages":{},"tags":["permissions","chmod","scripts"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-modifying"}
{"id":"tar_extract_gz","intent":["extract a tar.gz archive","unpack tgz file","untar compressed archive","open tarball"],"command":"tar -xvf archive.tar.gz","alternatives":["tar -xzf archive.tar.gz"],"explanation":"Extracts files from a tar archive; some users prefer -z explicitly for gzip.","requires":["tar"],"packages":{},"tags":["archive","tar","extract"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-modifying"}
{"id":"tar_create_gz","intent":["create a tar.gz archive","compress a directory into tar.gz","make a tarball","archive files into gzip tar"],"command":"tar -cvzf archive.tar.gz dir/","alternatives":[],"explanation":"Creates a gzip-compressed tar archive from a directory.","requires":["tar"],"packages":{},"tags":["archive","tar","compress"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-modifying"}
{"id":"systemctl_status_service","intent":["check status of a service","see if systemd service is running","inspect service health","show systemctl status"],"command":"systemctl status sshd","alternatives":["systemctl --no-pager status sshd"],"explanation":"Shows service state, recent logs, and unit metadata.","requires":["systemctl"],"packages":{},"tags":["systemd","service","status"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"systemctl_restart_service","intent":["restart a service","bounce systemd unit","restart sshd","reload service by restarting it"],"command":"sudo systemctl restart sshd","alternatives":["sudo systemctl try-restart sshd"],"explanation":"Restarts a systemd service; usually requires root privileges.","requires":["systemctl","sudo"],"packages":{},"tags":["systemd","service","restart"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"privileged-modifying"}
{"id":"dnf_which_package_owns_file","intent":["find which package owns a file","what rpm provides this path","determine package for installed file","lookup file owner package"],"command":"rpm -qf /path/to/file","alternatives":["dnf provides /path/to/file"],"explanation":"Shows which installed package owns a given file; dnf provides can search repos too.","requires":["rpm"],"packages":{},"tags":["package","rpm","dnf","files"],"platform":["linux","fedora"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"dnf_search_package","intent":["search for a package in dnf","find package by name or description","lookup package in repositories","search repo packages"],"command":"dnf search keyword","alternatives":[],"explanation":"Searches package metadata in enabled repositories.","requires":["dnf"],"packages":{},"tags":["package","dnf","search"],"platform":["linux","fedora"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"git_status_short","intent":["show git status briefly","check repo state","see changed files in git","short git status"],"command":"git status --short","alternatives":["git status"],"explanation":"Shows tracked and untracked file changes in a compact format.","requires":["git"],"packages":{},"tags":["git","status","repo"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"git_log_oneline_graph","intent":["show concise git history","see commit graph briefly","inspect recent commits compactly","git log one line graph"],"command":"git log --oneline --graph --decorate -n 20","alternatives":[],"explanation":"Shows a compact decorated commit graph for recent history.","requires":["git"],"packages":{},"tags":["git","history","commits"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"git_show_changed_files","intent":["show files changed in last commit","list files changed by commit","see modified files from HEAD","inspect changed paths in commit"],"command":"git show --name-only --oneline HEAD","alternatives":["git diff --name-only HEAD~1 HEAD"],"explanation":"Shows the last commit summary and the files it changed.","requires":["git"],"packages":{},"tags":["git","diff","files","commits"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"systemd_failed_units","intent":["show failed systemd units","systemctl failed units","view systemd failed services"],"command":"sudo systemctl list-units --state failed","alternatives":["sudo systemctl list-units --failed"],"explanation":"Show all units systemd has in memory, filtering the failed ones.","requires":["systemctl"],"packages":{},"tags":["systemctl","failed","service","unit"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"systemctl_reset_failed_units","intent":["clear failed systemd units","reset failed units in systemd","remove failed state from services","clear systemctl failed list"],"command":"sudo systemctl reset-failed","alternatives":["sudo systemctl reset-failed myservice.service"],"explanation":"Clears the remembered failed state for units so they disappear from the failed list after the underlying problem is fixed.","requires":["systemctl","sudo"],"packages":{},"tags":["systemd","failed","service","cleanup"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"privileged-modifying"}
{"id":"systemctl_cat_unit","intent":["show full systemd unit file","inspect systemd service definition","print merged unit contents","see drop-ins for a unit"],"command":"systemctl cat sshd","alternatives":[],"explanation":"Prints the unit file along with any drop-in configuration fragments.","requires":["systemctl"],"packages":{},"tags":["systemd","service","config"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"systemctl_show_fragment_path","intent":["find the unit file backing a systemd service","show unit fragment path","where is this systemd service file","locate service definition file"],"command":"systemctl show -p FragmentPath sshd","alternatives":["systemctl show sshd | grep '^FragmentPath='"],"explanation":"Shows the path to the primary unit file systemd loaded for the service.","requires":["systemctl"],"packages":{},"tags":["systemd","service","path","config"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"systemctl_list_timers_all","intent":["show all systemd timers","list timers and next runs","inspect timer schedule","see timer units"],"command":"systemctl list-timers --all","alternatives":[],"explanation":"Lists active and inactive timers along with their next and last run times.","requires":["systemctl"],"packages":{},"tags":["systemd","timer","schedule"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"systemd_analyze_blame","intent":["show slow boot services","find what delayed boot","systemd boot time breakdown","blame boot units"],"command":"systemd-analyze blame","alternatives":[],"explanation":"Lists units ordered by how long they took to initialize during boot.","requires":["systemd-analyze"],"packages":{},"tags":["systemd","boot","performance"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"systemd_analyze_critical_chain","intent":["show boot critical path","inspect boot dependency chain","find which boot units blocked startup","systemd critical chain"],"command":"systemd-analyze critical-chain","alternatives":[],"explanation":"Shows the dependency chain that determined the boot completion path.","requires":["systemd-analyze"],"packages":{},"tags":["systemd","boot","dependencies"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"journalctl_service_current_boot","intent":["show logs for service from current boot","limit service logs to this boot","inspect unit logs since reboot","journalctl unit this boot"],"command":"journalctl -u sshd -b","alternatives":[],"explanation":"Shows logs for a specific systemd unit only from the current boot.","requires":["journalctl"],"packages":{},"tags":["logs","systemd","service","boot"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"journalctl_since_time","intent":["show logs since an hour ago","filter journal by time range","inspect recent system logs","journalctl since time"],"command":"journalctl --since '1 hour ago'","alternatives":["journalctl --since today"],"explanation":"Filters the journal to entries newer than the specified time expression.","requires":["journalctl"],"packages":{},"tags":["logs","journalctl","time"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"journalctl_kernel_boot","intent":["show kernel messages from current boot","inspect dmesg in journal for this boot","kernel logs since reboot","journalctl kernel current boot"],"command":"journalctl -k -b","alternatives":["dmesg"],"explanation":"Shows kernel log messages for the current boot using the journal.","requires":["journalctl"],"packages":{},"tags":["logs","kernel","boot"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"loginctl_list_sessions","intent":["list logged in user sessions","show active logind sessions","inspect local seats and sessions","see who has sessions"],"command":"loginctl list-sessions","alternatives":["loginctl session-status"],"explanation":"Lists sessions known to systemd-logind, including remote and local logins.","requires":["loginctl"],"packages":{},"tags":["systemd","sessions","login"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"pacman_query_file_owner","intent":["find which installed package owns a file on arch","what package owns this path in pacman","lookup installed file owner with pacman","determine package for local file on arch"],"command":"pacman -Qo /path/to/file","alternatives":[],"explanation":"Queries the local package database to find which installed package owns the given file path.","requires":["pacman"],"packages":{},"tags":["package","pacman","arch","files"],"platform":["linux","arch"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"pacman_list_package_files","intent":["list files installed by a package on arch","show package contents with pacman","see files that belong to a package","inspect installed package file list"],"command":"pacman -Ql ripgrep","alternatives":[],"explanation":"Lists every file installed by a package from the local package database.","requires":["pacman"],"packages":{},"tags":["package","pacman","arch","files"],"platform":["linux","arch"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"pacman_search_repo_file","intent":["search arch repositories for a file","find which package provides a file in pacman repos","lookup remote file database with pacman","search package file database on arch"],"command":"pacman -F rg","alternatives":["pacman -F rg"],"explanation":"Searches the synced package file database for packages containing a matching file name or path fragment.","requires":["pacman"],"packages":{},"tags":["package","pacman","arch","files","search"],"platform":["linux","arch"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"pacman_search_repo_exact_path","intent":["search arch repositories for an exact file path","find exact file path in pacman file database","use pacman exact file search","match full path in package file list"],"command":"pacman -Fx 'usr/bin/rg'","alternatives":["pacman -Fx 'bin/bash'"],"explanation":"Uses the exact-match file database search, which is easy to forget but useful for full paths.","requires":["pacman"],"packages":{},"tags":["package","pacman","arch","files","search"],"platform":["linux","arch"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"pacman_refresh_file_database","intent":["refresh pacman file database","update pacman file lists","make pacman -F work after sync","sync arch file database"],"command":"sudo pacman -Fy","alternatives":["sudo pacman -Fyy"],"explanation":"Refreshes the package file database used by pacman -F and pacman -Fx searches.","requires":["pacman","sudo"],"packages":{},"tags":["package","pacman","arch","files","sync"],"platform":["linux","arch"],"shell":["bash","zsh","fish"],"safety":"privileged-modifying"}
{"id":"pacman_search_installed_packages","intent":["search installed packages on arch","find package by name in local pacman db","lookup installed pacman packages","search local package list"],"command":"pacman -Qs keyword","alternatives":["pacman -Qsq keyword"],"explanation":"Searches the local installed package database by package name and description.","requires":["pacman"],"packages":{},"tags":["package","pacman","arch","search"],"platform":["linux","arch"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"pacman_list_explicit_packages","intent":["list explicitly installed packages on arch","show manually installed pacman packages","find non-dependency packages","pacman explicit packages"],"command":"pacman -Qe","alternatives":[],"explanation":"Lists packages explicitly installed by the user rather than pulled in as dependencies.","requires":["pacman"],"packages":{},"tags":["package","pacman","arch","inventory"],"platform":["linux","arch"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"pacman_list_orphans","intent":["list orphan packages on arch","show unneeded dependencies in pacman","find orphaned packages","pacman orphan query"],"command":"pacman -Qdt","alternatives":["pacman -Qdtt"],"explanation":"Shows dependency packages no longer required by any explicitly installed package.","requires":["pacman"],"packages":{},"tags":["package","pacman","arch","cleanup"],"platform":["linux","arch"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"git_restore_file","intent":["discard unstaged changes in a file","restore file from HEAD","undo working tree edits in git","revert file changes not staged"],"command":"git restore path/to/file","alternatives":["git checkout -- path/to/file"],"explanation":"Restores the working tree copy of a file from the index or HEAD, discarding local unstaged edits.","requires":["git"],"packages":{},"tags":["git","restore","working-tree"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-modifying"}
{"id":"git_restore_staged_file","intent":["unstage a file in git","remove file from index without losing edits","git unstage path","restore staged changes only"],"command":"git restore --staged path/to/file","alternatives":["git reset HEAD path/to/file"],"explanation":"Removes changes from the index while keeping the working tree edits intact.","requires":["git"],"packages":{},"tags":["git","staging","index"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-modifying"}
{"id":"git_switch_new_branch","intent":["create and switch to a new git branch","make branch and move to it","git checkout -b replacement","start new branch"],"command":"git switch -c feature-name","alternatives":["git checkout -b feature-name"],"explanation":"Creates a new branch and switches to it using the modern git switch command.","requires":["git"],"packages":{},"tags":["git","branch"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-modifying"}
{"id":"git_fetch_prune","intent":["remove deleted remote branches locally","fetch and prune remotes","clean stale remote tracking branches","git fetch prune"],"command":"git fetch --prune","alternatives":["git remote prune origin"],"explanation":"Fetches updates and prunes remote-tracking branches that no longer exist upstream.","requires":["git"],"packages":{},"tags":["git","fetch","cleanup","branches"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-modifying"}
{"id":"git_branch_merged","intent":["show merged branches","find branches already merged","list safe-to-delete local branches","git merged branches"],"command":"git branch --merged","alternatives":["git branch --no-merged"],"explanation":"Lists branches whose tips are already reachable from the current HEAD.","requires":["git"],"packages":{},"tags":["git","branch","merge"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"git_diff_word_diff","intent":["show git diff by changed words","inspect inline word changes","review textual edits compactly","git word diff"],"command":"git diff --word-diff","alternatives":["git diff --word-diff=color"],"explanation":"Highlights additions and deletions at word granularity instead of full lines.","requires":["git"],"packages":{},"tags":["git","diff","review"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"git_log_for_file","intent":["show git history for one file","inspect commits touching a file","trace file changes over time","git log path only"],"command":"git log -- path/to/file","alternatives":["git log -p -- path/to/file"],"explanation":"Limits git history output to commits that touched the specified path.","requires":["git"],"packages":{},"tags":["git","history","files"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"git_blame_line_range","intent":["blame only certain lines in a file","find who changed a code region","git blame line range","inspect authorship for selected lines"],"command":"git blame -L 10,30 path/to/file","alternatives":[],"explanation":"Shows authorship information only for the requested line range.","requires":["git"],"packages":{},"tags":["git","blame","history"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"git_reflog_recent","intent":["see recent HEAD movements","recover lost git commit by reflog","inspect branch tip history","git reflog shortcut"],"command":"git reflog -n 20","alternatives":["git reflog"],"explanation":"Shows recent updates to HEAD and branch references, useful for recovering lost work.","requires":["git"],"packages":{},"tags":["git","recovery","history"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"git_show_file_from_ref","intent":["show a file from another branch without checkout","print file contents from commit","inspect file at git ref","git cat file from branch"],"command":"git show main:path/to/file","alternatives":["git show HEAD~1:path/to/file"],"explanation":"Prints a file as it exists at a given commit, tag, or branch.","requires":["git"],"packages":{},"tags":["git","files","history"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"git_cherry_compare","intent":["compare unique commits between branches","see what commits are not upstream","git cherry output","check branch divergence by patch id"],"command":"git cherry -v origin/main","alternatives":[],"explanation":"Shows commits in the current branch that are not yet represented upstream by patch equivalence.","requires":["git"],"packages":{},"tags":["git","commits","compare"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"git_repo_root","intent":["print top level of git repo","find repository root path","where is this git worktree rooted","git project root"],"command":"git rev-parse --show-toplevel","alternatives":[],"explanation":"Prints the absolute path to the top-level directory of the current repository.","requires":["git"],"packages":{},"tags":["git","paths","repo"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"git_clean_preview_ignored","intent":["preview deleting ignored files in git","see what build artifacts git clean would remove","dry run ignored cleanup","git clean ignored files"],"command":"git clean -ndX","alternatives":["git clean -nd"],"explanation":"Dry-runs cleanup of ignored files only, which is safer than deleting them immediately.","requires":["git"],"packages":{},"tags":["git","cleanup","dry-run"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"git_diff_staged_names","intent":["show staged files only","list files currently staged in git","see index file names","git diff cached names"],"command":"git diff --cached --name-only","alternatives":["git diff --staged --name-only"],"explanation":"Lists file paths that are currently staged for commit.","requires":["git"],"packages":{},"tags":["git","staging","diff","files"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"find_empty_files","intent":["find empty files","locate zero byte files","search for blank files recursively","find files of size zero"],"command":"find . -type f -empty","alternatives":[],"explanation":"Searches recursively for regular files with no content.","requires":["find"],"packages":{},"tags":["find","files","cleanup"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"find_broken_symlinks","intent":["find broken symlinks","locate dangling symbolic links","search for dead symlinks","find invalid links"],"command":"find . -xtype l","alternatives":[],"explanation":"Finds symbolic links whose targets no longer exist.","requires":["find"],"packages":{},"tags":["find","symlink","cleanup"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"find_recent_files","intent":["find files modified in last day","search recent files","locate files changed recently","find by mtime"],"command":"find . -type f -mtime -1","alternatives":["find . -type f -mmin -60"],"explanation":"Finds files modified within the last day or other chosen time window.","requires":["find"],"packages":{},"tags":["find","files","time"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"find_executable_files","intent":["find executable files","search for executable scripts and binaries","locate files with execute bit","find runnable files"],"command":"find . -type f -perm -111","alternatives":[],"explanation":"Finds regular files where any execute bit is set.","requires":["find"],"packages":{},"tags":["find","permissions","files"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"rg_list_files_with_matches","intent":["list files containing text","show file names matching ripgrep search","find which files contain pattern","ripgrep files only"],"command":"rg -l 'pattern'","alternatives":[],"explanation":"Prints only the file names that contain at least one match.","requires":["rg"],"packages":{"fedora":["ripgrep"],"debian":["ripgrep"],"arch":["ripgrep"]},"tags":["search","ripgrep","files","text"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"rg_list_files_without_matches","intent":["list files that do not contain text","find files missing pattern","ripgrep inverse file list","show names of non-matching files"],"command":"rg -L 'pattern'","alternatives":[],"explanation":"Prints file names searched by ripgrep that did not contain a match.","requires":["rg"],"packages":{"fedora":["ripgrep"],"debian":["ripgrep"],"arch":["ripgrep"]},"tags":["search","ripgrep","files","inverse"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"rg_search_hidden_and_binary","intent":["search hidden files with ripgrep","include ignored files in rg search","ripgrep everything including binaries","search dotfiles too"],"command":"rg -uuu 'pattern'","alternatives":["rg -uu 'pattern'"],"explanation":"Disables ignore rules and hidden-file filtering; the extra u also searches binary files.","requires":["rg"],"packages":{"fedora":["ripgrep"],"debian":["ripgrep"],"arch":["ripgrep"]},"tags":["search","ripgrep","hidden","binary"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"xargs_null_safe","intent":["handle filenames with spaces through xargs","pipe null-delimited paths safely","use xargs with find -print0","avoid breaking on whitespace in file names"],"command":"find . -type f -print0 | xargs -0 ls -l","alternatives":[],"explanation":"Uses NUL delimiters so file names with spaces, quotes, or newlines are handled safely.","requires":["find","xargs","ls"],"packages":{},"tags":["xargs","find","files","safety"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"sort_human_numeric","intent":["sort sizes like 2K 10M 1G","human readable numeric sort","sort du output correctly","sort with size suffixes"],"command":"sort -h","alternatives":[],"explanation":"Sorts numbers that include human-readable suffixes such as K, M, and G.","requires":["sort"],"packages":{},"tags":["sort","text","sizes"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"sort_version_numbers","intent":["sort version numbers naturally","order semantic versions","sort dotted numeric strings correctly","sort -V example"],"command":"sort -V","alternatives":[],"explanation":"Sorts version-like strings in natural version order rather than plain lexical order.","requires":["sort"],"packages":{},"tags":["sort","versions","text"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"uniq_count_duplicates","intent":["count duplicate lines","summarize repeated values in text","show line frequencies","uniq with counts"],"command":"sort file.txt | uniq -c","alternatives":["uniq -c file.txt"],"explanation":"Counts repeated adjacent lines, usually after sorting to group identical values together.","requires":["sort","uniq"],"packages":{},"tags":["text","uniq","count"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"cut_first_field_colon","intent":["print first colon separated field","extract usernames from passwd file","cut field by delimiter","show first column from delimited text"],"command":"cut -d: -f1 /etc/passwd","alternatives":[],"explanation":"Extracts a chosen field from delimiter-separated text.","requires":["cut"],"packages":{},"tags":["text","cut","fields"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"awk_print_first_field","intent":["print first whitespace field with awk","extract first column using awk","awk column example","show first word per line"],"command":"awk '{print $1}' file.txt","alternatives":["awk -F: '{print $1}' /etc/passwd"],"explanation":"Uses awk to print a selected field from each input line.","requires":["awk"],"packages":{},"tags":["text","awk","fields"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"sed_print_line_range","intent":["print only selected lines with sed","show lines 10 through 20","sed line range output","inspect subset of file"],"command":"sed -n '10,20p' file.txt","alternatives":[],"explanation":"Suppresses normal output and prints only the requested line range.","requires":["sed"],"packages":{},"tags":["text","sed","lines"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"tr_strip_carriage_returns","intent":["remove carriage returns from text","convert windows line endings in stream","strip CR characters","fix ^M in output"],"command":"tr -d '\\r' < file.txt","alternatives":["sed 's/\\r$//' file.txt"],"explanation":"Deletes carriage return characters, which is useful for CRLF-normalizing streamed text.","requires":["tr"],"packages":{},"tags":["text","line-endings","cleanup"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"paste_join_lines_with_comma","intent":["join lines with commas","collapse newline separated values into csv style string","paste lines into one row","comma join lines"],"command":"paste -sd, file.txt","alternatives":["tr '\\n' ',' < file.txt"],"explanation":"Joins lines together using a chosen delimiter instead of keeping one per line.","requires":["paste"],"packages":{},"tags":["text","paste","join"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"comm_compare_sorted_files","intent":["compare two sorted files by line","show lines unique to either file","set difference between sorted lists","comm side by side comparison"],"command":"comm -3 file1.txt file2.txt","alternatives":[],"explanation":"Compares two sorted files line by line and shows lines unique to either one.","requires":["comm"],"packages":{},"tags":["text","compare","files"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"column_table_view","intent":["format text into aligned columns","pretty print table output in shell","align whitespace separated output","columnize text"],"command":"column -t file.txt","alternatives":[],"explanation":"Arranges input into aligned columns for easier reading.","requires":["column"],"packages":{},"tags":["text","formatting","tables"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"watch_every_second","intent":["rerun a command every second","monitor command output live","refresh command periodically","watch shell command"],"command":"watch -n 1 'date'","alternatives":[],"explanation":"Runs a command repeatedly and displays updated output on a schedule.","requires":["watch"],"packages":{},"tags":["monitoring","watch","shell"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"timeout_limit_command","intent":["stop a command after 5 seconds","put time limit on shell command","kill hung command after timeout","run command with timeout"],"command":"timeout 5s command","alternatives":["timeout 1m command"],"explanation":"Runs a command with a maximum duration and terminates it if it exceeds the limit.","requires":["timeout"],"packages":{},"tags":["process","timeout","shell"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"tee_save_and_show_output","intent":["save output to file while still printing it","capture stdout and see it live","write command output to file and terminal","tee example"],"command":"command | tee output.log","alternatives":["command | tee -a output.log"],"explanation":"Copies standard output to both the terminal and a file.","requires":["tee"],"packages":{},"tags":["shell","output","logging"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-modifying"}
{"id":"stat_permissions_octal","intent":["show file permissions as octal","inspect mode bits numerically","get chmod-style permission number","stat file mode"],"command":"stat -c '%a %n' file.txt","alternatives":["stat file.txt"],"explanation":"Prints the permission bits in octal form along with the file name.","requires":["stat"],"packages":{},"tags":["files","permissions","stat"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"readlink_canonical_path","intent":["resolve full real path of symlink","canonicalize file path","follow symlinks to final path","show absolute target path"],"command":"readlink -f path/to/file","alternatives":["realpath path/to/file"],"explanation":"Prints the canonical absolute path after resolving symlinks.","requires":["readlink"],"packages":{},"tags":["files","paths","symlink"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"sha256sum_file","intent":["compute sha256 checksum","hash a file for verification","generate sha256 digest","verify file integrity hash"],"command":"sha256sum file.iso","alternatives":[],"explanation":"Computes a SHA-256 digest for a file, commonly used for integrity checks.","requires":["sha256sum"],"packages":{},"tags":["hash","checksum","integrity"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"cmp_quiet_files","intent":["check if two files are identical quickly","compare files silently by exit code","quiet file comparison","cmp exact file equality"],"command":"cmp -s file1 file2","alternatives":["diff -q file1 file2"],"explanation":"Compares two files byte-for-byte and stays quiet unless you check the exit status.","requires":["cmp"],"packages":{},"tags":["files","compare","binary"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"tar_list_archive_contents","intent":["list files inside tar archive","inspect tarball without extracting","show tar contents","view archive members"],"command":"tar -tf archive.tar.gz","alternatives":["tar -tvf archive.tar.gz"],"explanation":"Lists files stored in a tar archive without extracting them.","requires":["tar"],"packages":{},"tags":["archive","tar","inspect"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"unzip_list_contents","intent":["list files inside zip archive","inspect zip without extracting","show zip contents","view archive entries"],"command":"unzip -l archive.zip","alternatives":[],"explanation":"Shows the contents of a ZIP archive without unpacking it.","requires":["unzip"],"packages":{},"tags":["archive","zip","inspect"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"lsof_process_using_port","intent":["find process using tcp port","see what owns port 8080","identify listener by port with lsof","which program has this port open"],"command":"lsof -i :8080","alternatives":["sudo lsof -iTCP:8080 -sTCP:LISTEN -Pn"],"explanation":"Lists open files and network sockets associated with the requested port.","requires":["lsof"],"packages":{},"tags":["network","ports","process","lsof"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"fuser_file_or_port_users","intent":["find processes using a file or mount","see who is using directory","identify process using tcp port with fuser","what has this path open"],"command":"fuser -v /path/to/file","alternatives":["fuser -v 8080/tcp"],"explanation":"Shows which processes are currently accessing a file, directory, mount point, or port.","requires":["fuser"],"packages":{},"tags":["process","files","ports","diagnostics"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"ss_established_tcp_processes","intent":["show established tcp connections with processes","inspect active tcp sessions","list connected sockets and owning programs","ss established state"],"command":"ss -tp state established","alternatives":["sudo ss -tp state established"],"explanation":"Lists established TCP connections and, when permitted, the associated processes.","requires":["ss"],"packages":{},"tags":["network","sockets","connections"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"dig_short_dns_answer","intent":["resolve a hostname quickly","show only dns answer value","dig concise output","lookup ip without headers"],"command":"dig +short example.com","alternatives":["getent ahosts example.com"],"explanation":"Performs a DNS lookup and prints only the answer records in a compact format.","requires":["dig"],"packages":{"fedora":["bind-utils"],"debian":["dnsutils"],"arch":["bind"]},"tags":["dns","network","lookup"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"curl_fail_silent_follow_redirects","intent":["download url quietly but fail on errors","curl for scripts with redirects","silent curl with http failure exit","common curl script flags"],"command":"curl -fsSL https://example.com","alternatives":[],"explanation":"Combines common scripting flags: fail on HTTP errors, stay quiet, show errors, and follow redirects.","requires":["curl"],"packages":{},"tags":["http","curl","scripting"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"nc_check_tcp_port","intent":["test if tcp port is reachable","probe remote port quickly","netcat connection test","check open port on host"],"command":"nc -vz example.com 443","alternatives":["telnet example.com 443"],"explanation":"Attempts a TCP connection and reports whether the port is reachable.","requires":["nc"],"packages":{},"tags":["network","ports","diagnostics"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"ip_brief_link_status","intent":["show network links briefly","list interfaces with short status","compact link state output","ip brief link"],"command":"ip -brief link","alternatives":["ip -br addr"],"explanation":"Shows network interfaces and their state in a concise tabular format.","requires":["ip"],"packages":{},"tags":["network","interfaces","ip"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"ip_route_get_destination","intent":["see which route a host will use","check outbound interface for destination","ip route lookup to host","show selected path to address"],"command":"ip route get 1.1.1.1","alternatives":[],"explanation":"Asks the kernel which route, source address, and interface it would use for a destination.","requires":["ip"],"packages":{},"tags":["network","routing","ip"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"resolvectl_query_name","intent":["query dns through systemd resolved","inspect resolver answer with resolvectl","resolve hostname using local resolver","systemd dns lookup"],"command":"resolvectl query example.com","alternatives":["resolvectl status"],"explanation":"Queries the systemd-resolved service directly and shows the returned DNS records.","requires":["resolvectl"],"packages":{},"tags":["dns","systemd","network"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"printenv_sorted","intent":["show environment variables sorted","inspect env in stable order","list shell environment alphabetically","printenv with sort"],"command":"printenv | sort","alternatives":["env | sort"],"explanation":"Prints environment variables in sorted order, which is easier to scan and diff.","requires":["printenv","sort"],"packages":{},"tags":["environment","shell","debugging"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"nohup_background_command","intent":["run command in background after logout","start process immune to hangup","keep command running after terminal closes","nohup background example"],"command":"nohup command >/tmp/command.log 2>&1 &","alternatives":[],"explanation":"Starts a background process detached from the current terminal and captures its output.","requires":["nohup"],"packages":{},"tags":["process","background","shell"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-modifying"}
{"id":"jobs_long_format","intent":["list shell background jobs with pids","inspect current shell jobs","show job table in detail","jobs with process ids"],"command":"jobs -l","alternatives":[],"explanation":"Lists background jobs for the current shell, including process IDs.","requires":["jobs"],"packages":{},"tags":["shell","jobs","background"],"platform":["linux","macos"],"shell":["bash","zsh"],"safety":"safe-readonly"}
{"id":"disown_background_job","intent":["remove job from shell job table","let background job survive shell exit","disown current background process","detach shell job"],"command":"disown %1","alternatives":["disown -h %1"],"explanation":"Removes a job from shell job control so the shell stops managing or warning about it.","requires":["disown"],"packages":{},"tags":["shell","jobs","background"],"platform":["linux","macos"],"shell":["bash","zsh"],"safety":"safe-modifying"}
{"id":"du_top_level_sorted","intent":["show sizes of top level entries sorted","find largest directories here","summarize child disk usage and sort","du current dir sorted"],"command":"du -sh -- * | sort -h","alternatives":["du -sh .[!.]* * | sort -h"],"explanation":"Shows human-readable sizes for top-level entries and sorts them from smallest to largest.","requires":["du","sort"],"packages":{},"tags":["disk","directory","size"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"mount_pretty_columns","intent":["show mounted filesystems in aligned columns","format mount output nicely","read mount list as table","pretty print mount command"],"command":"mount | column -t","alternatives":["findmnt"],"explanation":"Formats the mount list into readable aligned columns.","requires":["mount","column"],"packages":{},"tags":["filesystem","mount","formatting"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"lsmod_loaded_modules","intent":["list loaded kernel modules","show active kernel modules","inspect module list","see loaded drivers"],"command":"lsmod","alternatives":[],"explanation":"Lists currently loaded kernel modules and their dependency counts.","requires":["lsmod"],"packages":{},"tags":["kernel","modules","drivers"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"modinfo_module_details","intent":["show information about kernel module","inspect module parameters and file path","modinfo example","see kernel driver metadata"],"command":"modinfo kvm","alternatives":[],"explanation":"Shows metadata such as filename, description, parameters, and aliases for a kernel module.","requires":["modinfo"],"packages":{},"tags":["kernel","modules","drivers"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"dmesg_warn_and_error","intent":["show warning and error kernel messages","filter dmesg to serious messages","inspect kernel warnings only","dmesg levels"],"command":"dmesg --level=warn,err","alternatives":["journalctl -k -p warning"],"explanation":"Filters kernel ring buffer output to warning and error severity messages.","requires":["dmesg"],"packages":{},"tags":["kernel","logs","errors"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"sysctl_read_key","intent":["show current sysctl value","read kernel tunable","inspect runtime kernel setting","sysctl get key"],"command":"sysctl net.ipv4.ip_forward","alternatives":["cat /proc/sys/net/ipv4/ip_forward"],"explanation":"Reads the current value of a kernel tunable exposed through sysctl.","requires":["sysctl"],"packages":{},"tags":["kernel","sysctl","network"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"lsns_namespace_list","intent":["list Linux namespaces","inspect container or process namespaces","show mount pid net namespaces","lsns overview"],"command":"lsns","alternatives":["lsns -t net"],"explanation":"Lists namespaces currently present on the system and representative processes in them.","requires":["lsns"],"packages":{},"tags":["kernel","namespaces","containers"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"ulimit_show_all","intent":["show current shell resource limits","inspect open files and process limits","see ulimit settings","print all resource limits"],"command":"ulimit -a","alternatives":[],"explanation":"Displays the current shell's resource limits such as open files, stack size, and process counts.","requires":["ulimit"],"packages":{},"tags":["shell","limits","resources"],"platform":["linux","macos"],"shell":["bash","zsh"],"safety":"safe-readonly"}
{"id":"namei_path_components","intent":["show each component in a path","inspect path permissions segment by segment","debug missing execute bit in parent dirs","namei path breakdown"],"command":"namei -l /path/to/file","alternatives":[],"explanation":"Breaks a path into components and shows ownership and permissions for each segment.","requires":["namei"],"packages":{},"tags":["paths","permissions","debugging"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"getfacl_file_acl","intent":["show acl on file or directory","inspect extended permissions","see POSIX ACL entries","getfacl example"],"command":"getfacl /path/to/file","alternatives":[],"explanation":"Displays POSIX ACL entries when standard mode bits are not the whole story.","requires":["getfacl"],"packages":{},"tags":["permissions","acl","files"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"pkill_match_full_command","intent":["kill process by full command line match","terminate process using regex over cmdline","pkill with -f example","stop program by command pattern"],"command":"pkill -f 'python -m http.server'","alternatives":["pgrep -af 'python -m http.server'"],"explanation":"Matches against the full command line instead of just the process name.","requires":["pkill"],"packages":{},"tags":["process","signals","pkill"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-modifying"}
{"id":"jq_cards_command_and_intents","intent":["show each card command and intents from cards.jsonl","print commands and intents from jsonl","format cards as command colon intents","list cards.jsonl commands with joined intents"],"command":"jq -r '.command + \": \" + (.intent | join(\", \"))' cards.jsonl","alternatives":[],"explanation":"Reads each JSON object in the JSONL file and prints the command followed by its intents on one line.","requires":["jq"],"packages":{"fedora":["jq"],"debian":["jq"],"arch":["jq"]},"tags":["jq","json","jsonl","formatting"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"jq_pretty_print_json","intent":["pretty print json with jq","format json nicely","indent json output","make json readable"],"command":"jq . file.json","alternatives":["cat file.json | jq ."],"explanation":"Parses JSON input and prints it in a readable, pretty-formatted layout.","requires":["jq"],"packages":{"fedora":["jq"],"debian":["jq"],"arch":["jq"]},"tags":["jq","json","formatting"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"jq_extract_field","intent":["extract one field from json with jq","print property value from json","show name field from json object","jq select field"],"command":"jq -r '.name' file.json","alternatives":["jq '.name' file.json"],"explanation":"Extracts a single field from a JSON object, with -r for raw string output.","requires":["jq"],"packages":{"fedora":["jq"],"debian":["jq"],"arch":["jq"]},"tags":["jq","json","fields"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"jq_filter_array_objects","intent":["filter json array objects by field","select objects matching property in jq","find active items in json array","jq map select example"],"command":"jq '.[] | select(.enabled == true)' file.json","alternatives":["jq '.items[] | select(.status == \"ok\")' file.json"],"explanation":"Iterates over array elements and prints only the objects that match the filter expression.","requires":["jq"],"packages":{"fedora":["jq"],"debian":["jq"],"arch":["jq"]},"tags":["jq","json","filter"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"jq_compact_output","intent":["print json in one line with jq","compact json output","minify json using jq","emit compact json objects"],"command":"jq -c . file.json","alternatives":["jq -c '.[]' file.json"],"explanation":"Outputs compact JSON without extra whitespace, which is useful for pipes and JSONL-style streams.","requires":["jq"],"packages":{"fedora":["jq"],"debian":["jq"],"arch":["jq"]},"tags":["jq","json","compact"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"jq_list_keys","intent":["show keys in json object","list property names with jq","inspect available top level fields","jq keys example"],"command":"jq 'keys' file.json","alternatives":["jq -r 'keys[]' file.json"],"explanation":"Prints the key names present in a JSON object so you can see its available fields.","requires":["jq"],"packages":{"fedora":["jq"],"debian":["jq"],"arch":["jq"]},"tags":["jq","json","keys","inspection"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"jq_slurp_jsonl_to_array","intent":["convert jsonl to a json array with jq","slurp newline json into array","wrap jsonl records in array","jq slurp multiple json objects"],"command":"jq -s . cards.jsonl","alternatives":["jq -sc . cards.jsonl"],"explanation":"Reads multiple JSON values from a JSONL file and returns them as a single JSON array.","requires":["jq"],"packages":{"fedora":["jq"],"debian":["jq"],"arch":["jq"]},"tags":["jq","json","jsonl","array"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"jq_build_object_from_fields","intent":["construct a new json object with jq","pick only selected fields from json","reshape json into smaller object","jq object literal example"],"command":"jq '{id, command, tags}' file.json","alternatives":["jq '{name: .metadata.name, version: .metadata.version}' file.json"],"explanation":"Builds a new object containing only the fields you want, optionally with renamed keys or nested lookups.","requires":["jq"],"packages":{"fedora":["jq"],"debian":["jq"],"arch":["jq"]},"tags":["jq","json","transform"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"jq_sort_array_by_field","intent":["sort json array by field with jq","order objects by property value","jq sort objects by name","sort array entries in json"],"command":"jq 'sort_by(.name)' file.json","alternatives":["jq 'sort_by(.created_at) | reverse' file.json"],"explanation":"Sorts an array of objects by the chosen field before printing the result.","requires":["jq"],"packages":{"fedora":["jq"],"debian":["jq"],"arch":["jq"]},"tags":["jq","json","sort"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"jq_count_array_items","intent":["count array items with jq","get length of json array","how many objects are in this json list","jq length example"],"command":"jq 'length' file.json","alternatives":["jq '.items | length' file.json"],"explanation":"Returns the number of elements in an array, or the number of keys in an object.","requires":["jq"],"packages":{"fedora":["jq"],"debian":["jq"],"arch":["jq"]},"tags":["jq","json","count"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"sort_version_numbers","intent":["sort version strings naturally","order versions like 1.9 1.10 correctly","version sort lines","sort semantic-ish version text"],"command":"sort -V versions.txt","alternatives":["printf '%s\n' 1.9 1.10 1.2 | sort -V"],"explanation":"Sorts text using version-aware ordering so dotted numbers come out in the order humans expect.","requires":["sort"],"packages":{},"tags":["text","sort","versions"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"tsort_topological_order","intent":["topologically sort dependency pairs","order tasks from parent child edges","resolve simple dependency chain from pairs","tsort example"],"command":"tsort edges.txt","alternatives":["printf 'build test\ntest deploy\n' | tsort"],"explanation":"Reads whitespace-separated dependency pairs and prints a topological order, which is easy to forget exists.","requires":["tsort"],"packages":{},"tags":["text","graph","dependencies"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"nl_number_all_lines","intent":["number every line in a file","show line numbers including blank lines","annotate text with line numbers","nl all lines example"],"command":"nl -ba file.txt","alternatives":["cat -n file.txt"],"explanation":"Numbers all lines, including blank ones, which is handy when exact line references matter.","requires":["nl"],"packages":{},"tags":["text","lines","numbering"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"pr_two_column_view","intent":["display a file in two columns","split text into side by side columns","pretty print file as columns","pr multi column example"],"command":"pr -T -2 file.txt","alternatives":["pr -T -3 file.txt"],"explanation":"Formats text into multiple columns without headers, a useful but often-forgotten pager-style trick.","requires":["pr"],"packages":{},"tags":["text","formatting","columns"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"xargs_null_delimited","intent":["handle filenames with spaces from find","pass null delimited input to another command","safe xargs for weird filenames","xargs zero terminated example"],"command":"find . -type f -print0 | xargs -0 file","alternatives":["find . -type f -print0 | xargs -0 -n1 basename"],"explanation":"Consumes NUL-delimited input so paths with spaces, quotes, and newlines are handled safely.","requires":["find","xargs"],"packages":{},"tags":["find","xargs","files","safety"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"split_file_by_size","intent":["split a large file into chunks","break file into 100MB pieces","chunk big file by size","split archive or log into parts"],"command":"split -b 100M bigfile chunk-","alternatives":["split -l 10000 file.txt chunk-"],"explanation":"Splits a file into smaller pieces by size or line count using a chosen output prefix.","requires":["split"],"packages":{},"tags":["files","split","chunks"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-modifying"}
{"id":"expand_tabs_to_spaces","intent":["convert tabs to spaces","replace tab characters with spaces","normalize indentation from tabs","expand tabs in text file"],"command":"expand -t 4 file.txt","alternatives":["expand file.txt"],"explanation":"Replaces tab characters with the corresponding number of spaces at the chosen tab stop width.","requires":["expand"],"packages":{},"tags":["text","tabs","whitespace"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"unexpand_spaces_to_tabs","intent":["convert spaces to tabs","compress indentation back into tabs","replace leading spaces with tabs","unexpand text example"],"command":"unexpand -a file.txt","alternatives":["unexpand --first-only file.txt"],"explanation":"Turns runs of spaces into tabs where possible, which is useful when matching tab-based formatting.","requires":["unexpand"],"packages":{},"tags":["text","tabs","whitespace"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"script_capture_clean_output","intent":["capture output exactly as shown in terminal","record command output through a pseudo tty","run command under script to preserve tty behavior","script command example"],"command":"script -q -c 'command' /dev/null","alternatives":["script session.log"],"explanation":"Runs a command under a pseudo-terminal, which helps with programs that behave differently when stdout is not a TTY.","requires":["script"],"packages":{},"tags":["terminal","tty","capture"],"platform":["linux","macos"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"flock_single_instance_command","intent":["prevent two copies of a command from running","take a lock file before running command","serialize script execution with flock","run only one instance"],"command":"flock -n /tmp/my.lock command","alternatives":["flock /tmp/my.lock command"],"explanation":"Uses a lock file to ensure only one instance runs at a time, which is easy to overlook when scripting.","requires":["flock"],"packages":{},"tags":["locking","scripts","concurrency"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-modifying"}
{"id":"env_clean_shell","intent":["start command with empty environment","debug issue caused by env vars","run shell without inherited environment","test command in clean env"],"command":"env -i bash --noprofile --norc","alternatives":["env -i PATH=\"$PATH\" command"],"explanation":"Starts a command with an empty environment so you can isolate problems caused by inherited variables or shell startup files.","requires":["env","bash"],"packages":{},"tags":["environment","shell","debugging"],"platform":["linux","macos"],"shell":["bash","zsh"],"safety":"safe-readonly"}
{"id":"kernel_cmdline_current","intent":["view current kernel commandline","show current kernel command line","inspect boot kernel arguments","read running kernel cmdline"],"command":"cat /proc/cmdline","alternatives":[],"explanation":"Prints the kernel command line that the currently running system was booted with.","requires":["cat"],"packages":{},"tags":["kernel","boot","cmdline"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}
{"id":"sysctl_list_all","intent":["view current kernel parameters","show all current kernel parameters","list all sysctl settings","inspect all runtime kernel tunables"],"command":"sysctl -a","alternatives":["find /proc/sys -type f | sort"],"explanation":"Lists all currently readable sysctl-exposed kernel parameters and their values.","requires":["sysctl"],"packages":{},"tags":["kernel","sysctl","parameters"],"platform":["linux"],"shell":["bash","zsh","fish"],"safety":"safe-readonly"}