magus-config
View or update magus configuration
Synopsis
magus config <view|set|init> [flags]
Description
Inspect or modify the magus configuration. Configuration is loaded in priority order: built-in defaults → user-global file → workspace file → project-local file → MAGUS_* environment variables → CLI flags.
The view sub-command prints the effective merged configuration. The set sub-command writes a key-value pair to the local (or global) config file. The init sub-command materializes the built-in defaults to a magus.yaml so they can be edited by hand.
Configuration is stored in magus.yaml (or .magus.yaml). The canonical locations are the workspace root and $XDG_CONFIG_HOME/magus/.
Subcommands
- view
- Print the effective configuration (defaults + file + env)
- set
- Write a key to the local (or global) config file
- init
- Materialize built-in defaults to magus.yaml
- cache
- Manage the build cache (prune --older-than)
Examples
Show effective config
magus config view
Show config as JSON
magus config view -o json
Set cache to read-only
magus config set cache.immutable true
Initialize magus.yaml from defaults
magus config init
See Also
magus(1), magus-ls(1), magus-describe(1), magus-run(1), magus-x(1), magus-where(1), magus-affected(1), magus-insight(1), magus-graph(1), magus-watch(1), magus-status(1), magus-doctor(1), magus-server(1), magus-completion(1), magus-man(1), magus-init(1), magus-self(1), magus-version(1)