TERMINAL

One Command to Arm Your Terminal

AI coding agents are only as good as the tools on the machine. A fresh install has few of them. agent-loadout installs a curated set of 64 terminal tools -- the ones that actually matter for agentic workflows.

$npx agent-loadout
v1.2.0
64 Tools / macOS + Linux + Windows
01 / Presets

CHOOSE YOUR LOADOUT

No. 01On by default

Core

9 tools

The essentials. ripgrep, fd, jq, yq, bat, tree, GitHub CLI, fzf, and xh. Fastest code search, JSON/YAML slicing, and HTTP from the terminal.

ripgrepfdjqyqbattree+3 more
No. 02On by default

Agent

20 tools

Tools that make AI agents genuinely more capable. AST-level search, static analysis, benchmarking, load testing, link checking, prose linting, and structured code operations.

shellcheckast-grepjustgrexknipsd+14 more
No. 03Optional

Media

4 tools

Audio, video, and image processing pipelines. ffmpeg, exiftool, ImageMagick, and libvips for heavy-duty media work.

ffmpegexiftoolimagemagickvips
No. 04Optional

Design

7 tools

Visual asset workflows. SVG optimization and rendering, colour palettes, diagramming, and PNG compression.

svgoresvgchafapasteld2pngquant+1 more
No. 05Optional

DX

18 tools

Developer experience tools. Modern replacements for ls, cd, ps, du, and git diff. Runtime management, file watching, local HTTPS, and terminal recording.

ezazoxidedeltaglowmisewatchexec+12 more
No. 06Optional

Security

6 tools

Vulnerability scanning, secret detection, local CI testing, static analysis, file encryption, and DNS inspection.

trivyactgitleakssemgrepagedoggo
02 / Catalog

FEATURED TOOLS

Core

ripgrep

Fastest code search available. 10-100x faster than grep. Agents use it constantly to locate symbols and patterns across large codebases.

Rust · Unlicense · 60.6k ★

01
Agent

ast-grep

Structural code search using AST patterns. Find usages, rename methods, enforce patterns without false positives.

Rust · MIT · 12.8k ★

02
Agent

duckdb

Embedded SQL engine that queries CSV, JSON, and Parquet files directly. Ideal for log analysis and data exploration.

C++ · MIT · 36.5k ★

03
Core

jq

The standard tool for slicing and transforming JSON from APIs, config files, and CLI output.

C · 33.8k ★

04
Security

trivy

Comprehensive vulnerability scanner for containers, filesystems, git repos, and IaC configs. Surface CVEs before they ship.

Go · Apache-2.0 · 32.9k ★

05
Agent

biome

Fast, zero-config linter and formatter for JS/TS. Format and lint in a single pass before committing.

Rust · Apache-2.0 · 23.9k ★

06
02.1 / Full Inventory

ALL 64 TOOLS

Health data as of March 2026

Core

9 toolsDefault
01ripgrep

Fastest code search available -- 10-100x faster than grep. Respects .gitignore by default.

Rust · Unlicense · 60.6k ★ · active

02fd

Modern find replacement that's faster and has sane defaults. Output is clean and scriptable.

Rust · Apache-2.0 · 41.9k ★ · active

03jq

The standard tool for slicing and transforming JSON from APIs, config files, and CLI output.

C · 33.8k ★ · active

04yq

Does for YAML what jq does for JSON -- reads, writes, and transforms YAML/TOML/XML.

Go · MIT · 15.0k ★ · active

05bat

cat with syntax highlighting, line numbers, and git diff markers.

Rust · Apache-2.0 · 57.5k ★ · active

06tree

Prints a directory as an ASCII tree -- one of the most token-efficient ways to understand project structure.

C · GPL-2.0 · stable since 1996

07GitHub CLI

Full GitHub API access from the terminal -- PRs, issues, releases, workflows, and more.

Go · MIT · 42.9k ★ · active

08fzf

Interactive fuzzy finder that makes any list selectable. Pipe file lists, git branches, or command history.

Go · MIT · 78.3k ★ · active

