Anvil CLI

What Anvil Does

• Batch App Installation: Install development tools in groups or individually via Homebrew
• Configuration Sync: Sync dotfiles across machines using simple commands and private GitHub repositories
• Health Checks: Auto-diagnose and fix common setup issues

Why Choose Anvil?

• Fast Setup: Get coding in minutes, not hours
• Consistency: Same configs and tools across all machines
• Built-in Safety: Dry-run mode, private repo enforcement and automatic backups

Quick Start

Installation

Via install script (Recommended for fresh machines):

curl -sSL https://github.com/0xjuanma/anvil/releases/latest/download/install.sh | bash

Via Homebrew (If you already have Homebrew installed):

brew install 0xjuanma/tap/anvil

Update existing installation:

anvil update

Available Commands

| Command | Description | |---------|-------------| | anvil init [--discover] | Initialize your Anvil environment, dependencies & optionally discovers apps in your system| | anvil doctor | Check system health | | anvil install [group-name] | Install tools by groups| | anvil config show [app-name] | Show your anvil settings or app settings | | anvil config push [app-name] | Push your app configurations to GitHub | | anvil config pull [app-name] | Pull your app configurations from GitHub | | anvil config sync [app-name] | Sync your pulled app configurations to your local machine | | anvil clean | Clean your anvil environment | | anvil update | Update your anvil installation | | anvil --version/-v | Show the version of anvil |

Try It Out

# Initialize Anvil (optionally discover existing apps)
anvil init --discover
Check environment health
anvil doctor
Install development tools
anvil install essentials # sample essentials group
anvil install terraform  # Individual apps
Import tool groups from shared configs
anvil config import https://example.com/team-groups.yaml
Or start with example configurations
anvil config import https://raw.githubusercontent.com/0xjuanma/anvil/master/docs/import-examples/juanma-essentials.yaml
Sync configurations (after setting up GitHub repo)
anvil config push neovim
anvil config pull neovim
anvil config sync neovim

Features

• Smart Installation: Install individual apps or user-defined groups (dev, essentials, etc) holding many apps
• Group Import: Import groups from local files or URLs with validation and conflict detection
• Auto-tracking: Automatically tracks installed apps and prevents duplicates
• Secure Config Sync: Uses private GitHub repositories with automatic backups
• Health Diagnostics: anvil doctor detects and auto-fixes common issues
• Zero Configuration: Works out of the box with sensible defaults

Documentation

| Guide | Description | |-------|-------------| | Configuration Management | Config sync setup and workflows | | Install Command | Installation command guide; leverages Homebrew for formulae/cask, and supports custom urls/installations scripts via sources | | Import Groups | Import Anvil groups from files/URLs | | Doctor Command | Health checks and validation | | Clean command | Cleans Anvil non-critical dependencies |

View All Documentation →