dotfiles

Personal setup for macOS (zsh + bash). Shell config, CLI scripts, and a bootstrap script. Everything in ~ is a symlink into this repo, so this repo is the single source of truth — edit here, commit, and the live files follow.

Layout

Path	Role
setup.sh	interactive, idempotent bootstrap
.zshenv	env for every zsh (sources config/zsh/env.zsh)
.zprofile	login shells: brew shellenv, then re-applies ~/.pybin
.env.sh	BASH_ENV for non-interactive bash
config/zsh/env.zsh	shared environment for zsh + bash: PATH (idempotent), tool flags, keys
.bash_aliases	aliases/functions shared by zsh and bash
bin/	CLI scripts (chat-*, helpers); ~/bin symlinks here
.secrets.example	template for ~/.secrets — copy, fill, chmod 600

The Python default is the system interpreter: ~/.pybin shims shadow Homebrew's python3/pip3. Keys live in ~/.secrets (600), sourced by env.zsh for zsh and for non-interactive Bash when BASH_ENV points to ~/.env.sh. Interactive Bash loads secrets directly from ~/.bashrc.

Bash secrets

setup.sh appends a readable-file, interactive-only secrets loader to ~/.bashrc without replacing existing configuration or duplicating the loader on reruns. Interactive Bash ignores BASH_ENV; loading secrets directly avoids importing the shared environment's macOS-specific settings.

Use explicit export assignments in ~/.secrets so child processes inherit the keys. A missing secrets file is harmless.

For an existing installation, rerun bash ~/dotfiles/setup.sh, then open a new Bash shell or run source ~/.bashrc in the current one. Check secrets loading and setup idempotence with bash tests/test_bash_secrets.sh.

First-time setup

Prerequisites: git, Homebrew (macOS). Keys are never in this repo.

cd ~
git clone https://github.com/deven367/dotfiles
chmod +x dotfiles/setup.sh
bash dotfiles/setup.sh

Then: vim ~/.secrets (fill in keys, chmod 600), open a new shell.

Focus sessions (macOS)

focus.sh on       # block distracting sites and start a session
focus.sh status   # show blocking status and elapsed seconds
focus.sh off      # unblock sites and save the completed session

Run without sudo; the script elevates only hosts-file and DNS operations. History stays in your account at ~/.local/state/focus/sessions.csv, or $XDG_STATE_HOME/focus/sessions.csv when XDG_STATE_HOME is set:

started_at,ended_at,duration_seconds
2024-01-01T23:50:00Z,2024-01-02T00:15:00Z,1500

Timestamps are UTC; durations are wall-clock seconds, including sleep or reboots while focus remains enabled. The active start persists on disk; repeated on calls fail without resetting it. Blocks enabled before tracking was installed can still be turned off, but have no session to save.

Sessions spanning midnight stay intact. Split intervals at local midnight when calculating daily totals. Check tracking with bash tests/test_focus.sh.

Quartz interactive jobs

Run on Quartz after sourcing ~/.bash_aliases:

intq general 3          # CPU session for 3 hours
intq h100-single 1 3    # 1 H100 GPU for 3 hours
intq h100-debug 2 1     # 2 H100 GPUs for 1 hour

intq <partition> <hours> requests no GPUs. For h100-single and h100-debug, use intq <partition> <gpus> <hours>. Hours and GPU counts must be positive integers. Every request uses account r00117, one node, 10 tasks per node, and 64 GB RAM. h100-debug has a one-hour time limit; Slurm enforces partition limits and resource availability.

This replaces intqd, intqd2, and intqd4; use intq h100-debug <gpus> 1. Check invalid-input handling with bash tests/test_intq.sh or zsh tests/test_intq.sh.

Secrets policy

• Real API keys go in ~/.secrets only — this repo is public.
• ~/.secrets is git-ignored and 600-perm; .secrets.example is the committed template.
• Rotate any key that ever lands in a commit, PR, or issue.