How do I sync my dotfiles with Anvil?

Anvil uses private GitHub repositories for config sync. After setting up a repo, you can push, pull, and sync dotfiles with commands like `anvil config push neovim` and `anvil config sync neovim`, as shown in the quick start guide.

Anvil vs dotfiles manager: which is better?

Anvil combines dotfile sync with batch tool installation and health checks, making it more comprehensive for full environment management. Use a plain dotfiles manager if you only need config synchronization without tool automation.

How to import a tool group from a team member's config?

Use the `anvil config import` command with a URL to a YAML file, such as shared team configurations. Anvil validates and imports these groups, as demonstrated in the import examples documentation.

Does Anvil work on Linux?

No, Anvil is macOS-only and relies on Homebrew, which is native to macOS. The platform badge clearly states this limitation, so it's not suitable for Linux or Windows environments.

What if my GitHub repo is down during sync?

Anvil enforces private repositories and provides automatic backups, but sync operations require GitHub access. In case of downtime, you might rely on local backups, though real-time sync will be interrupted.

How to fix setup issues with Anvil's doctor command?

Run `anvil doctor` to automatically detect and fix common issues like missing dependencies or configuration errors. This feature is designed to reduce manual troubleshooting, as detailed in the health diagnostics section.

Open-Awesome

anvil

Apache-2.0Gov2.9.0

CLI tool to install development tools and sync configurations across machines using Homebrew and private GitHub repos.

Visit Website GitHub

116 stars3 forks0 contributors

What is anvil?

Anvil is a CLI tool that streamlines developer environment management by automating tool installation and configuration synchronization. It solves the problem of spending hours setting up new machines or keeping multiple development environments consistent by leveraging Homebrew for installations and private GitHub repositories for config management.

Target Audience

Developers working on macOS who need to set up and maintain consistent development environments across multiple machines, particularly those who frequently switch between computers or onboard new team members.

Value Proposition

Developers choose Anvil because it provides a single command-line interface to manage both tool installations and configuration sync, with built-in safety features like dry-run mode, automatic backups, and health diagnostics that prevent common setup issues.

Overview

CLI to streamline config management and tool installation. Install your full dev tool-chain in one command and sync configurations across machines seamlessly, leverages homebrew and private repos.

Use Cases

Best For

Setting up a new development machine quickly with all required tools
Keeping dotfiles and configurations synchronized across multiple computers
Onboarding new team members with standardized development environments
Managing groups of development tools for different projects or workflows
Diagnosing and fixing common development environment issues automatically
Sharing tool configurations across teams via importable group files

Not Ideal For

Cross-platform development teams requiring environment consistency on Linux or Windows
Projects heavily reliant on containerized workflows like Docker, where local tool management is secondary
Users who prefer GUI-based configuration managers or manual setup for granular control
Organizations using enterprise configuration management tools like Ansible or Chef for infrastructure-as-code

Pros & Cons

Pros

Batch Tool Installation

Leverages Homebrew to install multiple development tools in user-defined groups like 'essentials', reducing setup time with commands such as `anvil install essentials`.

Secure Config Synchronization

Uses private GitHub repositories with automatic backups for dotfile management, ensuring data privacy and safe sync operations via commands like `anvil config push`.

Intelligent Health Diagnostics

The `anvil doctor` command auto-diagnoses and fixes common setup issues, minimizing manual troubleshooting as highlighted in the health checks feature.

Smart Installation Tracking

Prevents duplicate installations by automatically tracking installed apps, optimizing efficiency and avoiding conflicts during environment setup.

Cons

macOS Exclusive

Only supports macOS, as indicated by the platform badge, making it unsuitable for developers on Linux or Windows who need cross-platform environment management.

Homebrew Dependency

Relies entirely on Homebrew for tool installations, which may not fit teams using alternative package managers or custom installation scripts, limiting flexibility.

GitHub Integration Required

Configuration sync depends on setting up and maintaining private GitHub repositories, adding an external dependency and setup complexity for users without GitHub accounts.

Frequently Asked Questions

Related Projects

Stronghold

Easily configure macOS security settings from the terminal.

Stars1,192

Forks262

Last commit1 year ago

dark-mode

Control the macOS dark mode from the command-line

Stars687

Forks39

Last commit1 year ago

clippy

Unified clipboard tool for macOS that intelligently handles both text and file copying

Stars246

Forks4

Last commit3 days ago

open-pip-cli

📺 CLI for https://github.com/albinekb/open-pip - Open a movie url or path in macOS picture-in-picture

Stars215

Forks11

Last commit3 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub