gandalf check: detect drift from the team manifest - Gandalf

gandalf check compares the team manifest at gandalf.toml with your local agent environment and reports drift. Use it locally to preview what gandalf apply would do, or in CI to enforce team standards.

Synopsis

gandalf check [flags]

Flags

Flag	Description	Default
`--manifest`	Path to `gandalf.toml`	search project root
`--ci`	Exit with code 1 on drift or errors	off
`-p`, `--project`	Project directory	`.`
`--home`	Home directory	`$HOME`
`--store`	Gandalf store directory	`~/.gandalf` or `$GANDALF_STORE`
`--json`	Emit JSON output	off

Examples

gandalf check
gandalf check --ci
gandalf check --manifest ./config/gandalf.toml
gandalf check --json

Output shape

Text output prints the manifest name and version, the target agents, and one of two states:

In sync: local setup matches the manifest.
Drift detected: numbered list of items with agent, kind, name, and target file path.

Example:

📦 Team Manifest: my-team-project (version: 1.0)
🎯 Target Agents: claude-code, codex

⚠️  [DRIFT DETECTED] The following items are missing or out of sync:
  [1] [claude-code] mcp_server: postgres-db (~/.claude/settings.json)

Add --json for machine output containing the parsed manifest and drift list.

Errors

MANIFEST_NOT_FOUND: run gandalf init to create a manifest.
MANIFEST_PARSE_ERROR: check TOML syntax.
MANIFEST_VALIDATION_ERROR: correct required fields per the manifest reference.

⌘I