Infrastructure as Code for AI Agents.

Declare MCP servers, skills, and hooks in gandalf.toml. Catch configuration drift in CI. Roll back safely.

Declarative gandalf.toml
Non-destructive smart merge
Instant safety rollback

Install $ brew install qyinm/tap/gandalf

01 / The Problem

"It works on my agent" is the new "it works on my machine."

Previously, teams onboarded developers by installing an IDE and extensions. Today, engineers build with AI agents — but every agent has different MCP servers, missing skills, and unverified hooks.

Manifest gandalf.toml

Smart Merge non-destructive

Safety Net pre-apply snapshot

02 / The Workflow

Standardize in three steps.

Declarative setup, automated CI drift detection, and safe non-destructive application.

Initialize

$ gandalf init

Scaffold a team manifest (gandalf.toml) and shared skills directory in your repo.

agent-environment-as-code

Check Drift

$ gandalf check --ci

Detect missing MCP servers, unverified skills, and drifted agent configs locally and in CI.

zero-mutation discovery

Smart Apply

$ gandalf apply --yes

Non-destructively merge team tools into Claude Code and Codex with pre-apply safety backup.

1-click rollback enabled

Engine Guarantees Non-destructive by design.

Target Agents Claude Code (~/.claude) & OpenAI Codex (~/.codex)

Smart Merge Preserves personal hooks, user plugins, and custom themes

Secret Safety Interpolates ${ENV_VAR} templates at apply time; never stores raw secrets

Rollback Guard Automatic pre-apply snapshots restorable via gandalf restore

03 / Install

Install.

No account.

$ brew install qyinm/tap/gandalf

Installs the pre-built binary to Homebrew's bin directory with auto-updates.

Then run gandalf init to standardize your team agent environment.

04 / Ready