dotfiles

My personal dotfiles for zsh.

• 🧙‍ Leverages antidote for Zsh plugin management:
  • zsh-completions: Additional completion definitions.
  • powerlevel10k: Fast and flexible theme.
  • zsh-autosuggestions: As-you-type command suggestions.
  • zsh-syntax-highlighting: Command syntax highlighting.
• 👻 Optimized for the ghostty terminal emulator.
• 🐍 Uses uv for lightning-fast Python management.
• 💎 Manages environments for nodenv and rbenv.
• 🤵 Tailored for macOS with surgical defaults write configuration in script/macos.
• ✅ Validated with shellcheck.

Installation

Run the bootstrap script:

./script/bootstrap

This will:

1. Install Homebrew (if missing).
2. Install dependencies via brew_bundle (using local Brewfile).
3. Set your shell to zsh.
4. Symlink configuration files.
5. Apply macOS system preferences surgically.
6. Initialize the local LLM environment.
7. Restore Cline settings from dotfiles.

Local LLM Workflow

This project is optimized for local agentic coding on Apple Silicon (M5 Max recommended) using mlx-lm and cline.

🚀 Getting Started

1. Initialize: The LLM environment is set up during ./script/bootstrap. You can manually trigger it with:

   ./script/llm setup

2. Download Model: Retrieve the optimized mlx-community/Qwen3-Coder-Next-8bit model (~4.8GB) from Hugging Face:

   ./script/llm download

3. Start Server: Launch the mlx_lm server with full GPU acceleration:

   llm-start

4. Launch Agent: Start a coding session in any repository:

   cline

🛠️ Tools

• mlx-lm: Efficient inference engine for Apple Silicon.
• cline: CLI coding agent that works with your local model.
• mlx-community/Qwen3-Coder-Next-8bit: Apple Silicon–optimized 8-bit model for efficient local inference.
• script/llm: Management utility for your local LLM environment.