Why is YAML now preferred over JSON for Codex?

YAML is the standard for @fractary/cli v4.0 because it offers better readability, supports comments, and is more maintainable for project-level configuration.

Will I lose my settings during the migration process?

No. The skill is designed to preserve all user data during the conversion and includes a dry-run feature so you can verify changes before they are applied.

What system dependencies are required for this skill?

This skill requires 'jq' for processing JSON and 'yq' (specifically the mikefarah version) for generating YAML files.

Can this skill help me set up a new configuration?

If no configuration is found, the skill provides guidance on running the initialization command to create a fresh .fractary/codex.yaml file.

Codex Configuration Helper

Name: Codex Configuration Helper
Author: fractary

byfractary

•

开发者工具

Detects, validates, and migrates Fractary Codex configuration files from legacy JSON to modern YAML formats.

关于

The Codex Configuration Helper is a specialized utility designed to manage the evolution of Fractary Codex environments. It identifies deprecated global and project-level JSON configurations and automates their migration to the preferred project-level YAML format (v4.0). By handling format conversion, version upgrading, and path adjustments while ensuring data integrity, this skill ensures your setup remains fully compatible with the latest @fractary/cli and SDK requirements.

主要功能

Seamless migration from legacy JSON (v3.0) to preferred YAML (v4.0)
Comprehensive validation of configuration syntax and CLI compatibility
Dry-run mode to preview migration changes without modifying files
2 GitHub stars
Automatic detection of global and project-level configuration locations
Clear deprecation warnings and actionable next-step guidance

使用场景

Consolidating global configurations into project-specific settings for improved version control
Validating configuration health and troubleshooting syntax errors in project settings
Upgrading legacy Codex projects to ensure compatibility with modern Fractary CLI versions

关于

主要功能

Seamless migration from legacy JSON (v3.0) to preferred YAML (v4.0)
Comprehensive validation of configuration syntax and CLI compatibility
Dry-run mode to preview migration changes without modifying files
2 GitHub stars
Automatic detection of global and project-level configuration locations
Clear deprecation warnings and actionable next-step guidance

使用场景

Consolidating global configurations into project-specific settings for improved version control
Validating configuration health and troubleshooting syntax errors in project settings
Upgrading legacy Codex projects to ensure compatibility with modern Fractary CLI versions