auspex settings
Last updated: November 19, 2026
auspex runs with built-in defaults, so most people never change a setting. This article lists the settings you can change and how. Each setting lives in a YAML file:
On your own computer, in
config.yamlin your auspex folder:~/.auspex/config.yamlon macOS and Linux,%USERPROFILE%\.auspex\config.yamlon Windows. You can edit the file, but the commands below do it for you.On a managed fleet, in
managed.yaml, which your MDM deploys. It takes the same settings, with the same meaning. See auspex managed settings for where it lives and how to deploy it.
auspex keeps your settings across upgrades and reinstalls. The commands below need auspex v0.14.0 or later. On Windows, run auspex by its full path as your install guide shows, unless you've added it to your PATH.
capture.tools: which coding tools auspex captures
auspex captures every coding tool it supports by default. capture.tools narrows that to a list.
Tool | Name in the list |
|---|---|
Claude Code |
|
Codex |
|
GitHub Copilot CLI |
|
Cursor |
|
VS Code (Copilot Chat) |
|
OpenCode |
|
The list can also include default, which stands for every tool auspex captures by default. A list with default picks up tools that later releases add to the defaults. A list without it stays exactly as written. For example, [default, opencode] captures the defaults plus OpenCode, while [claude-code, cursor] captures only those two.
capture:
tools: [claude-code, cursor]
A tool you take off the list stops being captured: auspex removes its hooks from that tool and leaves your own hooks in place. A list can't be empty, so to stop capturing altogether, uninstall auspex. A name auspex doesn't know is skipped with a warning.
Choose the tools when you install. Add --tools to the install command from your install guide:
auspex install --service --tools claude-code,cursor
Running auspex install again without --tools keeps your list.
Add or remove one tool at any time:
auspex hooks install --tool codex
auspex hooks uninstall --tool cursor
Removing a tool that default covers replaces default in your list with today's default tools minus that one. auspex warns you when it does this, because tools that later releases add to the defaults then aren't captured. To get default back, run your install command again with --tools default.
See what's selected with auspex hooks status. It lists each tool and where it comes from.
A change you make to config.yaml by hand takes effect the next time you run auspex install or auspex hooks install.