system-configuration

The system configuration wizard detects your platform, validates Python and Git installations, and saves credentials via environment variables to a centralized settings.json file. It supports Windows, macOS, and Linux, applying the same validation schema across all environments during initial onboarding or credential updates.

You can migrate tool paths and update credentials across Windows, macOS, and Linux using the environment detection and validation features. The setup wizard identifies your current platform, applies a standardized schema, and securely handles credentials via environment variables for safe cross-platform configuration.

A centralized settings.json file consolidates tool paths, system settings, and knowledge-evolution preferences in one place. It references credentials from environment variables rather than storing them directly, ensuring secure credential handling and schema validation during updates and migrations.

The system configuration wizard supports legacy tool migrations with backup-enabled saves when updating settings.json. It validates configurations against a schema before applying changes, ensuring safe migrations and updates across Windows, macOS, and Linux environments without losing previous settings.

Environment detection fails during setup when Python or Git dependencies are missing or misconfigured. The interactive discovery process validates these tools immediately against a schema, ensuring a healthy starting point before creating or migrating the centralized settings.json configuration file.

You need to set environment variables for credentials before running the configure system command. The setup wizard references these environment variables for secure credential handling, ensuring sensitive data is not hardcoded in the centralized settings.json file during onboarding or migration across environments.