rr-system

Automate macOS and Linux system setup and AI configuration management.

54|9|Updated Aug 13, 2025
One-click install
npx skills add https://github.com/roderik/ai-rules --skill rr-system
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rr-system
Source: https://github.com/roderik/ai-rules/tree/main/.claude/skills/rr-system
Command: npx skills add https://github.com/roderik/ai-rules --skill rr-system

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires homebrew, bun, jq, python3, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the setup and management of your development environment across macOS and Linux, including shell configurations, modern CLI tools, and AI assistant settings, ensuring consistency and reducing setup time.

Core Features & Use Cases

  • Automated Dev Environment: Install Homebrew, CLI tools, macOS apps, and shell configurations with simple scripts.
  • AI Config Management: Manage and synchronize configurations for Claude Code, Codex CLI, Gemini CLI, and OpenCode, including MCP servers.
  • Tool Reference & Troubleshooting: Access comprehensive documentation for all installed tools and troubleshoot common environment issues.
  • Use Case: When setting up a new laptop, simply run the provided scripts to get a fully configured development environment with all your preferred tools and AI assistant settings in minutes.

Quick Start

Use the rr-system skill to install all development tools and Homebrew on this machine.

Frequently Asked Questions about rr-system

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate my dev environment setup on a new Mac or Linux machine?

Automate dev environment setup by running rr-system scripts that install Homebrew, CLI tools, shell configurations, and AI assistant settings in one pass. The scripts handle idempotent installation across macOS and Linux, reducing setup time from hours to minutes while ensuring consistency.

Can I manage Claude Code, Codex, and Gemini configurations in one place?

Yes, rr-system centralizes AI assistant configuration management for Claude Code, Codex CLI, Gemini CLI, and OpenCode, including MCP server synchronization. Configurations are validated and deployed consistently across your environment.

What shell configurations and file formats does rr-system support?

rr-system handles shell-config deployment for .fish, .zsh, and .bash, plus configuration files in JSON and TOML formats, and Brewfiles for tool inventory. It validates syntax and applies changes idempotently to avoid conflicts.

Do I need Homebrew, Bun, and Python installed before using rr-system?

rr-system requires Homebrew, Bun, jq, and Python3 as dependencies. The Skill installs and manages these prerequisites, but they must be available in your environment or installed as part of the initial setup process.

How do I troubleshoot common installation and configuration issues?

rr-system includes comprehensive tool references and troubleshooting guides for common config and installation problems. It provides continuous progress reporting during setup, helping you identify issues with shell configs, Brewfile parsing, or JSON/TOML validation.

Can rr-system sync configurations across multiple machines?

rr-system uses templates and references to maintain consistency across macOS and Linux machines. While it automates deployment on individual systems, you can version-control your configuration files and Brewfiles to replicate setup across devices.