zift
- Repo stars 39
- Author repo awesome-omni-skill
- Domain
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @diegosouzapw · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# zift Skill
`zift` is a high-performance, local-first code search tool that combines semantic (vector) and lexical (FTS5) search.
## Core Search Modes
### 1. Semantic / Hybrid (Default)
Uses natural language to find code by "meaning" or "intent".
```bash
zift "how do I handle database connections" .
```
*Best for: High-level architectural questions, finding unfamiliar logic.*
### 2. Exact Match (`-e`, `--exact`)
Performs a literal, byte-perfect substring search.
```bash
zift -e "SearchResult { file_path" .
```
*Best for: Finding specific variable names, error strings, or boilerplate.*
### 3. Regex Search (`-r`, `--regex`)
Uses Rust-powered regular expressions for pattern matching.
```bash
zift -r "pub (async )?fn" .
```
*Best for: Finding all instances of a pattern (e.g., all public functions).*
## Workflow
### Indexing
Before searching, you must index the project. `zift` uses incremental indexing and will auto-refresh stale files on query, but a full initial index is recommended:
```bash
zift add .
```
### Filtering
Use the `-l` or `--local` flag to restrict results to the current working directory (useful in monorepos).
```bash
zift "auth logic" . --local
```
## Architecture & Performance
- **Local-first**: All embeddings and indices stay on your machine (`~/.cache/zift`).
- **GPU Accelerated**: Uses Metal/GPU for embedding generation via `llama-cpp-2`.
- **Hybrid RRF**: Fuses semantic and lexical results using Reciprocal Rank Fusion (k=60) with Power-Law scaling (γ=2.5) for intuitive percentages.
- **Speed**: Exact and Regex searches skip the embedding phase and are near-instant (<50ms).
## Troubleshooting
- **Stale Index**: If results seem old, run `zift add .` again or `zift forget .` to reset.
- **Model Issues**: `zift` defaults to `nomic-embed-text-v1.5`. Ensure the model is downloaded to the cache directory.
Sections and files
Listed in source order.
sections -> Core Search Modes → 1. Semantic / Hybrid (Default) → 2. Exact Match (-e, --exact) → 3. Regex Search (-r, --regex) → Workflow → Indexing
terms -> Local-first · GPU Accelerated · Hybrid RRF · Speed · Stale Index · Model Issues
files/cmd -> zift · --exact · --regex · --local · ~/.cache/zift · llama-cpp-2 · zift add . · zift forget .
body sha256 -> f9b3d563301f
1. Semantic / Hybrid (Default)
Uses natural language to find code by "meaning" or "intent". Best for: High-level architectural questions, finding unfamiliar logic.
2. Exact Match (-e, --exact)
Performs a literal, byte-perfect substring search. Best for: Finding specific variable names, error strings, or boilerplate.
3. Regex Search (-r, --regex)
Uses Rust-powered regular expressions for pattern matching. Best for: Finding all instances of a pattern (e.g., all public functions).
Indexing
Before searching, you must index the project.
ziftuses incremental indexing and will auto-refresh stale files on query, but a full initial index is recommended:Filtering
Use the
-lor--localflag to restrict results to the current working directory (useful in monorepos).