// System setup, tool information, and AI configuration management for development environments. Use when setting up new machines, explaining available tools (shell-config, ai-rules, wt), managing AI assistant configurations (Claude/Codex/Gemini/OpenCode), checking system configuration, or troubleshooting environment issues. Also triggers when working with configuration files (.json, .toml, .fish, .zsh, .bash), Brewfiles, or installation scripts. Example triggers: "Set up my development environment", "Install tools on new machine", "Configure AI assistant", "What tools do I have?", "Update my shell config", "Add MCP server to Claude", "Check system configuration"
| name | rr-system |
| description | System setup, tool information, and AI configuration management for development environments. Use when setting up new machines, explaining available tools (shell-config, ai-rules, wt), managing AI assistant configurations (Claude/Codex/Gemini/OpenCode), checking system configuration, or troubleshooting environment issues. Also triggers when working with configuration files (.json, .toml, .fish, .zsh, .bash), Brewfiles, or installation scripts. Example triggers: "Set up my development environment", "Install tools on new machine", "Configure AI assistant", "What tools do I have?", "Update my shell config", "Add MCP server to Claude", "Check system configuration" |
Comprehensive system setup automation and tool reference for the rr- development environment. Provides automated installation scripts, AI configuration management, and modern CLI tools for macOS and Linux.
โ ๏ธ IMPORTANT: ALWAYS CHECK OFFICIAL DOCUMENTATION ONLINE
Tools evolve rapidly. Before providing commands or configuration changes:
references/tools-reference.md for official documentation URLsCRITICAL: Provide continuous progress updates for all installation tasks.
Before ANY task:
During execution:
After each step:
Never run commands silently - always inform user what and why.
Complete 4-step setup on macOS or Linux:
cd .claude/skills/rr-system
# 1. Install tools (includes Homebrew)
bash scripts/install-tools.sh
# 2. Upgrade all packages (MANDATORY)
brew upgrade
# 3. Install shell configs
bash scripts/install-shell-config.sh
# 4. Install AI configs
bash scripts/install-ai-configs.sh
# 5. Restart terminal
For detailed instructions, see references/installation-guide.md
4 automated scripts for zero-interaction setup:
install-tools.sh - Development tools via Homebrew
Brewfile (cross-platform)Brewfile.macos (auto-skipped on Linux)brew upgrade - MANDATORY after installing Homebrew
install-shell-config.sh - Shell configurations
install-ai-configs.sh - AI assistant configurations
All scripts are idempotent (safe to run multiple times) with automatic verification.
Two Brewfiles for organized package management:
Brewfile - Shared CLI tools (macOS & Linux):
Brewfile.macos - macOS-only applications:
Adding tools:
Brewfile for CLI: brew "tool-name"Brewfile.macos for macOS apps: cask "app-name"bash scripts/install-tools.shManage AI assistant configs with automated installation or manual editing.
Supported platforms:
~/.claude/settings.json)~/.codex/config.toml)~/.gemini/settings.json)~/.config/opencode/opencode.json)~/.cursor/mcp.json)Quick install (recommended):
bash scripts/install-ai-configs.sh
Manual editing workflow:
assets/ai-configs/<platform>-* templatesjq empty <file>python3 -c "import tomllib; tomllib.load(open('<file>', 'rb'))"Common tasks:
Feature Parity Principle:
Maintain near-identical configs across all platforms:
For detailed schemas and patterns, see references/ai-config-schemas.md
โ ๏ธ Load references/tools-reference.md for complete documentation links
Modern CLI tools installed:
Configuration locations:
~/.config/fish/ (config.fish + conf.d/)~/.zshrc + ~/.config/zsh/conf.d/~/.bashrc, ~/.bash_profile + ~/.config/bash/conf.d/~/.config/nvim/ (LazyVim with Catppuccin)~/.config/starship.toml~/.claude/~/.codex/~/.gemini/~/.cursor/Git Worktree Manager (wt):
install-shell-config.sh)~/.config/fish/functions/wt.fishfish -c "wt <cmd>" from bash/zsh)~/.wt/<repo-name>/Key aliases:
ls โ eza, cat โ bat, grep โ rgfdz dirname, zi (zoxide)g, ga, gc, gp, gl, gs, etc.)lzg (lazygit), lzd (lazydocker), ff (fzf preview)cd .claude/skills/rr-system
# 1. Install development tools (includes Homebrew)
bash scripts/install-tools.sh
# 2. Upgrade all packages (MANDATORY)
brew upgrade
# 3. Install shell configs
bash scripts/install-shell-config.sh
# 4. Install AI configs
bash scripts/install-ai-configs.sh
# 5. Restart terminal, then:
fish # Start Fish shell
chsh -s $(which fish) # Optional: make Fish default
Verify:
bat --version
fish --version
ls ~/.config/fish/config.fish
ls ~/.claude/settings.json
fish -c "wt help"
# ALWAYS upgrade Homebrew first (MANDATORY)
brew upgrade
# Then update components
bash scripts/install-tools.sh
bash scripts/install-shell-config.sh
bash scripts/install-ai-configs.sh
# Restart terminal
To maintain feature parity:
references/ai-config-schemas.md for formatsjq empty), TOML (python3 tomllib)Verify tool installation:
command -v <tool> # Check if exists
which <tool> # Show location
<tool> --version # Check version
For wt (Fish function):
ls ~/.config/fish/functions/wt.fish # Check file exists
fish -c "wt help" # Test from any shell
Check configurations:
# Shell configs
ls ~/.config/fish/conf.d/
ls ~/.config/zsh/conf.d/
# AI configs
ls ~/.claude/settings.json
ls ~/.codex/config.toml
Not in PATH (macOS):
# Apple Silicon
eval "$(/opt/homebrew/bin/brew shellenv)"
# Intel
eval "$(/usr/local/bin/brew shellenv)"
Shell not found:
sudo sh -c "echo $(which fish) >> /etc/shells"
sudo sh -c "echo $(which zsh) >> /etc/shells"
Config not loading:
source ~/.config/fish/config.fish # Fish
source ~/.zshrc # Zsh
source ~/.bashrc # Bash
Tool not working:
command -v <tool> # Check exists
brew list | grep <tool> # Check installed
brew reinstall <tool> # Reinstall
source ~/.config/fish/config.fish # Reload config
Command not found:
ls ~/.config/fish/functions/wt.fish # Check file
fish -c "wt help" # Test from any shell
fish # Or switch to Fish
wt help
Note: wt is Fish-only. Use fish -c "wt <cmd>" from bash/zsh.
Syntax error:
# Validate JSON
jq empty ~/.claude/settings.json
# Validate TOML
python3 -c "import tomllib; tomllib.load(open('~/.codex/config.toml', 'rb'))"
Common errors:
Config missing:
bash scripts/install-ai-configs.sh # Reinstall
For detailed troubleshooting, see references/installation-guide.md
brew upgrade after installing Homebrewbat (cat), eza (ls), rg (grep), fd (find)z instead of cd for frequent directorieswt for git worktrees (Fish only)โ ๏ธ ALWAYS START WITH OFFICIAL DOCUMENTATION
Before using skill resources:
references/tools-reference.md for official doc URLsinstallation-guide.md - Complete installation instructions, troubleshooting, verificationtools-reference.md - Official documentation URLs, quick reference (verify online first)ai-config-schemas.md - Config schemas, MCP patterns, validation, merge strategiesinstall-tools.sh - Install development tools via Homebrewinstall-shell-config.sh - Install shell configurationsinstall-ai-configs.sh - Install AI assistant configurationsAll scripts are idempotent with verification.
Brewfile - CLI tools package list (cross-platform)Brewfile.macos - macOS-only applicationsai-configs/ - AI configuration templatesshell-config/ - Shell configuration files"What tools do I have?"
references/tools-reference.md for organized list by category"How do I install on new machine?"
bat --version, fish, wt help"How do I update everything?"
brew upgrade (MANDATORY first step)"Where is X configured?"
~/.config/<shell>/~/.claude/, ~/.codex/, ~/.gemini/~/.config/nvim/~/.config/starship.toml"Tool not working after install?"
command -v <tool>source ~/.config/fish/config.fishbrew reinstall <tool>~/.config/fish/functions/wt.fish, use fish -c "wt help"