Skip to main content
gandalf scan performs read-only discovery of the local agent configuration for codex and claude-code. It inspects installed skills, hooks, MCP servers, and plugins without making any changes, so you can run it safely at any time to understand the current state of your setup.

​
Synopsis

​
Flags

​
Examples

​
Basic scan for Codex

​
Scan and emit JSON

CodeGroup

​
Scan with explanation

​
Notes

  • scan never writes to disk. It is safe to run repeatedly.
  • When --explain is passed, the output includes the file paths Gandalf inspected, which is useful for debugging or for understanding how agent configuration is resolved.
  • Use --json to pipe scan output into other tools or for programmatic inspection.
  • Currently supported agents are codex and claude-code. Project-local files are out of scope for the current release.