Core

scorpiox-config

Configuration manager for scorpiox-env.txt. Read, query, and inspect cascaded configuration across default, global, user, and project tiers.

Supported Platforms

🐧 linux-x64 🐧 linux-arm64 🍎 macos-arm64 🪟 windows-x64

Flags & Options

Flag	Short	Description	Takes Value
`--dump`	`—`	Print all resolved config to stdout	No
`--files`	`-f`	Show cascade file paths and existence	Yes
`--get`	`—`	Print value of KEY to stdout	No
`--help`	`-h`	Show help message and exit	Yes
`--level`	`-l`	Filter by tier (default\|global\|user\|project or 0-3)	Yes
`--show-source`	`-s`	Show output grouped by source file with paths	Yes
`--version`	`-v`	Print version information and exit	No

Usage Examples

Dump all resolved configuration

# Print every key-value pair from all tiers, merged $ scorpiox-config --dump PROVIDER=anthropic MODEL=claude-sonnet-4-20250514 SCORPIOX_HOME=/home/user/.scorpiox EDITOR=vim THEME=dark

Get a single configuration value

# Query one key — ideal for scripting $ scorpiox-config --get PROVIDER anthropic # Use it in a shell variable $ CURRENT_PROVIDER=$(scorpiox-config --get PROVIDER) $ echo "Using provider: $CURRENT_PROVIDER" Using provider: anthropic

List configuration file paths

# Show cascade file paths and whether they exist $ scorpiox-config --files [0] default /opt/scorpiox/etc/scorpiox-env.txt ✓ exists [1] global /etc/scorpiox/scorpiox-env.txt ✗ missing [2] user /home/user/.config/scorpiox/scorpiox-env.txt ✓ exists [3] project /home/user/myapp/.scorpiox-env.txt ✓ exists

Filter by configuration tier

# Show only user-level config (tier 2) $ scorpiox-config --dump --level user PROVIDER=openai THEME=dark # Same using numeric tier $ scorpiox-config --dump -l 3 MODEL=gpt-4o DEBUG=1

Show config grouped by source file

# See which file each key comes from $ scorpiox-config --show-source ── /opt/scorpiox/etc/scorpiox-env.txt (default) ── SCORPIOX_HOME=/home/user/.scorpiox EDITOR=vim ── /home/user/.config/scorpiox/scorpiox-env.txt (user) ── PROVIDER=anthropic THEME=dark ── /home/user/myapp/.scorpiox-env.txt (project) ── MODEL=claude-sonnet-4-20250514 DEBUG=1

Combine flags for advanced queries

# Show project-level config with source paths $ scorpiox-config --show-source --level project # Check version $ scorpiox-config --version scorpiox-config 1.0.0

Source & Build Info

Source File

scorpiox/scorpiox-config.c

Lines of Code

1,755

Dependencies

libsxutil

scorpiox-config

Supported Platforms

Flags & Options

Usage Examples

Source & Build Info

Related Tools