Personal Dotfiles
Domain-driven Neovim and Windows Terminal configuration focused on reproducible workflows across macOS and Windows.
Features
- Modular Neovim Architecture:
lazy.nvim loads plugins by domain (AI, completion, LSP, UI, Git) for predictable startup and maintenance.
- Smart Editing Defaults: Custom keymaps, Treesitter, Conform formatting, and Blink completion tuned to coexist with GitHub Copilot.
- Custom Dark Theme: Hand-crafted colorscheme with Nerd Font icons, mini.statusline, Neo-tree, and Telescope integrations.
- Integrated Developer Tooling: Mason auto-installs Pyright and TypeScript LS, while Neogit, Gitsigns, and diagnostics bindings streamline Git and LSP tasks.
- PowerShell Session Intelligence: Oh My Posh prompt, PSReadLine tweaks, and tab-aware directory persistence designed for Windows Terminal.
Quick Start
Prerequisites
- Neovim 0.12+ with clipboard support and Git available in
PATH (required by the rewritten nvim-treesitter on the main branch)
tree-sitter CLI 0.26+ — required at runtime to compile parsers; nvim-treesitter no longer bundles it- C compiler on
PATH (Xcode Command Line Tools on macOS: xcode-select --install; build-essential on Linux; MSVC Build Tools on Windows) — used by tree-sitter to build parsers
- Node.js 18+ (required for GitHub Copilot and TypeScript tooling)
- PowerShell 7+ and Windows Terminal 1.18+ on Windows
- oh-my-posh, posh-git, DockerCompletion, Get-ChildItemColor, PSReadLine modules installed
- JetBrainsMono Nerd Font (or any Nerd Font 3.2+) selected in your terminal
Install the tree-sitter CLI
# macOS (Homebrew)
brew install tree-sitter-cli
# Linux / generic (requires npm)
npm install -g tree-sitter-cli
# Alternative: cargo
cargo install tree-sitter-cli
Verify with tree-sitter --version — nvim's :checkhealth nvim-treesitter must report it as ✅ before parsers will compile.
Installation
git clone [email protected]:rafaeelricco/dotfiles.git
cd dotfiles
Link Configuration
# macOS / Linux
ln -s "$(pwd)/nvim/init.lua" "$HOME/.config/nvim/init.lua"
ln -s "$(pwd)/nvim/lua" "$HOME/.config/nvim/lua"
# Optional: keep lazy.nvim lock file in sync if you generate one
# ln -s "$(pwd)/nvim/lazy-lock.json" "$HOME/.config/nvim/lazy-lock.json"
Claude Code Skills
Link the versioned skills directory so Claude Code resolves it via ~/.claude/skills:
# macOS / Linux
mkdir -p "$HOME/.claude"
ln -s "$(pwd)/.claude/skills" "$HOME/.claude/skills"
On Windows, double-click scripts/windows/setup-claude-skills.bat (or right-click → "Run as administrator"). It self-elevates via UAC and creates the symlink. If ~/.claude/skills already exists as a non-empty real directory, the script aborts so you can move its contents into ./.claude/skills/ first.
Claude Code Skill Marketplace
The repo also publishes each .claude/skills/<skill> as an individual Claude Code plugin. Add the marketplace once:
claude plugin marketplace add rafaeelricco/dotfiles
Then install only the skills you want:
claude plugin install create-pr@ricco-skills
claude plugin install code-pattern@ricco-skills
claude plugin install prompt-master@ricco-skills
claude plugin install gh-issue-drafter@ricco-skills
To install several skills, run one install command per skill. After pulling marketplace updates, refresh the catalog:
claude plugin marketplace update ricco-skills
Marketplace plugin files under plugins/ are generated from .claude/skills/. Regenerate them after editing skills:
python3 scripts/sync-claude-plugin-marketplace.py
After editing a skill:
- Edit
.claude/skills/<skill>/...
- Run
python3 scripts/sync-claude-plugin-marketplace.py
- Commit and push
.claude/skills/, plugins/, and .claude-plugin/
- Ask teammates to refresh and update:
claude plugin marketplace update ricco-skills
claude plugin update <skill>@ricco-skills
Claude Code plugins do not load CLAUDE.md as global context. To install the global Claude instructions by command, copy them to ~/.claude/CLAUDE.md with an automatic backup:
curl -fsSL https://raw.githubusercontent.com/rafaeelricco/dotfiles/main/scripts/install-claude-md.py | python3
From a local clone, run:
python3 scripts/install-claude-md.py
Codex Skills
Reuse the same .claude/skills/ directory in the Codex CLI. Codex stores user skills under ~/.codex/skills/, but its bundled skills live in ~/.codex/skills/.system/, so we link per skill instead of the whole directory:
# macOS / Linux
mkdir -p "$HOME/.codex/skills"
for dir in .claude/skills/*/; do
name=$(basename "$dir")
ln -sfn "$(pwd)/$dir" "$HOME/.codex/skills/$name"
done
