Skip to content

Define CODE and CODEX compatibility naming policy #183

@shiny-code-bot

Description

@shiny-code-bot

Objective

Define and apply a compatibility-safe policy for CODE_*, CODEX_*, ~/.code, and ~/.codex names.

Current Status

State: Waiting
Next action: Decide which env names get aliases, which dev-only names can rename, and which compatibility names must stay.
Blocked by: Owner decision on compatibility window and backend/external dependency tolerance.
Last verified: 2026-05-28.

Finish Line

Env/config compatibility names are classified and safely aliased or preserved

Acceptance Criteria

  • Preserve CODEX_HOME / ~/.codex compatibility fallback unless a separate migration says otherwise.
  • Classify CODEX_TUI_* debug/test vars as rename, alias, or keep.
  • Classify runtime/security/backend vars such as secure mode/API-key/header names before edits.
  • Document alias order and deprecation posture.
  • Add tests for any env-var behavior changes.

Relationships

Sub-issue of #179.
Related to #130 cleanup.

Metadata

Metadata

Assignees

No one assigned

    Labels

    planDurable planning issueplan:donePlan completed or supersededplan:waitingPlan is waiting on non-issue evidence or decision

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions