cli-tools

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

CLI Tools Skill

CLI工具技能

Manage CLI tool installation, environment auditing, and updates.

管理CLI工具的安装、环境审计与更新。

Capabilities

功能特性

Reactive: Auto-install missing tools on "command not found"
Proactive: Audit project dependencies and tool versions
Maintenance: Batch update all managed tools

响应式处理：当出现‘command not found’时自动安装缺失的工具
主动式检查：审计项目依赖与工具版本
维护管理：批量更新所有已管理的工具

Triggers

触发条件

Reactive (auto-install):

bash: <tool>: command not found
zsh: command not found: <tool>

Proactive (audit): "check environment", "what's missing", "update tools"

响应式触发（自动安装）：

bash: <tool>: command not found
zsh: command not found: <tool>

主动式触发（审计）："检查环境"、"缺少什么工具"、"更新工具"

Binary to Tool Mapping

二进制与工具映射

Common binary names that differ from package names:

Binary	Package (Homebrew)	Package (apt)
`rg`	`ripgrep`	`ripgrep`
`fd`	`fd`	`fd-find`
`bat`	`bat`	`bat`
`delta`	`git-delta`	N/A
`exa` / `eza`	`eza`	`eza`
`fzf`	`fzf`	`fzf`
`ag`	`the_silver_searcher`	`silversearcher-ag`
`http`	`httpie`	`httpie`
`jq`	`jq`	`jq`
`yq`	`yq`	N/A
`gh`	`gh`	`gh`
`glab`	`glab`	N/A

常见二进制名称与包名称不一致的情况：

二进制	包（Homebrew）	包（apt）
`rg`	`ripgrep`	`ripgrep`
`fd`	`fd`	`fd-find`
`bat`	`bat`	`bat`
`delta`	`git-delta`	N/A
`exa` / `eza`	`eza`	`eza`
`fzf`	`fzf`	`fzf`
`ag`	`the_silver_searcher`	`silversearcher-ag`
`http`	`httpie`	`httpie`
`jq`	`jq`	`jq`
`yq`	`yq`	N/A
`gh`	`gh`	`gh`
`glab`	`glab`	N/A

Installation Commands

安装命令

macOS (Homebrew)

bash

undefined

bash

undefined

Install single tool

brew install <package>

Install multiple tools

brew install ripgrep fd bat eza fzf jq gh

Update all tools

brew update && brew upgrade

undefined

brew update && brew upgrade

undefined

Linux (apt)

bash

undefined

bash

undefined

Install single tool

sudo apt install <package>

Install multiple tools

sudo apt install ripgrep fd-find bat fzf jq

Update all tools

sudo apt update && sudo apt upgrade

undefined

sudo apt update && sudo apt upgrade

undefined

PHP Tools (Composer)

PHP工具 (Composer)

bash

undefined

bash

undefined

Global PHP tools

composer global require phpstan/phpstan composer global require friendsofphp/php-cs-fixer composer global require rector/rector

Project-specific

composer require --dev phpstan/phpstan composer require --dev friendsofphp/php-cs-fixer

undefined

composer require --dev phpstan/phpstan composer require --dev friendsofphp/php-cs-fixer

undefined

Node.js Tools (npm)

Node.js工具 (npm)

bash

undefined

bash

undefined

Global Node tools

npm install -g prettier eslint typescript

Project-specific

npm install --save-dev prettier eslint typescript

undefined

npm install --save-dev prettier eslint typescript

undefined

Project Type Detection

项目类型检测

PHP Project

PHP项目

Indicators:

composer.json

vendor/

*.php

Required tools:

```
php
```
- PHP interpreter
```
composer
```
- Dependency manager
```
phpstan
```
- Static analysis
```
php-cs-fixer
```
- Code style

识别标识：

composer.json

vendor/

*.php

必备工具：

```
php
```
- PHP解释器
```
composer
```
- 依赖管理器
```
phpstan
```
- 静态分析工具
```
php-cs-fixer
```
- 代码风格修复工具

TYPO3 Project

TYPO3项目

Indicators:

composer.json

with

typo3/cms-core

public/typo3/

Required tools:

All PHP tools
```
ddev
```
- Local development
```
typo3
```
- TYPO3 CLI

识别标识：

composer.json

中包含

typo3/cms-core

，

public/typo3/

必备工具：

所有PHP工具
```
ddev
```
- 本地开发工具
```
typo3
```
- TYPO3命令行工具

Node.js Project

Node.js项目

Indicators:

package.json

node_modules/

Required tools:

```
node
```
- Node.js runtime
```
npm
```
/
```
pnpm
```
/
```
yarn
```
- Package manager

识别标识：

package.json

node_modules/

必备工具：

```
node
```
- Node.js运行时
```
npm
```
/
```
pnpm
```
/
```
yarn
```
- 包管理器

Go Project

Go项目

Indicators:

go.mod

*.go

Required tools:

```
go
```
- Go compiler
```
golangci-lint
```
- Linter

识别标识：

go.mod

*.go

必备工具：