09xh

Friendly, fast HTTP client with sensible defaults and coloured output.

Rust · MIT · 7.6k ★ · active

Agent

20 toolsDefault
01shellcheck

Static analyser for bash/sh scripts that catches bugs and bad practices before they run.

Haskell · GPL-3.0 · 39.1k ★ · active

02ast-grep

Structural code search and replace using AST patterns rather than text.

Rust · MIT · 12.8k ★ · active

03just

A make alternative with clean syntax that doubles as a project task menu.

Rust · CC0-1.0 · 31.9k ★ · active

04grex

Generates regex patterns from example strings you provide.

Rust · Apache-2.0 · 8.1k ★ · active

05knip

Finds unused exports, files, and dependencies in TypeScript/JavaScript projects.

TypeScript · ISC · 10.4k ★ · active

06sd

Simpler, safer sed for find-and-replace across files. Literal by default.

Rust · MIT · 7.0k ★ · active

07hyperfine

Benchmarking tool that runs commands repeatedly and reports statistical results.

Rust · Apache-2.0 · 27.6k ★ · active

08tokei

Reports lines of code by language across a project.

Rust · 14.0k ★ · active

09tldr

Community-maintained cheat sheets for CLI tools, focused on practical examples.

Markdown · 61.6k ★ · active

10biome

Fast, zero-config linter and formatter for JavaScript and TypeScript.

Rust · Apache-2.0 · 23.9k ★ · active

11difftastic

Structural diff that compares files by AST rather than line-by-line.

Rust · MIT · 24.3k ★ · active

12pandoc

Converts documents between virtually any format -- Markdown, HTML, PDF, DOCX, LaTeX.

Haskell · GPL-2.0 · 42.4k ★ · active

13duckdb

Embedded SQL engine that queries CSV, JSON, and Parquet files directly.

C++ · MIT · 36.5k ★ · active

14htmlq

Extracts content from HTML using CSS selectors, like jq for web pages.

Rust · MIT · 7.5k ★ · last push 2024

15typos

Source code spell checker that finds common typos in identifiers, comments, and strings.

Rust · Apache-2.0 · 3.8k ★ · active

16gum

Beautiful, interactive UI primitives (prompts, spinners, filters) for shell scripts.

Go · MIT · 23.0k ★ · active

17oha

HTTP load tester with JSON output. Benchmarks endpoints with structured latency and throughput data.

Rust · MIT · 10.1k ★ · active

18gron

Flattens JSON into greppable assignment statements. Find paths in complex API responses without jq.

Go · MIT · 14.4k ★ · last push 2025

19lychee

Fast link checker for markdown, HTML, and websites. Catches broken and dead URLs.

Rust · Apache-2.0 · 3.4k ★ · active

20vale

Prose linter that enforces writing style guides on documentation and README files.

Go · MIT · 5.3k ★ · active

Media

4 tools
01ffmpeg

Industry-standard tool for audio and video processing -- transcoding, trimming, extracting frames.

C · LGPL/GPL · 57.6k ★ · active

02exiftool

Reads and writes metadata from images, video, audio, and documents.

Perl · GPL-3.0 · 4.5k ★ · active

03ImageMagick

Comprehensive image manipulation -- resize, crop, convert, annotate, composite.

C · Apache-2.0 · 15.9k ★ · active

04libvips

Fast image processing pipeline with low memory usage. Powers Sharp. Faster than ImageMagick for batch operations.

C · LGPL-2.1 · 11.1k ★ · active

Design

7 tools
01svgo

Optimises SVG files by removing redundant data. Often 30-70% smaller.

JavaScript · MIT · 22.4k ★ · active

02resvg

High-fidelity SVG-to-PNG renderer. Handles complex SVGs that other tools misrender.

Rust · Apache-2.0 · 3.7k ★ · active

03chafa

Renders images as ANSI text art in the terminal. Lets agents visually inspect images without a GUI.

C · LGPL-3.0 · 4.4k ★ · active

04pastel

