Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/erickm13/Salchipapa.Dots/llms.txt

Use this file to discover all available pages before exploring further.

Salchipapa.Dots is a fully automated dotfiles repository for Linux developers who want a fast, minimal, and powerful terminal environment without spending hours on manual configuration. It ships an interactive installer that handles everything — from Homebrew and package management to shell setup, terminal multiplexer, symlinks, and Neovim plugin sync — so you can go from a fresh Linux system to a complete development environment in minutes. Whether you’re spinning up a new machine or standardizing your setup across systems, Salchipapa.Dots gives you one command to rule them all.

Neovim

LazyVim-powered Neovim with LSP, Treesitter, AI plugins (Gemini, Avante, Claude Code), fzf-lua, Oil, Obsidian, and more.

Shell

Fish and Zsh configurations with Starship prompt, zoxide, atuin, fzf, carapace completions, and Oh My Zsh support.

Terminal

Alacritty and WezTerm configs pre-themed with Solarized Osaka, ready to symlink in one step.

Git & SSH

SSH multi-account management scripts for setting up, adding, and switching between multiple GitHub identities.

What’s Included

Salchipapa.Dots bundles a curated set of tools that all work together under a single unified theme. Every component is pre-configured and symlinked by the installer — no post-install tweaking required. Shells
  • Fish — with Fisher plugin manager, jorgebucaran/nvm.fish, patrickf1/fzf.fish, auto-start Zellij on launch, and an obs alias for syncing your Obsidian vault
  • Zsh — with Oh My Zsh, zsh-syntax-highlighting, zsh-autosuggestions, and zsh-autocomplete
Terminal Multiplexers
  • Zellij — with predefined layouts, config symlinked to ~/.config/zellij
  • Tmux — with TPM (Tmux Plugin Manager) auto-install, config symlinked to ~/.config/tmux
Terminal Emulators
  • Alacritty — config symlinked to ~/.config/alacritty
  • WezTerm — config symlinked via ~/.wezterm.lua
Editor
  • Neovim with LazyVim, LSP, Treesitter, and a rich plugin suite including AI tools, DAP, blink completion, Oil file manager, and Obsidian integration
AI Integrations
  • Gemini CLI (@google/gemini-cli) — Google’s official AI command-line interface
  • Angular CLI (@angular/cli) — for Angular project scaffolding
  • Claude Code (@anthropic-ai/claude-code) — Anthropic’s CLI coding assistant, also integrated as a Neovim plugin
CLI Utilities
  • Starship — cross-shell prompt
  • Fastfetch — system information display
  • fzf, zoxide, atuin — fuzzy finder, smart cd, shell history
  • eza, bat, fd — modern replacements for ls, cat, find
  • lazygit — terminal UI for Git
  • yazi — terminal file manager
  • btop — resource monitor
  • carapace — multi-shell completion
Git & SSH
  • SalchipapaGit/ scripts for SSH multi-account setup, adding accounts, cloning with identity selection, and removing accounts

Solarized Osaka Theme

Every tool in Salchipapa.Dots is styled with the Solarized Osaka color palette. The installer scripts themselves use the same ANSI color block, so the aesthetic is consistent from the moment you run the installer through every terminal session afterward. Alacritty, WezTerm, Neovim, Zellij, Tmux, and Starship all share the same palette.

WSL2 Support

Salchipapa.Dots runs on WSL2. The installer detects a WSL2 environment automatically and prints a post-install reminder.
Neovim clipboard integration in WSL2 requires win32yank installed on the Windows side and available in your Windows PATH. Install it with scoop install win32yank or choco install win32yank.

Homebrew Tap

If you prefer not to clone the repository manually, Salchipapa.Dots is available as a Homebrew formula:
brew install erickm13/tap/salchipapa-dots
sudo salchipapa-dots
This installs the salchipapa-dots binary and places all dotfiles in a shared directory. The installer will clone the full repository into ~/Salchipapa.Dots automatically on first run.

Build docs developers (and LLMs) love