@ataraxy-labs/sem 0.3.23 → 0.4.0

package/README.md

@@ -1,3 +1,7 @@
+> **Part of the [Ataraxy Labs](https://ataraxy-labs.com) stack** — agent-native infrastructure for software development. See also: [weave](https://ataraxy-labs.com/weave) (entity-level git merge driver) · [inspect](https://github.com/Ataraxy-Labs/inspect) (semantic code review) · [opensessions](https://github.com/Ataraxy-Labs/opensessions) (tmux sidebar for coding agents).
+>
+> Read the manifesto: https://ataraxy-labs.com/#thesis · Essays: https://ataraxy-labs.com/blogs · LLMs: https://ataraxy-labs.com/llms.txt
+
 <p align="center">
   <img src="assets/banner.svg" alt="sem" width="600" />
 </p>
@@ -67,6 +71,25 @@ docker build -t sem .
 docker run --rm -it -u "$(id -u):$(id -g)" -v "$(pwd):/repo" sem diff
 ```
 
+## Name conflict with GNU Parallel
+
+GNU Parallel ships a `sem` binary (`/usr/bin/sem`) as a symlink to `parallel`. If you have both installed, they'll collide. Run `sem --version` to check which one you're using. ([#77](https://github.com/Ataraxy-Labs/sem/issues/77))
+
+**Quick fixes:**
+
+```bash
+# Option 1: alias in your shell profile (~/.bashrc, ~/.zshrc)
+alias sem="$HOME/.cargo/bin/sem"
+
+# Option 2: make sure cargo bin comes first in PATH
+export PATH="$HOME/.cargo/bin:$PATH"
+
+# Option 3: if installed via Homebrew
+export PATH="$(brew --prefix)/bin:$PATH"
+```
+
+If you installed via npm/bun, the binary lives in `node_modules/.bin/sem` and is invoked through `npx sem` or `bunx sem`, which avoids the conflict entirely.
+
 ## Commands
 
 Works in any Git repo. No setup required. Also works outside Git for arbitrary file comparison.
@@ -165,12 +188,17 @@ sem log authenticateUser --json
 
 ### sem entities
 
-List all entities in a file with their types and line ranges.
+List all entities under a file or directory path. No path is the same as `.`.
 
 ```bash
+sem entities
+
+sem entities .
+
 sem entities src/auth.ts
 
 # JSON output
+sem entities --json
 sem entities src/auth.ts --json
 ```
 
@@ -313,7 +341,7 @@ sem-core can be used as a Rust library dependency:
 
 ```toml
 [dependencies]
-sem-core = { git = "https://github.com/Ataraxy-Labs/sem", version = "0.3" }
+sem-core = { git = "https://github.com/Ataraxy-Labs/sem", version = "0.4" }
 ```
 
 Used by [weave](https://github.com/Ataraxy-Labs/weave) (semantic merge driver) and [inspect](https://github.com/Ataraxy-Labs/inspect) (entity-level code review).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ataraxy-labs/sem",
-  "version": "0.3.23",
+  "version": "0.4.0",
   "description": "npm wrapper for the sem CLI. Downloads the matching release binary and exposes the sem command in node_modules/.bin.",
   "license": "MIT OR Apache-2.0",
   "type": "module",