Colour manipulation tool for generating, converting, and inspecting colours and palettes.

Rust · Apache-2.0 · 6.3k ★ · active

05d2

Declarative diagramming language. Generate architecture diagrams, flowcharts, and ERDs from text.

Go · MPL-2.0 · 23.2k ★ · active

06pngquant

Lossy PNG compressor that cuts 50-80% off file size with minimal visual quality loss.

C · 5.6k ★ · active

07oxipng

Lossless PNG optimizer. Guaranteed size reduction with zero quality loss.

Rust · MIT · 3.8k ★ · active

DX

18 tools
01eza

Modern ls replacement with colour-coded output, git status integration, and tree view.

Rust · EUPL-1.2 · 20.4k ★ · active

02zoxide

Learns your most-used directories and lets you jump to them by partial name.

Rust · MIT · 34.0k ★ · active

03delta

Syntax-highlighted, side-by-side git diffs with line numbers.

Rust · MIT · 29.3k ★ · active

04glow

Renders Markdown beautifully in the terminal.

Go · MIT · 23.4k ★ · active

05mise

Manages runtime versions (Node, Python, Ruby, Go) per project via .mise.toml.

Rust · MIT · 25.3k ★ · active

06watchexec

Runs a command whenever files change. Reduces the feedback loop.

Rust · Apache-2.0 · 6.8k ★ · active

07mkcert

Creates locally-trusted HTTPS certificates for development with zero configuration.

Go · BSD-3-Clause · 58.3k ★ · stable

08lazygit

Full-featured TUI git client for staging, committing, branching, and rebasing.

Go · MIT · 73.6k ★ · active

09dust

Visual disk usage tree that shows what's consuming space, sorted by size.

Rust · Apache-2.0 · 11.3k ★ · active

10bottom

System resource monitor (CPU, memory, network, processes) as a TUI.

Rust · MIT · 13.0k ★ · active

11direnv

Loads and unloads environment variables automatically when entering/leaving a directory.

Go · MIT · 14.7k ★ · active

12procs

Modern ps replacement with search, colour coding, and tree view.

Rust · MIT · 6.0k ★ · active

13uv

Extremely fast Python package installer and virtual environment manager.

Rust · Apache-2.0 · 80.3k ★ · active

14hexyl

Hex viewer with colour-coded output distinguishing printable characters and control codes.

Rust · Apache-2.0 · 10.0k ★ · active

15taplo

TOML formatter, linter, and query tool for Rust projects and pyproject.toml.

Rust · MIT · 2.2k ★ · active

16fx

Interactive JSON viewer with JavaScript expression support. Visual exploration of nested data.

Go · MIT · 20.3k ★ · active

17csview

CSV and TSV viewer with aligned columns for readable tabular data in the terminal.

Rust · Apache-2.0 · 690 ★ · last push 2025

18asciinema

Records terminal sessions as lightweight text files for documentation and demos.

Rust · GPL-3.0 · 16.9k ★ · active

Security

6 tools
01trivy

Comprehensive vulnerability scanner for containers, filesystems, git repos, and IaC configs.

Go · Apache-2.0 · 32.9k ★ · active

02act

Runs GitHub Actions workflows locally using Docker. Faster iteration on workflow files.

Go · MIT · 69.2k ★ · active

03gitleaks

Scans git history and working trees for accidentally committed secrets.

Go · MIT · 25.2k ★ · active

04semgrep

Multi-language static analysis using pattern rules -- finds security bugs and anti-patterns.

OCaml · LGPL-2.1 · 14.3k ★ · active

05age

Simple, modern file encryption with a clean CLI. Resistant to misuse by design.

Go · BSD-3-Clause · 21.5k ★ · active

06doggo

Modern DNS lookup tool with JSON output and DNS-over-HTTPS support.

Go · GPL-3.0 · 4.2k ★ · active

03 / Who It's For

WHO IS THIS FOR

Different roles, same superpower. Pick your perspective to see which tools matter most for your workflow.

