Skip to content

[codex] Fix Claude setup and macOS path issues#599

Closed
Ununp3ntium115 wants to merge 1 commit into
colbymchenry:mainfrom
Ununp3ntium115:codex/fix-claude-macos-issues
Closed

[codex] Fix Claude setup and macOS path issues#599
Ununp3ntium115 wants to merge 1 commit into
colbymchenry:mainfrom
Ununp3ntium115:codex/fix-claude-macos-issues

Conversation

@Ununp3ntium115
Copy link
Copy Markdown

Summary

  • Add codegraph_files to Claude auto-allow permissions, create non-destructive installer backups, and make codegraph_context guidance/schema keyword-oriented.
  • Treat ArkTS .ets files as TypeScript for first-pass indexing.
  • Preserve UTF-8 Git paths for non-ASCII directories, including macOS/CJK paths, and block project-root escapes through symlinked files or directories.
  • Add contributor setup docs covering local CLI linking and the macOS Node/FTS5 source-build workaround.

Root Cause

Claude-facing setup had drifted from the current MCP tool surface, the installer could overwrite existing agent config without a reliable restore point, and codegraph_context wording encouraged agents to send verbose natural-language tasks into a keyword-backed lookup.

For the macOS/path issues, Git quotes non-ASCII paths by default, so tracked files under CJK directories could reach extension detection as quoted octal escapes. Path containment also only used lexical path.resolve, so a symlink inside the project could resolve outside the project root after passing validation.

Issues

Fixes #565
Fixes #486
Fixes #571
Fixes #512
Fixes #541
Fixes #527
Fixes #305

Validation

  • npx -y -p node@22 node ./node_modules/vitest/vitest.mjs run (52 files, 1102 passed, 2 skipped)
  • npm test -- __tests__/extraction.test.ts
  • npm test -- __tests__/security.test.ts __tests__/installer.test.ts __tests__/installer-targets.test.ts __tests__/mcp-tool-allowlist.test.ts
  • npm run build
  • git diff --check

Fixes Claude integration issues around codegraph_files auto-allow, installer backups, codegraph_context guidance, and ArkTS .ets detection.

Fixes macOS-related path issues around non-ASCII git paths and symlink escapes, and documents the macOS FTS5 source-build workaround.

Refs colbymchenry#565 colbymchenry#486 colbymchenry#571 colbymchenry#512 colbymchenry#541 colbymchenry#527 colbymchenry#305.
@Ununp3ntium115
Copy link
Copy Markdown
Author

Superseded by the focused draft PRs #600 (Claude installer/MCP context fixes) and #601 (macOS path/symlink/docs fixes). Closing this combined draft so maintainers can review the smaller branches independently.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment