Skip to content

Make CLAUDE.md setup-agnostic - #662

Merged
seperman merged 1 commit into
devfrom
claude-md-portable-env
Nov 16, 2026
Merged

seperman merged 1 commit into
devfrom
claude-md-portable-env

Conversation

@seperman

Copy link
Copy Markdown
Member

Summary

  • Removes the hardcoded source ~/.venvs/deep/bin/activate prefix from every command in CLAUDE.md (also served as AGENTS.md via symlink).
  • Adds a Python Environment section telling agents to use whatever environment is already active ($VIRTUAL_ENV), otherwise the one the contributor loads via direnv / .venv / UV_PROJECT_ENVIRONMENT, and only as a last resort create one with uv sync --all-extras.
  • Notes that nox builds its own isolated envs, and that pyright follows the active interpreter (with pyrightconfig.json.example as an override).
  • Removes stray capi run / cettings shell references copied from another project.
  • Gitignores CLAUDE.local.md so contributors can keep machine-specific instructions locally.

Docs-only change; no code affected.

Replace hardcoded venv activation commands with guidance for detecting the
contributor's active environment (VIRTUAL_ENV, direnv, .venv, uv). Remove
stray references from another project, and gitignore CLAUDE.local.md for
personal, machine-specific instructions.
@codecov

codecov Bot commented Nov 16, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.09%. Comparing base (556b60d) to head (73fde20).

Additional details and impacted files
@@           Coverage Diff           @@
##              dev     #662   +/-   ##
=======================================
  Coverage   95.09%   95.09%           
=======================================
  Files          18       18           
  Lines        4915     4915           
=======================================
  Hits         4674     4674           
  Misses        241      241           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@seperman
seperman merged commit a4d297d into dev Nov 16, 2026
7 checks passed
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