gandalf export: write gandalf.toml from local agent setup - Gandalf

gandalf export scans local AI agent configurations and writes a canonical gandalf.toml. It is the local-environment → manifest direction. Applying that manifest back onto local agent configs is gandalf apply. gandalf import is a backward-compatible alias for gandalf export. Prefer export in new scripts and docs.

Synopsis

gandalf export [flags]
gandalf import [flags]

Flags

Flag	Description	Default
`--project-only`	Scan repository files only (ignore user home)	off
`--from`	Export strictly from a specific configuration file or directory	(discovered paths)
`--dry-run`	Preview generated `gandalf.toml` without writing	off
`-f`, `--force`	Overwrite an existing `gandalf.toml`	off
`-o`, `--output`	Output manifest path	`gandalf.toml`
`-i`, `--interactive`	Launch the interactive TUI wizard	off (TTY default)
`-p`, `--project`	Project directory	`.`
`--home`	Home directory	`$HOME`
`--store`	Gandalf store directory	`~/.gandalf` or `$GANDALF_STORE`
`--json`	Emit JSON output	off

Examples

gandalf export --dry-run
gandalf export --project-only
gandalf export --force
gandalf import --dry-run

--json, --dry-run, and piped I/O stay headless. On a TTY, export opens a wizard to toggle servers/skills, preview a masked manifest, and confirm overwrite.

Behavior

Discovers project and (unless --project-only) user-home agent configs for Cursor, Claude Code, and Codex.
Reconciles sources with project-over-global precedence.
Redacts secrets into [env_template].
Mirrors team skills into .gandalf/skills/ with symlink-safe path confinement and atomic rollback.
Writes gandalf.toml unless --dry-run is set. Existing manifests require --force.

Export is manifest only (local agent config → gandalf.toml). Secrets, logins, and agent installs are out of scope. Other machines need gandalf apply (agents already installed; ${ENV} filled there). Use gandalf check to detect drift.