CLI tools aren't just for backend engineers. Process images, manipulate colours, render SVGs, generate diagrams, and compress assets — all from the terminal, all agent-accessible.

svgo

design
Use case

Optimise SVGs by 30-70%. Strip redundant metadata from icons and illustrations.

Agent use

Agents optimise SVG assets in bulk before deployment — smaller bundles, faster loads.

resvg

design
Use case

Render SVG designs to pixel-perfect PNGs for social cards, OG images, and icon sets.

Agent use

Agents generate production PNGs from SVG templates — OG images, favicons, app icons in one pass.

chafa

design
Use case

Quick-preview images directly in the terminal without switching to a GUI app.

Agent use

Agents visually inspect generated images, screenshots, and thumbnails without leaving the terminal.

pastel

design
Use case

Generate palettes, convert between colour spaces, derive tints and shades from brand colours.

Agent use

Agents programmatically build design token files — derive entire palettes from a single brand colour.

d2

design
Use case

Write architecture diagrams, flowcharts, and ERDs as text. Render to SVG or PNG.

Agent use

Agents generate diagrams from code analysis — describe structure in text, get publication-ready visuals.

pngquant

design
Use case

Lossy PNG compression — cut 50-80% off file size with minimal visual quality loss.

Agent use

Agents compress screenshots and generated images before committing — smaller repos, faster pages.

oxipng

design
Use case

Lossless PNG optimization. Run after pngquant or standalone for zero-loss compression.

Agent use

Agents run oxipng as a final pass on all PNG assets — guaranteed size reduction, zero quality loss.

libvips

media
Use case

Batch-resize product images, generate thumbnails, convert formats. 5-10x faster than ImageMagick.

Agent use

Agents process image assets in bulk without hitting memory limits. Powers Sharp under the hood.

04 / Workflow

HOW IT WORKS

01 / CHOOSE

CHOOSE PRESETS

Core and Agent are on by default. Toggle Media, DX, and Security presets. Deselect any individual tool you don't need.

02 / PREVIEW

PREVIEW & INSTALL

See the exact install commands before anything runs. Runs the right package manager for your OS -- brew, apt, scoop, cargo, or npm.

03 / VERIFY

VERIFY EVERYTHING

Every tool is checked after installation. No silent failures. Run npx agent-loadout verify at any time to confirm what's working.

04 / WRITE

WRITE SKILLS

Generates skill files your AI agent can read. Each skill is a focused playbook with trusted commands, output formats, and gotchas.

05 / Changelog

RELEASES

v1.2.02026-03-0614 new tools, persona sections, health metadata64 tools total. d2, pngquant, oxipng, gron, lychee, vale. Multi-persona website section. Per-tool GitHub stats and links.
v1.1.02026-03-068 design & creative tools, design preset58 tools total. svgo, resvg, chafa, pastel, vips, oha, fx, csview, asciinema. New design preset.
v1.0.32026-02-28Skill files improved to 9.5/10 qualityAll 50 skill files rewritten with trusted commands, gotchas, and agent tips.
v1.0.02026-02-25Initial release50 curated tools across 5 presets. Cross-platform (macOS, Linux, Windows). Skill file generation.
06 / Reference

COMMANDS

npx agent-loadoutInteractive install (default)
npx agent-loadout install --preset core agent --applyInstall specific presets
npx agent-loadout install --all --applyInstall everything
npx agent-loadout verifyCheck what's installed
npx agent-loadout listFull catalog
npx agent-loadout skillsWrite skill files
npx agent-loadout skills --forceRewrite all skill files
npx agent-loadout list --brewfileGenerate Brewfile (macOS)

Requirements

  • Node.js 20+
  • Homebrew (macOS)
  • apt-get (Linux)
  • Scoop (Windows)

Platforms

  • macOS
  • Linux
  • Windows

Skill Files

  • ~/.claude/skills/agent-loadout/
  • ~/.agent-loadout/skills/
  • Auto-discovered by Claude Code and other agents

License

  • MIT
  • Open Source

agent-loadout / by conorluddy

One command. 64 tools. Your agent is ready.