@nothumanwork/wit 0.1.17 → 0.1.18

package/README.md

@@ -64,13 +64,13 @@ cargo install --path .
 
 ```bash
 wit search -p 'ratatui' -l 'Rust'                        # Find repos
-wit tree ratatui/ratatui                                   # See structure
-wit ls -l ratatui/ratatui src                              # Browse with sizes
-wit rg -l 'impl Widget' ratatui/ratatui                    # Find files
-wit cat -n ratatui/ratatui src/lib.rs                      # Read a file
-wit head -n 30 ratatui/ratatui Cargo.toml                  # Preview a file
-wit sed -n '100,150p' ratatui/ratatui src/lib.rs           # Extract range
-wit rg 'TODO' ratatui/ratatui --ignore '.git' --ignore '*.png'  # Exclude paths
+wit tree -r ratatui/ratatui                                   # See structure
+wit ls -l -r ratatui/ratatui src                              # Browse with sizes
+wit rg -l 'impl Widget' -r ratatui/ratatui                    # Find files
+wit cat -n -r ratatui/ratatui src/lib.rs                      # Read a file
+wit head -n 30 -r ratatui/ratatui Cargo.toml                  # Preview a file
+wit sed -n -r ratatui/ratatui '100,150p' src/lib.rs           # Extract range
+wit rg 'TODO' -r ratatui/ratatui --ignore '.git' --ignore '*.png'  # Exclude paths
 ```
 
 ## Global Options
@@ -82,10 +82,10 @@ wit rg 'TODO' ratatui/ratatui --ignore '.git' --ignore '*.png'  # Exclude paths
 Ignore examples:
 
 ```bash
-wit tree ratatui/ratatui --ignore '.github' --ignore 'assets/**'
-wit ls ratatui/ratatui src --ignore 'generated'
-wit rg 'fn main' ratatui/ratatui --ignore '.git' --ignore '*.lock'
-wit cat ratatui/ratatui src/main.rs --ignore 'src/main.rs'   # blocked (explicitly ignored)
+wit tree -r ratatui/ratatui --ignore '.github' --ignore 'assets/**'
+wit ls -r ratatui/ratatui src --ignore 'generated'
+wit rg 'fn main' -r ratatui/ratatui --ignore '.git' --ignore '*.lock'
+wit cat -r ratatui/ratatui src/main.rs --ignore 'src/main.rs'   # blocked (explicitly ignored)
 ```
 
 `search` ignores `--ignore`, because repository discovery is done through GitHub's repository search API rather than cached file traversal.
@@ -113,44 +113,45 @@ wit search -p 'auth' -q 'user:ory language:Go pushed:>2025-01-01'
 
 ### cache (alias: c)
 
-Clone a repository into the local cache (or refresh an existing one). Repos are auto-cached on first use by other commands.
+Clone a repository into the local cache (or refresh an existing one). Pass the repository with `-r` / `--repo` (`owner/repo`). Repos are auto-cached on first use by other commands.
 
 ```bash
-wit cache ratatui/ratatui          # Force re-clone of ratatui
+wit cache -r ratatui/ratatui          # Force re-clone of ratatui
 ```
 
 ### tree (alias: t)
 
-Show the file tree of a repository (or subtree). Use `-l` for line counts and token estimates.
+Show the file tree of a repository (or subtree). Pass the repository with `-r` / `--repo` (`owner/repo`). Use `-l` for line counts and token estimates.
 
 ```bash
-wit tree ratatui/ratatui                # Full repo tree
-wit tree ratatui/ratatui src/widgets    # Only the widgets subtree
-wit tree -l ratatui/ratatui src         # With line counts and token estimates
+wit tree -r ratatui/ratatui                # Full repo tree
+wit tree -r ratatui/ratatui src/widgets    # Only the widgets subtree
+wit tree -l -r ratatui/ratatui src         # With line counts and token estimates
 ```
 
 ### ls
 
