Skip to content

Commit 0037587

Browse files
committed
docs(install): recommend pipx and warn against venv-source
Fixes #51
1 parent 802b8d9 commit 0037587

1 file changed

Lines changed: 9 additions & 4 deletions

File tree

README.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,12 +24,17 @@ lines outward and stops as soon as additional context stops paying for itself.
2424
## Install (30 seconds)
2525

2626
```bash
27-
pip install diffctx # canonical
28-
pipx install diffctx # or: isolated, no venv needed
29-
pip install 'diffctx[tree-sitter]' # + AST parsing for smarter diff context
30-
pip install 'diffctx[mcp]' # + MCP server for AI assistants
27+
pipx install diffctx # recommended — isolated CLI, no venv needed
28+
pip install diffctx # or: into an active environment
29+
pipx install 'diffctx[tree-sitter]' # + AST parsing for smarter diff context
30+
pipx install 'diffctx[mcp]' # + MCP server for AI assistants
3131
```
3232

33+
> For everyday use, install once with `pipx` and call `diffctx` from any
34+
> directory. Do **not** `source` the project's `.venv` to run `diffctx` from
35+
> another repo — that runs a working-tree build and mutates the shell's
36+
> `PATH`/`PYTHONHOME` for every subsequent command.
37+
3338
```bash
3439
diffctx . --diff HEAD~1 # smart context for last commit → paste into Claude/ChatGPT
3540
diffctx . -f md -c # full export → clipboard in Markdown

0 commit comments

Comments
 (0)