Skip to main content
Gandalf is a Go CLI and Bubble Tea TUI that acts as a local control console for AI agent setup across Codex and Claude Code. It inspects installed skills, hooks, MCP servers, and plugins, browses agent-native marketplace and source entries, and applies only reviewed provider-backed changes. This page lists every top-level command, the common flags available on most commands, and how to open the interactive setup console.

​
Commands

​
The TUI entry point

Running gandalf with no arguments opens the interactive setup console:
This is equivalent to:
The setup console presents five top tabs:
  • Home: Dashboard and quick navigation
  • Console: Interactive workspace for managing configuration
  • Changes: Review Changes before any mutation
  • Timeline: Browse history and undo candidates
  • Saves: Manage saved snapshots
The Console tab contains five sub-tabs:
  • Hooks
  • Plugins
  • Marketplace
  • Skills
  • MCP Servers

​
Common flags

Most gandalf commands accept the following flags, and some accept additional command-specific flags.
You can override the default store directory with the $GANDALF_STORE environment variable or the --store flag.

​
Quick navigation

scan

Read-only discovery

snapshot

Save and inspect snapshots

diff

Compare two refs

restore

Restore from a snapshot

bundle

Export and import bundles

timeline

Browse history and undo

tui

Interactive setup console

init

Initialize a project

check

Detect drift

apply

Sync a manifest

doctor

Portability readiness

report

Markdown reports