-List directory contents (non-recursive). Unlike `tree`, shows only immediate children. Use `-l` for file sizes.
+List directory contents (non-recursive). Unlike `tree`, shows only immediate children. Pass the repository with `-r` / `--repo` (`owner/repo`). Use `-l` for file sizes.
 
 ```bash
-wit ls ratatui/ratatui                    # List repo root
-wit ls ratatui/ratatui src/widgets        # List a subdirectory
-wit ls -l ratatui/ratatui src             # With line counts and token estimates
+wit ls -r ratatui/ratatui                    # List repo root
+wit ls -r ratatui/ratatui src/widgets        # List a subdirectory
+wit ls -l -r ratatui/ratatui src             # With line counts and token estimates
 ```
 
 ### cat
 
-Print a file's contents. For large files, prefer `head`/`tail`/`sed` to read specific ranges, or `rg` to search.
+Print a file's contents. Pass the repository with `-r` / `--repo` (`owner/repo`). For large files, prefer `head`/`tail`/`sed` to read specific ranges, or `rg` to search.
 
 ```bash
-wit cat ratatui/ratatui Cargo.toml             # Print file
-wit cat -n ratatui/ratatui src/lib.rs           # With line numbers
-wit cat -b ratatui/ratatui README.md            # Number non-blank lines only
+wit cat -r ratatui/ratatui Cargo.toml             # Print file
+wit cat -n -r ratatui/ratatui src/lib.rs           # With line numbers
+wit cat -b -r ratatui/ratatui README.md            # Number non-blank lines only
 ```
 
 | Flag | Long | Description |
 |------|------|-------------|
+| `-r` | `--repo` | GitHub repository (`owner/repo`) |
 | `-n` | `--number` | Number all output lines |
 | `-b` | `--number-nonblank` | Number non-blank lines only (overrides -n) |
 | `-s` | `--squeeze-blank` | Suppress repeated empty lines |
@@ -160,18 +161,19 @@ wit cat -b ratatui/ratatui README.md            # Number non-blank lines only
 
 ### rg
 
-Search file contents (ripgrep-style). Use `-l` to find files, `-g` to filter by type.
+Search file contents (ripgrep-style). Pass the repository with `-r` / `--repo` (`owner/repo`). Use `-l` to find files, `-g` to filter by type.
 
 ```bash
-wit rg 'impl Widget' ratatui/ratatui              # Find implementations
-wit rg -l 'struct.*Frame' ratatui/ratatui          # List files containing pattern
-wit rg -g '*.rs' -i 'todo' ratatui/ratatui         # Case-insensitive in .rs files
-wit rg -C 3 'fn render' ratatui/ratatui             # 3 lines of context
-wit rg -l --long 'Widget' ratatui/ratatui           # File list with line counts
+wit rg 'impl Widget' -r ratatui/ratatui              # Find implementations
+wit rg -l 'struct.*Frame' -r ratatui/ratatui          # List files containing pattern
+wit rg -g '*.rs' -i 'todo' -r ratatui/ratatui         # Case-insensitive in .rs files
+wit rg -C 3 'fn render' -r ratatui/ratatui             # 3 lines of context
+wit rg -l --long 'Widget' -r ratatui/ratatui           # File list with line counts
 ```
 
 | Flag | Long | Description |
 |------|------|-------------|
+| `-r` | `--repo` | GitHub repository (`owner/repo`) |
 | `-i` | `--ignore-case` | Case insensitive search |
 | `-S` | `--smart-case` | Case-insensitive if pattern is all lowercase |
 | `-w` | `--word-regexp` | Match whole words only |
@@ -187,38 +189,39 @@ wit rg -l --long 'Widget' ratatui/ratatui           # File list with line counts
 
 ### sed
 
-Extract or transform file content using sed scripts (POSIX-style, Rust regex).
+Extract or transform file content using sed scripts (POSIX-style, Rust regex). Pass the repository with `-r` / `--repo` (`owner/repo`).
 
 ```bash
-wit sed -n '320,460p' modal-labs/modal-client modal/image.py    # Print line range
-wit sed -n '/TODO/p' ratatui/ratatui src/lib.rs                 # Lines matching pattern
-wit sed 's/Widget/Component/g' ratatui/ratatui src/lib.rs       # Substitute text
-wit sed -n '/^pub fn/p' ratatui/ratatui src/lib.rs              # Extract function signatures
+wit sed -n -r modal-labs/modal-client '320,460p' modal/image.py    # Print line range
+wit sed -n -r ratatui/ratatui '/TODO/p' src/lib.rs                 # Lines matching pattern
+wit sed -r ratatui/ratatui 's/Widget/Component/g' src/lib.rs       # Substitute text
+wit sed -n -r ratatui/ratatui '/^pub fn/p' src/lib.rs              # Extract function signatures
 ```
 
 **Notes:**
