agent-loadout 1.0.1 → 1.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -3
- package/dist/index.js +140 -25
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -132,6 +132,12 @@ npx agent-loadout list --json
|
|
|
132
132
|
|
|
133
133
|
# Print a generated Brewfile (macOS only)
|
|
134
134
|
npx agent-loadout list --brewfile
|
|
135
|
+
|
|
136
|
+
# Write missing skill files for installed tools
|
|
137
|
+
npx agent-loadout skills
|
|
138
|
+
|
|
139
|
+
# Rewrite all skill files (e.g. after upgrading agent-loadout)
|
|
140
|
+
npx agent-loadout skills --force
|
|
135
141
|
```
|
|
136
142
|
|
|
137
143
|
## Brewfile alternative (macOS)
|
|
@@ -144,12 +150,24 @@ brew bundle
|
|
|
144
150
|
|
|
145
151
|
## Skills
|
|
146
152
|
|
|
147
|
-
When you install tools, `agent-loadout` writes skill files to
|
|
153
|
+
When you install tools, `agent-loadout` writes skill files to:
|
|
148
154
|
|
|
149
|
-
- `~/.claude/skills/` —
|
|
155
|
+
- `~/.claude/skills/agent-loadout/` — auto-discovered by Claude Code
|
|
150
156
|
- `~/.agent-loadout/skills/` — generic copy for other agents
|
|
151
157
|
|
|
152
|
-
Each skill is a focused playbook
|
|
158
|
+
Each skill is a focused playbook: what the tool does, trusted commands, output formats, and gotchas. A `SKILL.md` index is also written, with every installed tool and its primary use case packed into the frontmatter — so your agent sees the full inventory in its system prompt on every session without loading individual files.
|
|
159
|
+
|
|
160
|
+
### Syncing skills
|
|
161
|
+
|
|
162
|
+
Skills are written automatically after `install`. To write or refresh them independently:
|
|
163
|
+
|
|
164
|
+
```sh
|
|
165
|
+
# Write skills for any installed tools that don't have one yet
|
|
166
|
+
npx agent-loadout skills
|
|
167
|
+
|
|
168
|
+
# Rewrite skill files for all installed tools
|
|
169
|
+
npx agent-loadout skills --force
|
|
170
|
+
```
|
|
153
171
|
|
|
154
172
|
## Requirements
|
|
155
173
|
|
package/dist/index.js
CHANGED
|
@@ -487,19 +487,25 @@ var jq_default = `
|
|
|
487
487
|
Filter, transform, and extract data from JSON. Essential for working with API responses and config files.
|
|
488
488
|
|
|
489
489
|
## Trusted commands
|
|
490
|
-
- Pretty print: \`
|
|
491
|
-
- Extract field: \`jq '.fieldName'\`
|
|
490
|
+
- Pretty print: \`jq . file.json\`
|
|
491
|
+
- Extract field: \`jq '.fieldName' file.json\`
|
|
492
492
|
- Pick multiple fields: \`jq '{id, name, status}'\`
|
|
493
493
|
- Map over array: \`jq '[.items[] | {id, name}]'\`
|
|
494
494
|
- Count array: \`jq '.items | length'\`
|
|
495
495
|
- Filter: \`jq '.items[] | select(.status == "active")'\`
|
|
496
496
|
- Default for missing: \`jq '.name // "unknown"'\`
|
|
497
|
-
- Validate JSON (fail on error): \`jq -e
|
|
497
|
+
- Validate JSON (fail on error): \`jq -e . file.json\`
|
|
498
|
+
|
|
499
|
+
## Output format
|
|
500
|
+
Pretty-printed JSON by default. Use \`-r\` for raw strings (no quotes). Use \`-c\` for compact single-line JSON. \`-e\` / \`--exit-status\` exits non-zero on null or false output.
|
|
501
|
+
|
|
502
|
+
## Why it matters for agents
|
|
503
|
+
The standard tool for parsing API responses and config files in shell pipelines. \`-e\` flag makes null checks composable: \`jq -e '.token' response.json || exit 1\`.
|
|
498
504
|
|
|
499
505
|
## Gotchas
|
|
500
|
-
- Use \`-
|
|
501
|
-
- Use
|
|
502
|
-
-
|
|
506
|
+
- Use \`-r\` for raw string output (no quotes) \u2014 required when passing jq output to other commands.
|
|
507
|
+
- Missing fields return null, not an error. Use \`//\` for defaults: \`.name // "unknown"\`.
|
|
508
|
+
- Use \`-e\` to get non-zero exit code on null/false results \u2014 essential for conditional pipelines.
|
|
503
509
|
`.trim();
|
|
504
510
|
|
|
505
511
|
// src/skills/yq.ts
|
|
@@ -516,6 +522,9 @@ Same as jq but for YAML files. Query, filter, and transform YAML.
|
|
|
516
522
|
- Update in place: \`yq -i '.version = "2.0"' file.yaml\`
|
|
517
523
|
- Merge files: \`yq eval-all 'select(fi == 0) * select(fi == 1)' a.yaml b.yaml\`
|
|
518
524
|
|
|
525
|
+
## Output format
|
|
526
|
+
YAML by default. \`--output-format=json\` (or \`-o json\`) for JSON. \`--output-format=props\` for Java properties format. \`-P\` (prettyPrint) for pretty YAML from any input format.
|
|
527
|
+
|
|
519
528
|
## Gotchas
|
|
520
529
|
- There are multiple tools called yq. This refers to the Go version (mikefarah/yq), installed via brew.
|
|
521
530
|
- Use \`-i\` carefully \u2014 it modifies files in place.
|
|
@@ -605,16 +614,29 @@ var fzf_default = `
|
|
|
605
614
|
# fzf \u2014 Fuzzy finder
|
|
606
615
|
|
|
607
616
|
## When to use
|
|
608
|
-
Interactive fuzzy search for files, command history, git branches \u2014 anything with a list.
|
|
617
|
+
Interactive fuzzy search for files, command history, git branches \u2014 anything with a list. Also useful non-interactively via \`--filter\`.
|
|
609
618
|
|
|
610
619
|
## Trusted commands
|
|
611
|
-
- Find files: \`fzf\`
|
|
620
|
+
- Find files interactively: \`fzf\`
|
|
612
621
|
- Pipe any list: \`git branch | fzf\`
|
|
613
622
|
- Preview files: \`fzf --preview 'bat --color=always {}'\`
|
|
614
623
|
- With fd: \`fd -t f | fzf\`
|
|
624
|
+
- Non-interactive filter (scripting): \`echo -e "foo
|
|
625
|
+
bar
|
|
626
|
+
baz" | fzf --filter "ba"\`
|
|
627
|
+
- Multi-select: \`fzf --multi\`
|
|
628
|
+
|
|
629
|
+
## Output format
|
|
630
|
+
Selected line(s) written to stdout, newline-separated. Exits 130 if the user cancels (Ctrl-C or Esc) \u2014 use this to detect cancellation in scripts. In \`--filter\` mode, prints all lines that match the query and exits 0/1.
|
|
631
|
+
|
|
632
|
+
## Why it matters for agents
|
|
633
|
+
\`--filter\` mode makes fzf a non-interactive fuzzy matcher \u2014 pipe a list in, get filtered results out without any TUI. Useful for selecting the best match from a known set without full regex. Exit code 130 on cancel is a reliable signal in pipelines.
|
|
615
634
|
|
|
616
635
|
## Gotchas
|
|
617
|
-
-
|
|
636
|
+
- Exit code 130 on cancel \u2014 check for this in scripts to detect user abort vs no results (exit 1).
|
|
637
|
+
- \`FZF_DEFAULT_COMMAND\` sets the default input source (e.g. \`export FZF_DEFAULT_COMMAND='fd -t f'\`).
|
|
638
|
+
- \`--filter\` runs non-interactively \u2014 pipe-safe for scripting without a TTY.
|
|
639
|
+
- \`--multi\` outputs one selected item per line; combine with \`xargs\` for batch operations.
|
|
618
640
|
`.trim();
|
|
619
641
|
|
|
620
642
|
// src/skills/shellcheck.ts
|
|
@@ -663,6 +685,9 @@ Search and replace code using syntax tree patterns instead of regex. Far safer f
|
|
|
663
685
|
- Replacing with structural awareness (e.g. moving arguments)
|
|
664
686
|
- Any refactor where brackets/nesting matters
|
|
665
687
|
|
|
688
|
+
## Output format
|
|
689
|
+
\`file:line:col: matched text\` format by default. \`--json\` emits structured match objects with file, range, metavariable bindings, and matched text \u2014 use for programmatic processing of results.
|
|
690
|
+
|
|
666
691
|
## Gotchas
|
|
667
692
|
- The binary is called \`sg\`, not \`ast-grep\`.
|
|
668
693
|
- \`$ARG\` is a metavariable that matches any single node. \`$$$ARGS\` matches multiple.
|
|
@@ -704,6 +729,9 @@ Generate a regular expression from a set of example strings. Useful when you kno
|
|
|
704
729
|
- Case insensitive: \`grex --ignore-case "Foo" "FOO" "foo"\`
|
|
705
730
|
- Verbose regex: \`grex --verbose "foo-123" "bar-456"\`
|
|
706
731
|
|
|
732
|
+
## Output format
|
|
733
|
+
Single regex string to stdout, ready to copy-paste or pipe. No trailing newline issues \u2014 capture with \`PATTERN=$(grex ...)\` and use directly.
|
|
734
|
+
|
|
707
735
|
## Gotchas
|
|
708
736
|
- Output is a raw regex string \u2014 pipe directly into \`rg\`, \`sd\`, or save to a variable.
|
|
709
737
|
|
|
@@ -725,6 +753,9 @@ Detect unused files, exports, dependencies, and types in TypeScript/JavaScript p
|
|
|
725
753
|
- Unused deps only: \`knip --include dependencies\`
|
|
726
754
|
- Machine-readable with scopes: \`knip --reporter json --include files,exports,dependencies\`
|
|
727
755
|
|
|
756
|
+
## Output format
|
|
757
|
+
Text report to stdout grouped by category (files, exports, dependencies). \`--reporter json\` emits a structured JSON object with arrays per category \u2014 pipe to \`jq\` to filter specific types. Exits 1 if issues found (CI-friendly).
|
|
758
|
+
|
|
728
759
|
## Why it matters for agents
|
|
729
760
|
Identifies dead code before large refactors \u2014 agents can safely delete unused files and exports flagged by knip without breaking the build.
|
|
730
761
|
|
|
@@ -748,6 +779,9 @@ Find and replace in files. Like sed but with intuitive syntax \u2014 no escaping
|
|
|
748
779
|
- Regex replace: \`sd 'v(\\d+)' 'version-$1' file.txt\`
|
|
749
780
|
- Replace across files (with fd): \`fd -e ts -x sd 'old' 'new' {}\`
|
|
750
781
|
|
|
782
|
+
## Output format
|
|
783
|
+
Rewrites the file in-place with no stdout output. Use \`-p\` / \`--preview\` to print a diff of what would change without modifying the file \u2014 safe to run first.
|
|
784
|
+
|
|
751
785
|
## Gotchas
|
|
752
786
|
- Uses regex by default. Use \`-F\` for fixed/literal strings.
|
|
753
787
|
- Modifies files in place when given a filename. Use \`-p\` to preview first.
|
|
@@ -772,12 +806,17 @@ Benchmark commands to compare performance. Runs commands multiple times and repo
|
|
|
772
806
|
- Non-interactive + export: \`hyperfine --style basic --export-json results.json 'cmd1' 'cmd2'\`
|
|
773
807
|
- With prepare step: \`hyperfine --prepare 'make clean' 'make build'\`
|
|
774
808
|
|
|
809
|
+
## Output format
|
|
810
|
+
Human-readable table to stderr by default (mean, stddev, min, max per command). \`--export-json results.json\` writes structured JSON with full timing arrays. \`--style basic\` disables the progress bar and colour \u2014 required for clean CI logs.
|
|
811
|
+
|
|
775
812
|
## Why it matters for agents
|
|
776
813
|
\`--export-json\` lets agents compare builds and commands quantitatively \u2014 structured results include mean, stddev, min, max per command.
|
|
777
814
|
|
|
778
815
|
## Gotchas
|
|
779
816
|
- Wrap commands in quotes.
|
|
780
817
|
- Use \`--warmup\` for commands that benefit from caching.
|
|
818
|
+
- Use \`--style basic\` in CI environments \u2014 disables the progress bar and colour codes that pollute CI logs.
|
|
819
|
+
- Use \`--shell=none\` to avoid shell startup overhead when benchmarking micro-operations.
|
|
781
820
|
`.trim();
|
|
782
821
|
|
|
783
822
|
// src/skills/tokei.ts
|
|
@@ -853,6 +892,8 @@ Read, write, and strip metadata (EXIF, IPTC, XMP) from images and media files.
|
|
|
853
892
|
## Gotchas
|
|
854
893
|
- Field names are case-insensitive.
|
|
855
894
|
- Use \`-json\` for structured output.
|
|
895
|
+
- By default, modifying metadata creates a \`filename_original\` backup file \u2014 use \`-overwrite_original\` to skip backups when you're confident in the operation.
|
|
896
|
+
- Without \`-overwrite_original\`, directories fill up with \`*_original\` files after batch operations \u2014 clean up with \`find . -name "*_original" -delete\`.
|
|
856
897
|
|
|
857
898
|
## Why it matters for agents
|
|
858
899
|
\`-json\` output enables structured metadata extraction from any media file \u2014 agents can batch-read EXIF data, filter by GPS coordinates, or rename files by capture date programmatically.
|
|
@@ -877,7 +918,9 @@ Resize, crop, convert, and manipulate images from the command line.
|
|
|
877
918
|
- \`magick mogrify\` modifies files in place. Use \`magick convert\` (or just \`magick in out\`) for safe transforms.
|
|
878
919
|
|
|
879
920
|
## Gotchas
|
|
880
|
-
- The binary is \`magick\` (ImageMagick 7). Older versions used \`convert
|
|
921
|
+
- The binary is \`magick\` (ImageMagick 7). Older versions used \`convert\` \u2014 don't use \`convert\` on macOS as it shadows a system binary.
|
|
922
|
+
- Always specify the output format explicitly in the filename \u2014 \`magick input.png output.jpg\` converts; omitting extension may produce unexpected formats.
|
|
923
|
+
- \`mogrify\` modifies files destructively in place \u2014 always test with \`magick convert\` on a single file first, or back up the originals.
|
|
881
924
|
|
|
882
925
|
## Why it matters for agents
|
|
883
926
|
Batch image processing without opening apps \u2014 useful for automated asset pipelines. Agents can resize, convert formats, and generate thumbnails in a single \`mogrify\` invocation.
|
|
@@ -920,6 +963,18 @@ List files with better defaults: colours, git status, icons, tree view built in.
|
|
|
920
963
|
- Tree view: \`eza --tree\`
|
|
921
964
|
- Tree with depth limit: \`eza --tree --level 2\`
|
|
922
965
|
- All files (including hidden): \`eza -la\`
|
|
966
|
+
- Machine-readable tree: \`eza --tree --json\`
|
|
967
|
+
|
|
968
|
+
## Output format
|
|
969
|
+
Plain text with aligned columns by default. \`--json\` emits a structured JSON tree of file entries with name, path, type, size, and permissions. \`--git\` adds a column showing each file's git status (untracked, modified, staged).
|
|
970
|
+
|
|
971
|
+
## Why it matters for agents
|
|
972
|
+
\`eza --tree --json\` provides a structured file tree without spawning \`find\` or parsing \`ls\` output \u2014 agents can parse it directly to navigate unfamiliar repos. \`--git\` flag surfaces repo status per-file without running \`git status\`.
|
|
973
|
+
|
|
974
|
+
## Gotchas
|
|
975
|
+
- Binary is named \`eza\`, not \`ls\` \u2014 aliasing \`ls=eza\` is common but optional.
|
|
976
|
+
- \`--icons\` requires a Nerd Font in your terminal; omit it in CI or non-Nerd-Font sessions.
|
|
977
|
+
- \`--git\` is noticeably slow on large repos (it calls libgit2 per entry) \u2014 avoid in hot loops.
|
|
923
978
|
`.trim();
|
|
924
979
|
|
|
925
980
|
// src/skills/zoxide.ts
|
|
@@ -929,15 +984,25 @@ var zoxide_default = `
|
|
|
929
984
|
## When to use
|
|
930
985
|
Jump to frequently used directories without typing full paths. Learns from your usage.
|
|
931
986
|
|
|
932
|
-
## Setup
|
|
933
|
-
Add to ~/.zshrc: \`eval "$(zoxide init zsh)"\`
|
|
934
|
-
Then use \`z\` instead of \`cd\`: \`z projects\` jumps to your most-used match.
|
|
935
|
-
|
|
936
987
|
## Trusted commands
|
|
937
988
|
- Jump: \`z partial-dirname\`
|
|
938
|
-
- Interactive
|
|
989
|
+
- Interactive jump (requires fzf): \`zi\`
|
|
990
|
+
- Resolve best match (no cd): \`zoxide query <term>\`
|
|
991
|
+
- List all known paths with scores: \`zoxide query --list\`
|
|
939
992
|
- Add path manually: \`zoxide add /path/to/dir\`
|
|
940
|
-
-
|
|
993
|
+
- Remove a path: \`zoxide remove /path/to/dir\`
|
|
994
|
+
|
|
995
|
+
## Output format
|
|
996
|
+
\`z\` emits nothing \u2014 it just changes the shell directory. \`zoxide query <term>\` prints the best-match absolute path as a plain string to stdout. \`zoxide query --list\` prints tab-separated score + path pairs, sorted by frecency.
|
|
997
|
+
|
|
998
|
+
## Why it matters for agents
|
|
999
|
+
\`zoxide query <term>\` returns the best-match absolute path without navigating \u2014 use it for path resolution when you know a partial name but not the full path. Avoids hardcoding paths that differ between machines.
|
|
1000
|
+
|
|
1001
|
+
## Gotchas
|
|
1002
|
+
- Must be initialised in shell config: \`eval "$(zoxide init zsh)"\` in ~/.zshrc. Without this, \`z\` is unavailable.
|
|
1003
|
+
- Frecency scores update on each \`z\` usage \u2014 a new directory won't rank highly until visited repeatedly.
|
|
1004
|
+
- \`zi\` is interactive (TUI with fzf) \u2014 use \`zoxide query\` for non-interactive scripting.
|
|
1005
|
+
- Shell integration required: zoxide works by hooking into \`cd\`; doesn't affect subshells unless initialised there too.
|
|
941
1006
|
`.trim();
|
|
942
1007
|
|
|
943
1008
|
// src/skills/delta.ts
|
|
@@ -962,6 +1027,8 @@ Add to ~/.gitconfig:
|
|
|
962
1027
|
|
|
963
1028
|
## Gotchas
|
|
964
1029
|
- The brew package is called \`git-delta\`, but the binary is \`delta\`.
|
|
1030
|
+
- Configured via \`~/.gitconfig\` (not CLI flags at runtime) \u2014 add \`[delta]\` section with options like \`side-by-side = true\`, \`line-numbers = true\`.
|
|
1031
|
+
- Enable with \`git config --global core.pager delta\` \u2014 without this, delta is not invoked automatically.
|
|
965
1032
|
|
|
966
1033
|
## Why it matters for agents
|
|
967
1034
|
Makes \`git diff\` and \`git log -p\` output readable \u2014 useful when agents are reviewing code changes or summarising commits for users.
|
|
@@ -977,12 +1044,21 @@ Render markdown files beautifully in the terminal. Great for reading READMEs, do
|
|
|
977
1044
|
## Trusted commands
|
|
978
1045
|
- Render file: \`glow README.md\`
|
|
979
1046
|
- Render with pager: \`glow -p README.md\`
|
|
980
|
-
- Render from stdin: \`
|
|
1047
|
+
- Render from stdin: \`glow -\`
|
|
981
1048
|
- Disable pager: \`glow --no-pager README.md\`
|
|
982
1049
|
- Fixed width: \`glow --width 100 README.md\`
|
|
1050
|
+
- Plain output (no ANSI): \`glow --style=ascii README.md\`
|
|
1051
|
+
|
|
1052
|
+
## Output format
|
|
1053
|
+
ANSI-formatted markdown to stdout by default \u2014 colours, bold, tables rendered for terminal display. Use \`--style=ascii\` to strip ANSI codes for piping into other tools or log capture. Activates a pager automatically for long content.
|
|
983
1054
|
|
|
984
1055
|
## Why it matters for agents
|
|
985
|
-
Renders markdown cleanly in terminal output \u2014 useful for displaying skill files, changelogs, or generated docs to users without raw markdown symbols.
|
|
1056
|
+
Renders markdown cleanly in terminal output \u2014 useful for displaying skill files, changelogs, or generated docs to users without raw markdown symbols. \`--style=ascii\` makes output safe to capture or pipe.
|
|
1057
|
+
|
|
1058
|
+
## Gotchas
|
|
1059
|
+
- Pager activates by default for long content \u2014 use \`--no-pager\` in scripts to avoid blocking on stdin.
|
|
1060
|
+
- Output wraps at terminal width; use \`--width\` to control line length in narrow terminals.
|
|
1061
|
+
- Requires markdown-formatted input \u2014 feeding plain text will render as-is with no improvement.
|
|
986
1062
|
`.trim();
|
|
987
1063
|
|
|
988
1064
|
// src/skills/mise.ts
|
|
@@ -1025,7 +1101,9 @@ Watch files for changes and re-run a command. Language-agnostic alternative to n
|
|
|
1025
1101
|
|
|
1026
1102
|
## Gotchas
|
|
1027
1103
|
- Use \`-e\` to filter by extension, \`-w\` to filter by directory.
|
|
1028
|
-
- Use \`--restart\` for long-running processes (servers)
|
|
1104
|
+
- Use \`--restart\` for long-running processes (servers) \u2014 without it, watchexec waits for the previous run to finish before starting the next.
|
|
1105
|
+
- Use \`--no-vcs-ignore\` to watch files listed in \`.gitignore\` \u2014 by default, gitignored files are excluded from watch events.
|
|
1106
|
+
- Debounce is applied by default (300ms) \u2014 rapid file saves trigger one execution, not many.
|
|
1029
1107
|
|
|
1030
1108
|
## Why it matters for agents
|
|
1031
1109
|
Enables live-reload dev loops \u2014 agents can set up reactive pipelines (\`watchexec -e ts "pnpm typecheck"\`) and report on each change without polling.
|
|
@@ -1069,6 +1147,9 @@ Scan filesystems, container images, and code repos for known vulnerabilities.
|
|
|
1069
1147
|
- CI gate (fail on findings): \`trivy fs --severity CRITICAL,HIGH --exit-code 1 --no-progress .\`
|
|
1070
1148
|
- Offline (skip DB update): \`trivy fs --skip-update --format json .\`
|
|
1071
1149
|
|
|
1150
|
+
## Output format
|
|
1151
|
+
Table to stdout by default (target, type, package, vulnerability ID, severity). \`--format json\` emits a structured CVE list with full details per vulnerability including fix version and CVSS score. \`--no-progress\` suppresses the spinner for clean CI output.
|
|
1152
|
+
|
|
1072
1153
|
## Why it matters for agents
|
|
1073
1154
|
Gives agents a security gate before deployments. \`--format json --exit-code 1\` creates a composable CI step \u2014 agents can parse findings and summarise critical vulnerabilities.
|
|
1074
1155
|
|
|
@@ -1124,6 +1205,9 @@ Send HTTP requests from the terminal. Cleaner syntax than curl, JSON-first, colo
|
|
|
1124
1205
|
- Headers only: \`xh -h get api.example.com\`
|
|
1125
1206
|
- Download file: \`xh --download get example.com/file.zip\`
|
|
1126
1207
|
|
|
1208
|
+
## Output format
|
|
1209
|
+
HTTP response body to stdout by default, pretty-printed and syntax-highlighted. Use \`-b\` for body only, \`-h\` for headers only. \`--print=hHbB\` controls what is shown (h=response headers, H=request headers, b=response body, B=request body). JSON bodies are pretty-printed automatically.
|
|
1210
|
+
|
|
1127
1211
|
## Why it matters for agents
|
|
1128
1212
|
Cleaner than curl for API testing \u2014 \`key=value\` JSON syntax removes quoting complexity. \`--check-status\` makes error handling trivial: non-zero exit on any 4xx/5xx.
|
|
1129
1213
|
|
|
@@ -1145,11 +1229,19 @@ Get practical, example-driven command summaries without reading full man pages.
|
|
|
1145
1229
|
- Update the local cache: \`tldr --update\`
|
|
1146
1230
|
- List all available pages: \`tldr --list\`
|
|
1147
1231
|
- Search for a topic: \`tldr --search "compress files"\`
|
|
1232
|
+
- Raw output (no colour): \`tldr --raw rg\`
|
|
1233
|
+
|
|
1234
|
+
## Output format
|
|
1235
|
+
Plain text formatted pages with ANSI colour codes. Use \`--raw\` or pipe through \`cat\` to strip colour. Each page is a short markdown document with a description and practical examples.
|
|
1236
|
+
|
|
1237
|
+
## Why it matters for agents
|
|
1238
|
+
Faster lookup than man pages \u2014 community-maintained examples cover 90% of common usages in a scannable format. Use as the first-pass reference before falling back to \`--help\` or full man pages. \`--raw\` output is safe to include verbatim in agent context.
|
|
1148
1239
|
|
|
1149
1240
|
## Gotchas
|
|
1150
1241
|
- First run requires internet to fetch the page cache. Run \`tldr --update\` after install.
|
|
1151
|
-
-
|
|
1152
|
-
-
|
|
1242
|
+
- Pages are community-written; they cover common usage, not edge cases \u2014 missing for obscure tools.
|
|
1243
|
+
- \`tldr --update\` refreshes the local cache; stale caches may show outdated examples.
|
|
1244
|
+
- Not every tool has a page \u2014 fall back to \`man\` or \`--help\` when missing.
|
|
1153
1245
|
`.trim();
|
|
1154
1246
|
|
|
1155
1247
|
// src/skills/biome.ts
|
|
@@ -1167,6 +1259,9 @@ Fast, zero-config linter and formatter for JavaScript/TypeScript projects. Repla
|
|
|
1167
1259
|
- Init config: \`biome init\`
|
|
1168
1260
|
- Check single file: \`biome check src/index.ts\`
|
|
1169
1261
|
|
|
1262
|
+
## Output format
|
|
1263
|
+
Text diagnostics to stderr with file, line, rule name, and description. \`--reporter=json\` emits structured linting output with arrays of diagnostics per file \u2014 parse with \`jq\` to filter by severity or rule.
|
|
1264
|
+
|
|
1170
1265
|
## Gotchas
|
|
1171
1266
|
- Requires a \`biome.json\` config or \`--config-path\` flag; \`biome init\` generates a sensible default.
|
|
1172
1267
|
- Not 100% compatible with all ESLint rules \u2014 check the migration guide when switching existing projects.
|
|
@@ -1190,10 +1285,14 @@ Compare files by syntax tree, not line-by-line. Understands code structure so re
|
|
|
1190
1285
|
- Diff staged changes: \`GIT_EXTERNAL_DIFF=difft git diff --cached\`
|
|
1191
1286
|
- Plain text mode (no syntax): \`difft --display side-by-side-show-both old.txt new.txt\`
|
|
1192
1287
|
|
|
1288
|
+
## Output format
|
|
1289
|
+
Side-by-side ANSI diff to stdout. Not machine-parseable \u2014 designed for human review only. Falls back to line-by-line diff for unsupported file types. Terminal width determines column widths.
|
|
1290
|
+
|
|
1193
1291
|
## Gotchas
|
|
1194
1292
|
- Supports most languages automatically via file extension detection.
|
|
1195
1293
|
- Output is always side-by-side; pipe width matters \u2014 use a wide terminal.
|
|
1196
1294
|
- Falls back to line-diff for unsupported file types.
|
|
1295
|
+
- Not suitable for programmatic diffing \u2014 use \`git diff --unified\` for machine-parseable output.
|
|
1197
1296
|
|
|
1198
1297
|
## Why it matters for agents
|
|
1199
1298
|
Understands code structure \u2014 avoids false-positive diffs from formatting changes. Agents using \`GIT_EXTERNAL_DIFF=difft git diff\` get semantic change summaries, not noise.
|
|
@@ -1303,6 +1402,9 @@ gitleaks protect --staged # pre-commit hook
|
|
|
1303
1402
|
gitleaks detect # CI full scan
|
|
1304
1403
|
\`\`\`
|
|
1305
1404
|
|
|
1405
|
+
## Output format
|
|
1406
|
+
Text summary to stdout listing finding count and rule matches. \`--report-format json --report-path out.json\` writes structured findings with file, line, rule, commit, and matched secret fragment. Terminal output is human-readable only.
|
|
1407
|
+
|
|
1306
1408
|
## Why it matters for agents
|
|
1307
1409
|
Agents editing configuration files or adding credentials must scan before committing. Exit code 1 on findings makes it trivially composable as a pre-commit gate.
|
|
1308
1410
|
|
|
@@ -1403,6 +1505,9 @@ Find and fix typos in source code, comments, docs, filenames, and variable names
|
|
|
1403
1505
|
- Check specific file types: \`typos --type rust src/\`
|
|
1404
1506
|
- Ignore a word: add to \`_typos.toml\`: \`[default.extend-words]\` \u2192 \`teh = "teh"\`
|
|
1405
1507
|
|
|
1508
|
+
## Output format
|
|
1509
|
+
\`file:line:col: "typo" -> "correction"\` per finding to stdout. \`--format json\` emits structured output with file, line, column, typo, and correction fields \u2014 parse with \`jq\` for batch processing. Exits 1 if typos found.
|
|
1510
|
+
|
|
1406
1511
|
## Why it matters for agents
|
|
1407
1512
|
Agents generate a lot of code. Running typos as a final pass catches misspellings in variable names, comments, and docs that slip past linters.
|
|
1408
1513
|
|
|
@@ -1576,6 +1681,9 @@ Scan code for security vulnerabilities, bugs, and anti-patterns across 30+ langu
|
|
|
1576
1681
|
- Scan single file: \`semgrep scan --config auto path/to/file.ts\`
|
|
1577
1682
|
- JSON output: \`semgrep scan --config auto --json\`
|
|
1578
1683
|
|
|
1684
|
+
## Output format
|
|
1685
|
+
Text findings to stdout with file, line, rule ID, and matched code snippet. \`--json\` emits structured match objects with file, line range, severity, rule metadata, and matched text \u2014 pipe to \`jq\` for filtering.
|
|
1686
|
+
|
|
1579
1687
|
## Why it matters for agents
|
|
1580
1688
|
Agents can run security and quality scans before committing code. Much broader language coverage than shellcheck or biome alone.
|
|
1581
1689
|
|
|
@@ -1729,8 +1837,13 @@ function buildTOC(tools) {
|
|
|
1729
1837
|
group.push(tool);
|
|
1730
1838
|
byPreset.set(tool.preset, group);
|
|
1731
1839
|
}
|
|
1732
|
-
const
|
|
1733
|
-
|
|
1840
|
+
const compactDescription = PRESETS.filter((p) => byPreset.has(p.id)).map((preset) => {
|
|
1841
|
+
const entries = (byPreset.get(preset.id) ?? []).map((t) => {
|
|
1842
|
+
const use = (t.tags?.[0] ?? t.description).replace(/ /g, "-");
|
|
1843
|
+
return `${t.id}(${use})`;
|
|
1844
|
+
}).join(" ");
|
|
1845
|
+
return `${preset.name}: ${entries}`;
|
|
1846
|
+
}).join(" | ");
|
|
1734
1847
|
const sections = PRESETS.filter((p) => byPreset.has(p.id)).map((preset) => {
|
|
1735
1848
|
const entries = (byPreset.get(preset.id) ?? []).map((t) => {
|
|
1736
1849
|
const uses = (t.tags ?? []).slice(0, 4).join(" \xB7 ");
|
|
@@ -1741,12 +1854,14 @@ ${entries}`;
|
|
|
1741
1854
|
}).join("\n\n");
|
|
1742
1855
|
return [
|
|
1743
1856
|
"---",
|
|
1744
|
-
`description: "
|
|
1857
|
+
`description: "${compactDescription}"`,
|
|
1745
1858
|
"source: agent-loadout",
|
|
1746
1859
|
"---",
|
|
1747
1860
|
"",
|
|
1748
1861
|
"# Agent Loadout",
|
|
1749
1862
|
"",
|
|
1863
|
+
"Each file has trusted commands, output formats, and agent-specific tips.",
|
|
1864
|
+
"",
|
|
1750
1865
|
sections,
|
|
1751
1866
|
""
|
|
1752
1867
|
].join("\n");
|
|
@@ -1774,7 +1889,7 @@ async function writeSkills(tools) {
|
|
|
1774
1889
|
|
|
1775
1890
|
// src/index.ts
|
|
1776
1891
|
var program = new Command();
|
|
1777
|
-
program.name("agent-loadout").description("One command to load out your terminal for agentic coding").version("1.0.
|
|
1892
|
+
program.name("agent-loadout").description("One command to load out your terminal for agentic coding").version("1.0.2");
|
|
1778
1893
|
process.on("SIGINT", () => {
|
|
1779
1894
|
console.log(chalk10.dim("\n Cancelled."));
|
|
1780
1895
|
process.exit(0);
|