dotfiles — macOS

Personal macOS dotfiles: Zsh environment (oh-my-zsh, custom functions, aliases), Claude Code configuration, and Codex CLI configuration. See CLAUDE.md for the full structure and command reference.

Setup

Clone and symlink files into ~:

git clone -b macos git@github.com:akshatbaranwal/dotfiles.git ~/dotfiles/macos
cd ~/dotfiles/macos
# symlink whatever you want to use, e.g.:
ln -s "$PWD/.zshrc"          ~/.zshrc
ln -s "$PWD/.zsh_functions"  ~/.zsh_functions
ln -s "$PWD/.zsh_aliases"    ~/.zsh_aliases
ln -s "$PWD/.claude"         ~/.claude   # or symlink individual files inside
ln -s "$PWD/.codex/AGENTS.md" ~/.codex/AGENTS.md
ln -s "$PWD/.codex/config.toml" ~/.codex/config.toml
ln -s "$PWD/.codex/scripts" ~/.codex/scripts
ln -s "$PWD/.codex/skills/promote-workflow" ~/.codex/skills/promote-workflow
ln -s "$PWD/.codex/skills/plan-review" ~/.codex/skills/plan-review

Claude Code auto-memory

.claude/memory/ is the tracked home of Claude Code's auto-memory for the /Users/akshat default project. After checkout, link Claude's expected path to it:

ln -s "$PWD/.claude/memory" ~/.claude/projects/-Users-akshat/memory

Every memory entry Claude writes will then ride with this repo.

Codex CLI migration

.codex/ is the tracked Codex layer that mirrors the useful parts of the Claude setup:

• .codex/AGENTS.md is the global operator/personality file.
• .codex/config.toml keeps model, reasoning, personality, MCP, memories, and CLAUDE.md fallback discovery settings.
• .codex/scripts/ contains Codex-native versions of the deterministic helpers.
• .codex/skills/promote-workflow/ is the Codex version of the workflow promotion skill.
• .codex/skills/plan-review/ is the Codex-native form of the old /codex-plan-review workflow.

Generated Codex state stays in ~/.codex and is not tracked: sessions, auth, logs, generated memories, and rules written by the TUI.