+- Pass the repository with `-r` / `--repo` (`owner/repo`). Positional arguments are the sed script and the file path, or only the path when the script comes from `-e` / `-f`.
 - Regex uses Rust syntax (not POSIX BRE).
 - `sed` operates on a single repo file (no stdin or in-place edits).
 - Supports addresses, substitution, hold space, branching, and most POSIX commands.
 
 ### head
 
-Print the first N lines of a file (default: 10). Use to preview a file before deciding whether to read it fully.
+Print the first N lines of a file (default: 10). Pass the repository with `-r` / `--repo` (`owner/repo`). Use to preview a file before deciding whether to read it fully.
 
 ```bash
-wit head ratatui/ratatui src/lib.rs            # First 10 lines
-wit head -n 50 ratatui/ratatui Cargo.toml      # First 50 lines
-wit head -N ratatui/ratatui README.md           # With line numbers
+wit head -r ratatui/ratatui src/lib.rs            # First 10 lines
+wit head -n 50 -r ratatui/ratatui Cargo.toml      # First 50 lines
+wit head -N -r ratatui/ratatui README.md           # With line numbers
 ```
 
 ### tail
 
-Print the last N lines of a file, or from line N onward. Use `-p` to read from a specific line to end-of-file.
+Print the last N lines of a file, or from line N onward. Pass the repository with `-r` / `--repo` (`owner/repo`). Use `-p` to read from a specific line to end-of-file.
 
 ```bash
-wit tail ratatui/ratatui src/lib.rs              # Last 10 lines
-wit tail -n 20 ratatui/ratatui Cargo.toml        # Last 20 lines
-wit tail -p 100 ratatui/ratatui src/lib.rs       # From line 100 to end
+wit tail -r ratatui/ratatui src/lib.rs              # Last 10 lines
+wit tail -n 20 -r ratatui/ratatui Cargo.toml        # Last 20 lines
+wit tail -p 100 -r ratatui/ratatui src/lib.rs       # From line 100 to end
 ```
 
 ## Packaging & Release

package/dists/wit-checksums.txt

@@ -1,6 +1,6 @@
-d9d4a5542e4c25ae08626ef229b3d98a517fa68c589c2c84c054ec6d85326fd7  wit-linux-aarch64.tar.gz
-418ecdb63c68aac8b6acb147c26bb5c26de84d1a2f5b9b61132925706facf88e  wit-linux-x86_64.tar.gz
-fac9570a652a6f76dcef35bc75275a11600d1f1cbff923d60c5e173d4aeb33ea  wit-macos-aarch64.tar.gz
-90aa2a80f6293720d124b24be9cbfccafccb9dcb09da6fc6f630bc5060840179  wit-macos-x86_64.tar.gz
-c9200339d94c94e35ea47d4839bf80f22aecd4832845a233024bfe1c12407284  wit-windows-aarch64.zip
-9c74e5067eae8122ba9cf4b2a90e026b47b160c82b4c30a42081bbf6340e6b4f  wit-windows-x86_64.zip
+3a399a6e11d3d98a4cf643f95784a3dc4bc0550620a6783aad59fc420d8f3670  wit-linux-aarch64.tar.gz
+a4941c90b17523605d75f1e5985146542e58602fd3bb73c76b1a03f109f42f40  wit-linux-x86_64.tar.gz
+c8709c7af64d91397d495e59e5f74034cb2896e0ec20ab07f211b4ef1286f87e  wit-macos-aarch64.tar.gz
+e618b007eea0a21c3a6566cbf09f4aeb8cedae3d4804a10ac13f5c26ee397ed6  wit-macos-x86_64.tar.gz
+99acd626091d1f15bf318ac0b5e423f9162415ebe2b96ee8ce13ed98ddc17987  wit-windows-aarch64.zip
+87515be2a1da63b8d1e68467f43ae53f8c960cc726653e4cf0fc409fbc21e096  wit-windows-x86_64.zip

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nothumanwork/wit",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "GitHub exploration CLI for AI agents",
   "license": "UNLICENSED",
   "repository": {