---

name: configuration description: "Routes evo package-info, settings, logfile, and IPython shell workflows." disable-model-invocation: true metadata: disco-role: operating license: GPL 3.0

configuration

Use this sub-skill for the non-trajectory, non-metric, non-result workflows around evo's global settings, package metadata, logfile access, and preloaded IPython shell.

Routes here

• evo_config show, set, generate, reset
• evo pkg --info, --version, --pyversion, --license, --location, --logfile, --open_log, --clear_log
• evo cat_log
• evo_ipython

Do not use for

• Trajectory, metric, or result semantics. Route those to the dedicated workflow sub-skills.
• Custom application embedding or notebook recipes. Route those to ../python-api/SKILL.md, except for simple cross-links.
• Implicit or hidden settings mutations. Keep edits explicit and user-confirmed.

Start here

1. Read references/cli-reference.md for exact flags and output shapes.
2. Read references/settings.md for settings paths, default values, and merge/reset rules.
3. Use references/workflows.md for noninteractive recipes.
4. Use references/troubleshooting.md when a command fails or behaves unexpectedly.

Safe operating rules

• The package settings file is ~/.evo/settings.json; the global logfile is ~/.evo/evo.log.
• show --brief --no_color is the safest read-only settings check.
• generate is read-only unless you pass -o/--out.
• set and reset mutate the chosen settings file and require write access.
• evo_ipython requires IPython on PATH and will create the evo profile on first launch if needed.
• evo cat_log is unavailable on Windows.
• The interactive source-tree demo test/demos/config_demo.sh was intentionally not bundled because it mutates settings and waits for stdin; the CLI recipes above are the safe replacement.

Bundled helper

No scripts/config_smoke.py is bundled. The safe verification paths are already covered by the CLI itself (show, generate, pkg, cat_log, evo_ipython), and a helper that edits settings would add mutation risk without adding safety.