🛠️ dotbins Tool Collection

This directory contains command-line tools automatically managed by dotbins.

📋 Table of Contents

• What is dotbins?
• Installed Tools
• Tool Statistics
• Shell Integration
• Installing and Updating Tools
• Quick Commands
• Configuration File
• Additional Information

📦 What is dotbins?

dotbins is a utility for managing CLI tool binaries in your dotfiles repository. It downloads and organizes binaries for popular command-line tools across multiple platforms (macOS, Linux) and architectures (amd64, arm64).

Key features:

• ✅ Cross-platform support - Manages tools for different OSes and CPU architectures
• ✅ No admin privileges - Perfect for systems where you lack sudo access
• ✅ Version tracking - Keeps track of installed tools with update timestamps
• ✅ GitHub integration - Automatically downloads from GitHub releases
• ✅ Simple configuration - YAML-based config with auto-detection capabilities

Learn more: github.com/basnijholt/dotbins

🔍 Installed Tools

📊 Tool Statistics

💻 Shell Integration

Add one of the following snippets to your shell configuration file to use the platform-specific binaries:

For Bash:

source $HOME/.dotbins/shell/bash.sh

For Zsh:

source $HOME/.dotbins/shell/zsh.sh

For Fish:

source $HOME/.dotbins/shell/fish.fish

For Nushell:

source $HOME/.dotbins/shell/nushell.nu

🔄 Installing and Updating Tools

Install or update all tools

dotbins sync

Install or update specific tools only

dotbins sync tool1 tool2

Install or update for current platform only

dotbins sync --current

Force reinstall of all tools

dotbins sync --force

🚀 Quick Commands

dotbins list           # List all available tools
dotbins init           # Initialize directory structure
dotbins sync           # Install and update tools to their latest versions
dotbins readme         # Regenerate this README
dotbins status         # Show installed tool versions
dotbins get REPO       # Install tool directly to ~/.local/bin

📁 Configuration File

dotbins is configured using a YAML file (dotbins.yaml). This configuration defines which tools to manage, their sources, and platform compatibility.

Current Configuration:

tools_dir: ~/.dotbins

platforms:
  linux:
    - amd64
    - arm64
  macos:
    - arm64

tools:
  delta: dandavison/delta
  duf: muesli/duf
  dust: bootandy/dust
  fd: sharkdp/fd
  hyperfine: sharkdp/hyperfine
  rg: BurntSushi/ripgrep
  yazi: sxyazi/yazi

  bat:
    repo: sharkdp/bat
    shell_code:
      bash,zsh: |
        alias bat="bat --paging=never"
        alias cat="bat --plain --paging=never"
  bun:
    repo: oven-sh/bun
    arch_map:
      amd64: x64
      arm64: aarch64
    asset_patterns:
      linux: bun-linux-{arch}.zip
      macos: bun-darwin-{arch}.zip
    shell_code:
      bash,zsh: |
        alias bunx="bun x"
  direnv:
    repo: direnv/direnv
    shell_code:
      bash,zsh: |
        eval "$(direnv hook __DOTBINS_SHELL__)"
  eza:
    repo: eza-community/eza
    shell_code:
      bash,zsh: |
        alias l="eza --long --all --git --icons=auto"
  fzf:
    repo: junegunn/fzf
    shell_code:
      zsh: |
        source <(fzf --zsh)
      bash: |
        eval "$(fzf --bash)"
  lazygit:
    repo: jesseduffield/lazygit
    shell_code:
      bash,zsh: |
        alias lg="lazygit"
  micromamba:
    repo: mamba-org/micromamba-releases
    shell_code:
      bash,zsh: |
        alias mm="micromamba"
  starship:
    repo: starship/starship
    shell_code:
      bash,zsh: |
        [ "$TERM" != "dumb" ] && eval "$(starship init __DOTBINS_SHELL__)"
  zoxide:
    repo: ajeetdsouza/zoxide
    shell_code:
      bash,zsh: |
        eval "$(zoxide init __DOTBINS_SHELL__)"
  atuin:
    repo: atuinsh/atuin
    shell_code:
      bash,zsh: |
        eval "$(atuin init __DOTBINS_SHELL__ --disable-up-arrow)"

  keychain:
    repo: danielrobbins/keychain
    asset_patterns: keychain

  uv:
    repo: astral-sh/uv
    binary_name: [uv, uvx]
    path_in_archive: [uv-*/uv, uv-*/uvx]

ℹ️ Additional Information

• This README was automatically generated on Jul 30, 2026
• Current platform: linux/amd64
• For more information on dotbins, visit https://github.com/basnijholt/dotbins