```
go
```
- Go编译器
```
golangci-lint
```
- 代码检查工具

Environment Audit

环境审计

Check if required tools are installed:

bash

undefined

检查必备工具是否已安装：

bash

undefined

Check single tool

command -v <tool> &> /dev/null && echo "Found" || echo "Missing"

Check version

<tool> --version

PHP project audit

PHP项目审计

php --version composer --version command -v phpstan &> /dev/null || echo "Missing: phpstan" command -v php-cs-fixer &> /dev/null || echo "Missing: php-cs-fixer"

TYPO3 project audit

TYPO3项目审计

php --version composer --version ddev --version

undefined

php --version composer --version ddev --version

undefined

Tool Catalog

工具目录

Core CLI Tools

核心CLI工具

```
curl
```
- HTTP client
```
wget
```
- File downloader
```
jq
```
- JSON processor
```
yq
```
- YAML processor
```
tree
```
- Directory visualizer
```
htop
```
- Process viewer
```
tmux
```
- Terminal multiplexer

```
curl
```
- HTTP客户端
```
wget
```
- 文件下载工具
```
jq
```
- JSON处理工具
```
yq
```
- YAML处理工具
```
tree
```
- 目录可视化工具
```
htop
```
- 进程查看器
```
tmux
```
- 终端复用器

Development Tools

开发工具

```
git
```
- Version control
```
gh
```
- GitHub CLI
```
glab
```
- GitLab CLI
```
docker
```
- Containerization
```
ddev
```
- Local development

```
git
```
- 版本控制工具
```
gh
```
- GitHub命令行工具
```
glab
```
- GitLab命令行工具
```
docker
```
- 容器化工具
```
ddev
```
- 本地开发工具

Search & Navigation

搜索与导航工具

```
ripgrep
```
(
```
rg
```
) - Fast grep
```
fd
```
- Fast find
```
fzf
```
- Fuzzy finder
```
bat
```
- Cat with syntax highlighting
```
eza
```
- Modern ls replacement
```
delta
```
- Git diff viewer

```
ripgrep
```
(
```
rg
```
) - 快速文本搜索工具
```
fd
```
- 快速文件查找工具
```
fzf
```
- 模糊查找工具
```
bat
```
- 带语法高亮的Cat工具
```
eza
```
- 现代版ls替代工具
```
delta
```
- Git差异查看工具

PHP Tools

PHP工具

```
php
```
- PHP interpreter
```
composer
```
- Dependency manager
```
phpstan
```
- Static analysis
```
rector
```
- Automated refactoring
```
php-cs-fixer
```
- Code style fixer
```
phpunit
```
- Testing framework
```
infection
```
- Mutation testing

```
php
```
- PHP解释器
```
composer
```
- 依赖管理器
```
phpstan
```
- 静态分析工具
```
rector
```
- 自动重构工具
```
php-cs-fixer
```
- 代码风格修复工具
```
phpunit
```
- 测试框架
```
infection
```
- 变异测试工具

Node.js Tools

Node.js工具

```
node
```
- JavaScript runtime
```
npm
```
/
```
pnpm
```
- Package managers
```
prettier
```
- Code formatter
```
eslint
```
- JavaScript linter
```
typescript
```
- TypeScript compiler

```
node
```
- JavaScript运行时
```
npm
```
/
```
pnpm
```
- 包管理器
```
prettier
```
- 代码格式化工具
```
eslint
```
- JavaScript代码检查工具
```
typescript
```
- TypeScript编译器

Security Tools

安全工具

```
trivy
```
- Vulnerability scanner
```
grype
```
- Container scanner
```
cosign
```
- Container signing

```
trivy
```
- 漏洞扫描工具
```
grype
```
- 容器扫描工具
```
cosign
```
- 容器签名工具

Auto-Install Workflow

自动安装流程

When a command fails with "command not found":

Extract tool name from error message
Lookup package name in binary-to-tool mapping
Detect OS (macOS/Linux)
Install using appropriate package manager
Retry original command

Example:

bash

undefined

当命令执行报错“command not found”时：

提取工具名称：从错误信息中获取缺失的工具名
查找包名称：在二进制与工具映射表中查找对应的包名
检测操作系统：识别当前系统（macOS/Linux）
执行安装：使用对应包管理器安装工具
重试命令：重新执行原本的命令

示例：

bash

undefined

Error: zsh: command not found: rg

Resolution:

解决方法：

brew install ripgrep # macOS

or

或

sudo apt install ripgrep # Linux

Retry

重试命令

rg "pattern" .

undefined

rg "pattern" .

undefined

Batch Update

批量更新

Update all managed tools:

bash

undefined

更新所有已管理的工具：

bash

undefined

macOS

brew update && brew upgrade

Linux

sudo apt update && sudo apt upgrade

PHP global tools

PHP全局工具

composer global update

Node global tools

Node全局工具

npm update -g

---

npm update -g

---

Credits & Attribution

致谢与归属

Thanks to Netresearch DTT GmbH for their contributions to the TYPO3 community.

感谢Netresearch DTT GmbH为TYPO3社区做出的贡献。