Skip to content

feat(context): rebrand the context file CLAUDE.md → CLAWCODEX.md#732

Merged
ericleepi314 merged 1 commit into
mainfrom
feat/clawcodex-md-rebrand
Jul 21, 2026
Merged

feat(context): rebrand the context file CLAUDE.md → CLAWCODEX.md#732
ericleepi314 merged 1 commit into
mainfrom
feat/clawcodex-md-rebrand

Conversation

@ericleepi314

Copy link
Copy Markdown
Collaborator

clawcodex is its own product — its instruction/memory file convention is now CLAWCODEX.md (and CLAWCODEX.local.md), replacing the inherited CLAUDE.md naming across the app. Clean break: the legacy names are not read (no fallback), per project direction.

Core (src/context_system/clawcodex_md.py, renamed from claude_md.py)

  • CLAWCODEX.md / CLAWCODEX.local.md at every tier: managed (/etc/clawcodex), user (~/.clawcodex), project root, .clawcodex/, local, and --add-dir.
  • get_claude_mdsget_clawcodex_mds; disable switch renamed to CLAWCODEX_DISABLE_CLAWCODEX_MDS; is_memory_file_path recognizes the canonical names.

Everywhere else

  • /init generates CLAWCODEX.md (+ .local.md) with rebranded prompt wording.
  • /memory picker rows target ~/.clawcodex/CLAWCODEX.md and the nearest project CLAWCODEX.md.
  • The one-time ~/.claude import migration copies that harness's CLAUDE.md in under the canonical CLAWCODEX.md name — the only place the old name is still touched, as a migration source.
  • Agent frontmatter key: omit-clawcodex-md / omitClawcodexMd.
  • Threat pattern agent_config_mod guards CLAWCODEX.md (CLAUDE.md stays listed purely as attack-target vocabulary, like .cursorrules).
  • User-context reminder header key claudeMdclawcodexMd (renders as a # <key> section header; deliberate TS divergence pinned by a positive parity test). Persisted config keys (hasClaudeMdExternalIncludes*) and TS-source citations keep their spellings.
  • README / ARCHITECTURE / FEATURE_LIST / ZH mirror + all test fixtures swept.

Validation

  • Full Python suite 8,600 passed / 0 failed; TUI vitest at main's baseline; tsc --noEmit clean.
  • Critic-reviewed (APPROVE) with suggestions applied: positive clawcodexMd emission pin, agent-frontmatter rebrand, doc sweeps.

Note for local setups: existing ~/.clawcodex/CLAUDE.md or per-repo CLAUDE.md files must be renamed to CLAWCODEX.md to keep loading (one mv per file — no in-app fallback by design).

🤖 Generated with Claude Code

clawcodex is its own product — its instruction/memory file convention is
now CLAWCODEX.md (and CLAWCODEX.local.md), replacing the inherited
CLAUDE.md naming across the app. Clean break: the legacy names are not
read (no fallback), per project direction.

Core (src/context_system/clawcodex_md.py, renamed from claude_md.py):
- CLAWCODEX.md / CLAWCODEX.local.md at every tier: managed
  (/etc/clawcodex), user (~/.clawcodex), project root, .clawcodex/,
  local, and --add-dir.
- get_claude_mds → get_clawcodex_mds; kill switch renamed to
  CLAWCODEX_DISABLE_CLAWCODEX_MDS; is_memory_file_path recognizes the
  canonical names.

Everywhere else:
- /init generates CLAWCODEX.md (+ .local.md) with rebranded wording.
- /memory picker rows target ~/.clawcodex/CLAWCODEX.md and the nearest
  project CLAWCODEX.md.
- The one-time ~/.claude import migration copies that harness's
  CLAUDE.md in under the canonical CLAWCODEX.md name (user + project
  passes) — the only place the old name is still touched, as a
  migration SOURCE.
- Agent frontmatter key: omit-clawcodex-md / omitClawcodexMd.
- Threat pattern agent_config_mod guards CLAWCODEX.md (CLAUDE.md stays
  listed purely as attack-target vocabulary alongside .cursorrules).
- User-context reminder header key claudeMd → clawcodexMd (renders as a
  `# <key>` section header; deliberate TS divergence, pinned by a
  positive parity test). Persisted config keys
  (hasClaudeMdExternalIncludes*) and TS-source citations keep their
  spellings.
- README / ARCHITECTURE / FEATURE_LIST / ZH mirror + all test fixtures
  swept; karpathy verbatim pin updated for the header rebrand.

Full Python suite green; TUI vitest at baseline; ui-tui typecheck clean.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@ericleepi314
ericleepi314 force-pushed the feat/clawcodex-md-rebrand branch from 9aa8b2b to 71effa6 Compare July 21, 2026 05:08
@github-actions

Copy link
Copy Markdown

Test Results

    1 files      1 suites   6m 53s ⏱️
8 753 tests 8 746 ✅ 6 💤 1 ❌
8 938 runs  8 931 ✅ 6 💤 1 ❌

For more details on these failures, see this check.

Results for commit 71effa6.

@ericleepi314

Copy link
Copy Markdown
Collaborator Author

LGTM

@ericleepi314
ericleepi314 merged commit 120868e into main Jul 21, 2026
1 of 3 checks passed
@ericleepi314
ericleepi314 deleted the feat/clawcodex-md-rebrand branch July 21, 2026 06:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant