CLI Tool Details

The fzf/ package provides fuzzy finder configuration with extensive shell integration.

Contents

File Purpose

.fzf

Complete fzf configuration (452 lines)

Key Features

  • Layout: Reverse list, rounded border, inline info

  • Colors: Tokyo Night theme (#1a1b26 bg)

  • Preview: Bat integration for file previews

  • Multi-select: Tab key for selecting multiple files

Shell Keybindings

Binding Action

Ctrl+T

Open files directly in editor

Ctrl+R

Search command history

Alt+C

cd into selected directory

Custom Functions

Function Purpose

fkill

Kill processes interactively

fgco

Checkout git branch

fga

Git add with preview

frg <term>

Interactive ripgrep search

fcd

cd to selected directory

fh

Search command history

fdocker

Select Docker container

fkube

Switch Kubernetes context

fkpod

Exec into Kubernetes pod

fglog

Interactive git log browser

fgdiff

Select file to diff

Installation

stow -t ~ fzf

The .fzf file is sourced by .bashrc or .zshrc.

The ripgrep/ package provides optimized ripgrep configuration with smart defaults and extensive type definitions.

Contents

File Purpose

.ripgreprc

Global ripgrep configuration (290 lines)

Search Behavior

  • --smart-case - Case-insensitive unless uppercase

  • --follow - Follow symbolic links

  • --hidden - Search hidden files (respects .gitignore)

  • --max-columns=150 - Prevents long line issues

Excluded Patterns

Comprehensive ignores for:

  • Build artifacts: node_modules/, vendor/, dist/, target/

  • Python: .venv/, pycache/, .pytest_cache/

  • Cloud/IaC: .terraform/, .terragrunt-cache/, cdk.out/

  • Archives: .tar.gz, .zip, *.7z

  • Media: .mp4, .pdf, *.jpg

Custom Types

Type Extensions

web

html, css, js, ts, tsx, vue, svelte

config

json, yaml, toml, ini, conf

docs

md, adoc, rst, txt

shell

sh, bash, zsh, fish

terraform

tf, tfvars, hcl

docker

Dockerfile*, *.dockerfile

iac

Combined Terraform + K8s

pyproj

Python files

rustproj

Rust files

goproj

Go files

Usage Examples

# Basic search
rg pattern

# Search specific type
rg -t py pattern
rg -t config pattern

# Exclude type
rg -T js pattern

# Show context
rg -C 3 pattern

# List files only
rg -l pattern

# Show all types
rg --type-list

Installation

stow -t ~ ripgrep

Set RIPGREP_CONFIG_PATH="$HOME/.ripgreprc" in shell config (handled by bash/zsh package).

The lazygit/ package provides terminal UI for git with Catppuccin Mocha theming.

Contents

File Purpose

.config/lazygit/config.yml

Catppuccin Mocha theme

Installation

stow -t ~ lazygit

Usage

lazygit          # Start lazygit
lazygit --help  # Show help

Keybindings

Key Action

h/j/k/l

Navigate (vim-style)

Space

Toggle selection

Enter

Open/expand

q

Quit

s

Stage file

u

Unstage file

c

Commit

P

Push

p

Pull

d

Delete branch

R

Refresh

/

Search

t

Toggle staged view

Status Display

Shows:

  • File tree with staged/unstaged sections

  • Commit history with graph

  • Branch list

  • Stash entries

  • Rebase/merge status

The fastfetch/ package provides system info display with 12 preset configurations.

Contents

File Purpose

.config/fastfetch/*.jsonc

Preset configurations

Presets

Preset Description

all.jsonc

Full system info

ascii-mascot.jsonc

With ASCII art

ascii.txt

Simple ASCII

benchmark.jsonc

Performance test

blobs.jsonc

Blob decorations

bottom.jsonc

htop-style layout

card-mono.jsonc

Monochrome cards

cite.jsonc

Citation style

doctor.jsonc

Health check

hex.jsonc

Hex colors

hyde.jsonc

Hyde style

neofetch.jsonc

Neofetch-style

structure.txt

Structure layout

Usage

fastfetch                      # Run default preset
fastfetch --load-config all   # Load specific preset
fastfetch --config ~/.config/fastfetch/all.jsonc

Installation

stow -t ~ fastfetch

The btop/ package provides GPU-accelerated resource monitor with Catppuccin Mocha theme.

Contents

File Purpose

.config/btop/themes/catppuccin_mocha.theme

Catppuccin Mocha colors

btop.conf

Main configuration

Installation

stow -t ~ btop

Usage

btop           # Start btop
btop --help   # Show help

Views

View Key

Description

System

1 or Tab

CPU, RAM, Processes

CPU

2

Detailed CPU usage

Mem

3

Memory details

Proc

4

Process list

Disk

d

Disk I/O

Net

n

Network usage

GPU

g

NVIDIA GPU (if available)

Keybindings

Key Action

q/Esc

Quit

m

Menu

f

Filter processes

/

Search

s

Sort menu

c

Process count

t

Theme toggle

r

Reverse sort

o

CPU graph style

i

I_graph style

Theme

Uses Catppuccin Mocha palette:

  • Rosewater #f5e0dc

  • Mauve #cba6f7

  • Blue #89b4fa

  • Green #a6e3a1

The w3m/ package provides a vim-modal terminal web browser with custom keymap, config, and bookmarks.

Contents

File Purpose

.w3m/keymap

Vim motions — hjkl, g/G, C-d/C-u, /?, {/} tabs, M-a/M-b bookmarks

.w3m/config

UTF-8, mouse disabled, nvim as editor, meta-refresh, SSL

.w3m/bookmark.html

Domus infra, Architectus, vendor docs, reference sites

Installation

stow -t ~ w3m

Keymap Syntax

w3m only supports single keys, C-x (ctrl), and M-x / ESC-x (meta/alt). Multi-character sequences like gg, gt, ZZ are not valid and silently break the entire keymap file — no partial loading. Reference: /usr/share/doc/w3m/keymap.default

Vim Motions

Key Action

j / k

Move down / up

h / l

Move left / right

g / G

Top / bottom of page

0 / $

Line begin / end

w / W

Next word / previous word

C-d / C-u

Page down / up (prev link)

C-f / C-b

Page down / up (alternate)

/ / ?

Search forward / backward

n / N

Next / previous match

Link Navigation

Key Action

TAB / M-TAB

Next / previous link

ENTER

Follow link

f

Link list menu (select by number)

F

Render frames

[ / ]

Link begin / link end

H

Back (history)

C-o

Back (alternate)

C-h

View history

Tab Management

Key Action

T

New tab

C-q

Close tab

{ / }

Previous / next tab

t

Open URL (GOTO)

M-t

Tab menu

C-t

Open link in new tab

Page Actions

Key Action

o

Open URL (GOTO)

O

Open relative URL

r / R

Reload

v

View source (toggle)

E

Edit source in nvim

s

Select buffer menu

S

Save rendered screen

a

Save link target

p

Peek link URL

c

Peek current URL

y

Open in external browser

M-M

Open link in external browser

=

Page info

C-g

Line info

Bookmarks

Key Action

M-a

Add bookmark

M-b

View bookmarks

Marks

Key Action

C-@

Set mark at cursor

M-n

Jump to next mark

M-p

Jump to previous mark

Display

Key Action

i

Peek image URL

I

View image

C-l

Redraw screen

L

Link list

Quit

Key Action

q

Quit (confirm disabled)

Q

Exit immediately

Text Selection (w3m Limitations)

w3m has no vim visual mode or yank registers. Alternatives:

Method How

tmux copy mode

prefix + [ then vim motions, v select, y yank

Edit in nvim

E in w3m — full source with real visual mode

Save to file

S saves rendered screen

Pipe buffer

| pipes current buffer to a command (e.g., wl-copy)

Mark + pipe

C-@ sets mark, navigate, then | pipes the region

Design Decisions

  • Mouse disabled — vim motions are the only input method

  • nvim as editor — E opens page source in Neovim with syntax highlighting

  • display_link enabled — always shows URL of current link in status bar

  • vi_prec_num enabled — numeric prefixes work like vim (5j = 5 lines down)

  • confirm_qq disabled — q quits immediately (no "are you sure" prompt)

  • meta_refresh enabled — auto-follows Antora component redirects

  • All functions validated — every keymap entry cross-checked against /usr/share/doc/w3m/keymap.default