Command Line Interface

Summary

Powerlevel 10k

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ~/powerlevel10k
echo 'source ~/powerlevel10k/powerlevel10k.zsh-theme' >>~/.zshrc

Manual font installation

1. Download these four ttf files:
   • MesloLGS NF Regular.ttf
   • MesloLGS NF Bold.ttf
   • MesloLGS NF Italic.ttf
   • MesloLGS NF Bold Italic.ttf
2. Double-click on each file and click "Install". This will make MesloLGS NF font available to all applications on your system.
3. Configure your terminal to use this font:
   • iTerm2: Type p10k configure and answer Yes when asked whether to install Meslo Nerd Font. Alternatively, open iTerm2 → Preferences → Profiles → Text and set Font to MesloLGS NF.
   • Apple Terminal: Open Terminal → Preferences → Profiles → Text, click Change under Font and select MesloLGS NF family.
   • Hyper: Open Hyper → Edit → Preferences and change the value of fontFamily under module.exports.config to MesloLGS NF.
   • Visual Studio Code: Open File → Preferences → Settings (PC) or Code → Preferences → Settings (Mac), enter terminal.integrated.fontFamily in the search box at the top of Settings tab and set the value below to MesloLGS NF. Consult this screenshot to see how it should look like or see this issue for extra information.
   • Ghostty: Open Menu → Open Configuration (Linux) or Ghostty → Settings... (Mac) and add the following line:

     font-family = "MesloLGS NF"
     

Node Version Manager: Node, NPM, and Bun

nvm on
nvm install stable
nvm use stable
node --version
npm --version
npm               # to see if there is a version to upgrade to
npm install -g bun
# npm install -g bun@1.2.4  # (to upgrade or use a specific version of `bun`)
npm install -g pnpm
# npm install -g pnpm@9.0.0  # (to upgrade or use a specific version of `npm`)
bun --version
pnpm --version

Rust

rustup default stable
rustup update

Rust Tools

cargo install just --locked
cargo install eza --locked
cargo install fd-find --locked
cargo install ripgrep --locked
cargo install ast-grep --locked
cargo install bat --locked
cargo install zoxide --locked
cargo install git-delta --locked
cargo install typst-cli --locked

Python

Python tools

uv tool install --python 3.14 pre-commit --with pre-commit-uv
uv tool install --python 3.14 httpie
uv tool install --python 3.14 "yt-dlp[default]"

/Users/iancleary/.local/share/uv/tools/httpie/lib/python3.9/site-packages/urllib3/__init__.py:35: NotOpenSSLWarning: urllib3 v2 only supports OpenSSL 1.1.1+, currently the 'ssl' module is compiled with 'LibreSSL 2.8.3'. See: https://github.com/urllib3/urllib3/issues/3020

Go tools

go install github.com/jesseduffield/lazygit@latest

MacPorts

sudo port install fzf
sudo port install jq

fzf

Basic Usage

# Find files interactively
fzf

# Preview files with bat
fzf --preview 'bat --color=always {}'

# Use fd as the default source (respects .gitignore)
export FZF_DEFAULT_COMMAND='fd --type f --hidden --follow --exclude .git'

Integration with Other Tools

# Search file contents with ripgrep, then open in editor
rg --line-number . | fzf --delimiter ':' --preview 'bat --color=always --highlight-line {2} {1}'

# Find directories with fd
fd --type d | fzf

Useful Shell Functions

Add these to your ~/.zshrc:

# Fuzzy cd into a directory
fcd() {
  local dir
  dir=$(fd --type d | fzf --preview 'eza --tree --level=1 {}') && cd "$dir"
}

# Fuzzy search command history
fhist() {
  local cmd
  cmd=$(history -1 0 | fzf --tac | sed 's/^ *[0-9]* *//')
  print -z "$cmd"
}

# Fuzzy checkout git branch
fbr() {
  local branch
  branch=$(git branch --all | grep -v HEAD | fzf --preview 'git log --oneline --graph -10 {}' | sed 's/.* //' | sed 's|remotes/origin/||')
  git checkout "$branch"
}

AI Tools

OpenAI Codex CLI

npm i -g @openai/codex

Claude Code CLI

curl -fsSL https://claude.ai/install.sh | bash

Claude Browser Dev

Claude Code can use a local browser for development preview, allowing it to visually verify changes and interact with your running application.

claude --browser

This launches Claude Code with browser capabilities, enabling it to open local dev servers, take screenshots, and verify UI changes as part of the development workflow.

Claude Skills

Claude Skills let you teach Claude Code reusable capabilities. Create a .claude/skills/ directory in your project with SKILL.md files that describe how to perform specific tasks.

mkdir -p .claude/skills
touch .claude/skills/SKILL.md

Each SKILL.md file teaches Claude Code a specific capability — like how to deploy your app, run tests, or follow your coding conventions. Claude Code automatically reads these when working in your project.

Dotfiles

I manage my shell configuration with a dotfiles repo that syncs across machines. On macOS, this covers zsh configs, Powerlevel10k, shared aliases, and AI agent configuration.

git clone git@github.com:iancleary/dotfiles.git ~/dotfiles
cd ~/dotfiles
./sync-dotfiles.sh push   # Install configs from repo
./sync-dotfiles.sh pull   # Backup current configs to repo
./sync-dotfiles.sh status # Check for differences

The sync utility detects the OS and installs the appropriate files — zsh configs on macOS/Linux, bash configs on Windows. Shared utilities are installed on all platforms.

What Gets Synced (macOS)

• .zshrc, .zshenv, .zprofile — Zsh configuration with Powerlevel10k
• .p10k.zsh — Powerlevel10k theme configuration
• .common/aliases.sh — Shell aliases (eza, git, docker, cargo, just)
• .common/agents-git-trees.sh — Git worktree helpers (ga/gd)
• .claude/ — Claude Code settings, skills, principles
• .codex/ — Codex CLI rules and MCP servers

Ghostty

Add window padding to your Ghostty config file (~/.config/ghostty/config):

window-padding-x = 8
window-padding-y = 0,4

The window-padding-y = 0,4 sets 0 padding on top and 4 on the bottom, giving a clean look with minimal wasted space.