# CLI Tools

> Picks the shell tool and its flags: rg, fd, jq, yq, curl, shellcheck, sd, ast-grep, typos, git, uv or tmux. Use to find files that mention a word, list files, read a JSON or YAML field, call an HTTP endpoint and show the response, or replace text.

- Skill: `niksavis/cli-tools` (Agent Skill, multi-file: 19 files)
- Install (CLI): `npx get-skill add niksavis/cli-tools`
- Raw SKILL.md: https://api.skillmd.com/api/skills/niksavis/cli-tools/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: niksavis (https://skillmd.com/u/niksavis)
- Updated: 2026-11-11
- Page: https://skillmd.com/skills/niksavis/cli-tools

---

<!-- Generated by `basicly skills-build` from skill.yaml. Do not edit; edit the source. -->

# Command-line tools

Pick the tool for the task, then read its reference for the flags, the rules and the output. When a tool is missing, say so and use its fallback. When the fallback is `none`, tell the user which tool to install and do not improvise one.

| Task | Tool | Reference | Fallback |
| --- | --- | --- | --- |
| Search text in files | `rg` | [ripgrep](references/ripgrep.md) | `grep -rn` |
| Find files by name or type | `fd` | [fd](references/fd.md) | `find` |
| Read or reshape JSON | `jq` | [jq](references/jq.md) | a script |
| Read or reshape YAML or TOML | `yq` | [yq](references/yq.md) | a script |
| Replace text in files | `sd` | [sd](references/sd.md) | `sed` |
| Search or rewrite code structure | `ast-grep` | [ast-grep](references/ast-grep.md) | `rg` |
| Call an HTTP API | `xh`, `curl` | [xh](references/xh.md), [curl](references/curl.md) | `curl` |
| Download a file | `curl -O` | [curl](references/curl.md) | none |
| Read a diff | `delta` | [git-delta](references/git-delta.md) | `git diff` |
| Run a project recipe | `just` | [just](references/just.md) | the README command |
| Run with the project variables | `direnv exec .` | [direnv](references/direnv.md) | set them by hand |
| Large binary files in git | `git lfs` | [git-lfs](references/git-lfs.md) | none |
| Check a shell script | `shellcheck` | [shellcheck](references/shellcheck.md) | none |
| Find spelling mistakes | `typos` | [typos](references/typos.md) | none |
| Git commands | `git` | [git](references/git.md) | none |
| Review and stage by hand | `lazygit` | [lazygit](references/lazygit.md) | `git` |
| Pick a line from a list | `fzf` | [fzf](references/fzf.md) | `rg` |
| Python projects and scripts | `uv` | [uv](references/uv.md) | `pip` |

To give every repo on this machine this skill and its references, run `basicly skills-user cli-tools`. Run it again after each upgrade, because a stale personal copy hides the project skill.

## Rules

- **Never start an interactive tool.** `fzf`, `lazygit`, `tmux` and `wezterm` wait for a person; use only the forms their references mark as safe.

