dotfiles

🥈Silver

Dotfiles for macOS with Neovim, Zsh, Fish, Ghostty, and Tmux. Automates terminal setup for developers. Connects to AI agents for code editing and shell management.

411510Updated 4d ago

Intermediate30min to implementautomation

Saves ~75 min per use

Quick InstallView Source

git clone https://github.com/joshukraine/dotfiles.git

Works with:

Claude

Overview

About This Skill

https://github.com/joshukraine/dotfiles

How to Use

[{"step":"Clone the dotfiles repository to your home directory.","action":"Run `git clone https://github.com/yourusername/dotfiles.git ~/.dotfiles` in your terminal.","tip":"Use a private repository if your dotfiles contain sensitive data like API keys or passwords."},{"step":"Run the bootstrap script to automate the setup.","action":"Execute `cd ~/.dotfiles && ./bootstrap.sh` and follow the prompts.","tip":"Review the bootstrap script first to understand what it’s doing. Some scripts may ask for sudo permissions for system-wide installations."},{"step":"Customize the configuration for your workflow.","action":"Edit files in `~/.dotfiles/config/` (e.g., `nvim ~/.dotfiles/config/nvim/init.lua` for Neovim settings).","tip":"Start with the `README.md` in the repo to understand the modular structure. Override defaults by creating a `~/.config/local/` directory for user-specific changes."},{"step":"Integrate AI agents for code editing and shell management.","action":"Install the required CLI tools (e.g., `brew install claude-code`) and configure aliases in your shell rc file (e.g., `~/.zshrc`).","tip":"Test AI integrations with small tasks first. For example, use `ai-edit` to refactor a single function before relying on it for larger changes."},{"step":"Commit and push changes to keep your setup version-controlled.","action":"Run `git add . && git commit -m \"Update Neovim plugins\" && git push` after making changes.","tip":"Use Git submodules for large dependencies (e.g., Neovim plugins) to keep the repo lightweight."}]

Use Cases

Quickly set up a new macOS environment with pre-configured development tools and settings.

Easily switch between Zsh and Fish shells while maintaining consistent configurations.

Automate the installation of essential software and dependencies using Homebrew and a custom Brewfile.

Utilize AI-assisted development features to enhance coding efficiency and streamline workflows.

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/joshukraine/dotfiles

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Generate a dotfiles configuration for [OPERATING_SYSTEM] that includes [TOOLS_LIST]. The setup should automate terminal customization, shell configuration, and editor settings. Include AI agent integration for [SPECIFIC_TASKS]. Ensure the configuration is modular, version-controlled, and idempotent. Provide installation instructions and a quick-start guide.

Example Output

Here’s a production-ready dotfiles configuration for macOS (Ventura 13.5) with Neovim 0.9.4, Zsh 5.9, Fish 3.6.1, Ghostty 1.0.0, and Tmux 3.3a. The setup includes:

**Shell & Terminal:**
- Zsh as the default shell with Oh-My-Zsh plugins (zsh-autosuggestions, zsh-syntax-highlighting)
- Fish shell with Fisher plugins (zsh-to-fish, tide)
- Ghostty terminal emulator with a custom Solarized Dark theme and ligatures enabled
- Tmux 3.3a with a preconfigured session manager (tmux-resurrect, tmux-continuum)

**Editor (Neovim):**
- Lazy.nvim plugin manager with 30+ plugins (LSP, treesitter, completion, debugging)
- Custom keybindings for AI agent integration (e.g., `,ai` for code generation, `,refactor` for AI-assisted refactoring)
- Preconfigured LSP servers for Python, JavaScript, Go, and Rust
- Telescope.nvim for fuzzy file finding and live grep

**AI Agent Integration:**
- Claude Code CLI for inline code editing (e.g., `claude edit --file src/utils.py --prompt "Optimize this function"`)
- Shell aliases for AI tasks:
  - `ai-edit`: Opens the current file in Claude Code for AI-assisted editing
  - `ai-chat`: Starts a chat session with an AI agent for shell-related questions
  - `ai-docs`: Generates documentation for a selected function or file

**Installation:**
1. Clone the repo: `git clone https://github.com/yourusername/dotfiles.git ~/.dotfiles`
2. Run the bootstrap script: `cd ~/.dotfiles && ./bootstrap.sh`
3. Restart your terminal or run `exec zsh` to reload the shell
4. For Neovim, run `:Lazy sync` to install plugins

**Quick Start:**
- Open Ghostty and press `Cmd+T` to create a new tmux session
- Run `ai-edit` to open the current file in Claude Code
- Use `,ai` in Neovim to trigger AI-assisted code generation

The configuration is idempotent—running the bootstrap script multiple times won’t break your setup. All changes are version-controlled in Git, and you can customize themes, plugins, and AI integrations by editing the respective config files.