Skip to content

CLAUDE.md

Latest commit

 

History

History
104 lines (77 loc) · 3.51 KB

CLAUDE.md

File metadata and controls

104 lines (77 loc) · 3.51 KB

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Overview

Personal dotfiles for macOS (Apple Silicon), focused on DevOps/cloud engineering workflows. Contains shell, terminal multiplexer, and terminal emulator configurations.

File Structure

  • .zshrc - Zsh configuration with Oh My Zsh framework
  • .tmux.conf - Tmux configuration (prefix: Ctrl-T)
  • ghostty/config - Ghostty terminal emulator (tmux alternative with native splits)
  • .env.tpl - 1Password secret references (safe to commit, no actual secrets)
  • .gitignore - Git ignore rules

Installation

Configs are symlinked to home directory:

ln -s ~/dotfiles/.zshrc ~/.zshrc
ln -s ~/dotfiles/.tmux.conf ~/.tmux.conf
ln -sf ~/dotfiles/ghostty/config ~/.config/ghostty/config

After changes, reload with:

  • Zsh: source ~/.zshrc
  • Tmux: prefix + r or tmux source-file ~/.tmux.conf
  • Ghostty: Ctrl+T > r or restart

Key Configuration Patterns

Zsh (.zshrc)

  • Oh My Zsh plugins: git, brew, gem, aws, docker, golang, tmux, kubectl, kubetail, kube-ps1, terraform
  • Version managers: rbenv, pyenv, nodenv (via eval init commands)
  • Interactive tools: peco + ghq for project navigation
  • GOPATH set to $HOME, GOROOT at /opt/homebrew/opt/go/libexec
  • Kubernetes context shown in prompt via kube-ps1

Tmux (.tmux.conf)

  • Prefix: Ctrl-T (not default Ctrl-B)
  • Uses reattach-to-user-namespace for macOS clipboard
  • Plugins via TPM: tmux-resurrect, tmux-continuum (auto-save every 15 min)

Ghostty (ghostty/config)

  • Prefix: Ctrl+T (matching tmux)
  • Chord-based keybindings: ctrl+t>h/j/k/l for splits (vim-style)
  • Native clipboard integration (no reattach-to-user-namespace needed)
  • Monaco font, 12pt

Custom Aliases

Alias Purpose
p cd to project via ghq + peco
v Open project in VS Code
c Open project in Cursor
ge Open Emacs in Ghostty
b Browse GitHub repo in browser
C Pipe output to clipboard (| C)

Keybinding Reference

  • Ctrl-G Ctrl-P - Interactive GitHub PR checkout (peco)
  • Ctrl-R - History search with pattern matching

Secret Management

Secrets are managed via 1Password CLI (op) using a template-based approach with caching:

  • .env.tpl contains op:// references (no actual secrets) — safe to commit
  • At shell startup, op inject resolves references and caches to ~/.cache/op_env_cache
  • Cache auto-refreshes every 24 hours — Touch ID prompted once per day
  • Cache created with umask 077 and cleaned up on shell exit via EXIT trap
  • Run op-reload to manually refresh secrets

Adding a new secret

  1. Store the secret in 1Password (vault: Private, account: my.1password.com)
  2. Add a line to .env.tpl: 
    export MY_SECRET={{ op://Private/item-name/password }}
  3. Refresh secrets: op-reload

Finding 1Password item paths

op item list --account=my.1password.com | grep -i <keyword>
op item get "<item-name>" --account=my.1password.com

Pre-commit Hooks

  • gitleaks scans staged changes for accidental secret commits
  • entire tracks development sessions and checkpoints
  • Both run as local .git/hooks/pre-commit (not committed to repo)
  • Install: brew install gitleaks

Session Tracking (Entire)

  • Strategy: auto-commit — automatically creates checkpoints
  • Config: .entire/settings.json (committed), .entire/settings.local.json (gitignored)
  • Re-enable: entire enable --strategy auto-commit --force