verg

Desired-state infrastructure convergence engine. A fast, stateless alternative to Ansible, built in Rust.

Pre-1.0: verg is under active development. Expect breaking changes between minor versions.

Features

• Fast — pushes a single static binary to targets over SSH, executes locally. No Python, no per-task SSH round-trips.
• Predictable — stateless convergence. Every run checks reality and converges. No state files.
• Simple — TOML declarations with Jinja2 templating where needed. No variable precedence maze.
• Agent-friendly — --json output, schema command, structured exit codes. Built for both humans and AI agents.

Quick Start

# Install
cargo install verg

# Initialize a project
verg init

# Edit hosts and state
vim verg/hosts.toml
vim verg/state/base.toml

# Preview changes
verg diff --targets all

# Apply
verg apply --targets all

How It Works

1. Declare desired state in TOML files under verg/state/
2. Define hosts in verg/hosts.toml with group assignments
3. Run verg apply — the tool pushes a binary to each target over SSH, which checks current state and converges

Resource Types

Example

# verg/hosts.toml
[hosts.web1]
address = "192.168.1.10"
user = "root"
groups = ["web"]

# verg/state/web.toml
targets = ["web"]

[resource.pkg.nginx]
name = "nginx"
state = "present"

[resource.file.nginx-conf]
path = "/etc/nginx/nginx.conf"
content = "server { listen {{ http_port }}; }"
after = ["pkg.nginx"]

[resource.service.nginx]
name = "nginx"
state = "running"
enabled = true
after = ["file.nginx-conf"]

Commands

License

MIT