🛠️ dotfiles

Personal configuration files used to quickly set up my development environment on new machines.

This repository uses the stow utility to apply the files via symlinks in the $HOME directory.

📦 Contents

This repository contains some of the following configuration files:

• .aliases – Custom aliases
• .functions – Helper functions for the shell
• .gitconfig, .gitignore, .gitattributes – Git configurations
• .git-completion.bash – Git command autocompletion in Bash
• .inputrc – Command line behavior settings
• .nanorc – Customizations for the Nano editor
• .wgetrc – wget configurations
• .zshrc, .zshenv – Zsh configurations

🚀 Quick Installation

1. Prerequisites

• git
• stow Install with:

# Fedora
sudo dnf install stow
# Debian/Ubuntu
sudo apt install stow
# macOS (via Homebrew)
brew install stow

2. Automatic Installation

Run the command below in the terminal:

curl -sL https://raw.githubusercontent.com/lucasbt/dotfiles/main/install.sh | sh

This command will:

• Clone this repository into the ~/.dotfiles directory
• Use stow to apply the files to your $HOME

⚙️ Makefile

This repository includes a Makefile with the following targets:

• make install — Applies the dotfiles to the home directory using stow
• make clean — Removes the symlinks applied by stow

🧼 Removal

To undo the symlinks:

make clean

🔐 Load SSH keys from Bitwarden

This repository provides a script that loads SSH private keys stored in Bitwarden directly into the ssh-agent, without persisting them to disk.

Script location:

~/.dotfiles/bin/.local/bin/bw-add-ssh-key

Requirements

• bw (Bitwarden CLI)
• jq
• ssh-agent / ssh-add

After installing the Bitwarden CLI, log in at least once:

bw login

Usage (IMPORTANT)

⚠️ This script must be executed using source (or .).

Running it in a subshell (sh script.sh or ./script.sh) will start a temporary ssh-agent that is destroyed when the script exits.

Run one of the following:

source ~/.dotfiles/bin/.local/bin/bw-add-ssh-key

Behavior

• Reuses an existing ssh-agent or starts one if needed
• Unlocks/logs into Bitwarden
• Loads SSH private keys directly into the agent (in-memory when possible)
• Securely removes any temporary files
• Logs out from Bitwarden on exit

Verification

ssh-add -l

Alias (included)

alias bw-ssh='source ~/.dotfiles/bin/.local/bin/bw-add-ssh-key'

Notes

• Keys remain available only while the ssh-agent is running
• Item names and fields can be adjusted directly in the script