@vera-ai/cli 1.0.1 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -7
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# @vera-ai/cli
|
|
2
2
|
|
|
3
|
-
Code search for AI agents. Vera indexes your codebase using tree-sitter parsing and hybrid search (BM25 + vector similarity + cross-encoder reranking), then returns ranked code snippets as
|
|
3
|
+
Code search for AI agents. Vera indexes your codebase using tree-sitter parsing and hybrid search (BM25 + vector similarity + optional cross-encoder reranking), then returns ranked code snippets as Markdown codeblocks by default, or JSON with `--json`.
|
|
4
4
|
|
|
5
5
|
This package downloads and wraps the native Vera binary for your platform. On musl-based Linux (Alpine, NixOS), the correct static binary is selected automatically. Set `VERA_TARGET` to override target detection (e.g., `VERA_TARGET=x86_64-unknown-linux-musl npm install -g @vera-ai/cli`).
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
The default local embedding model is `minishlab/potion-code-16M-v2`. It runs locally on CPU on any supported machine; no GPU or ONNX Runtime needed. In the 2026-08-23 Semble comparison, Vera scored `0.8447` nDCG@10 versus Semble 0.5.5 at `0.8514`, using the same embeddings, harness, graded relevance, and suffix-corrected path matching. Full details live in the main repo docs.
|
|
8
8
|
|
|
9
9
|
## Install
|
|
10
10
|
|
|
@@ -15,19 +15,18 @@ npm install -g @vera-ai/cli
|
|
|
15
15
|
## Quick Start
|
|
16
16
|
|
|
17
17
|
```bash
|
|
18
|
-
vera setup --potion-code
|
|
19
|
-
vera index .
|
|
18
|
+
vera setup --potion-code --index .
|
|
20
19
|
vera search "authentication logic"
|
|
21
20
|
```
|
|
22
21
|
|
|
23
|
-
`vera setup` with no flags runs an interactive wizard. `vera setup --api` prompts for an OpenAI-compatible endpoint and key; use `--yes` with `EMBEDDING_MODEL_*` variables for non-interactive setup. `vera agent install` manages skill files for your coding agents and can update `AGENTS.md` / `CLAUDE.md` style project instructions.
|
|
22
|
+
`vera setup` with no flags runs an interactive wizard and offers to index the current project, defaulting to yes. An interactive search also offers to create a missing index. `vera setup --api` prompts for an OpenAI-compatible endpoint and key; use `--yes` with `EMBEDDING_MODEL_*` variables for non-interactive setup. `vera agent install` manages skill files for your coding agents and can update `AGENTS.md` / `CLAUDE.md` style project instructions.
|
|
24
23
|
|
|
25
24
|
## Common Tasks
|
|
26
25
|
|
|
27
26
|
| Task | Command |
|
|
28
27
|
|------|---------|
|
|
29
28
|
| Use the interactive setup wizard | `vera setup` |
|
|
30
|
-
| Use
|
|
29
|
+
| Use the default local model | `vera setup --potion-code` |
|
|
31
30
|
| Configure API mode | `vera setup --api` |
|
|
32
31
|
| Use a local NVIDIA backend | `vera setup --onnx-jina-cuda` |
|
|
33
32
|
| Search semantically | `vera search "authentication middleware"` |
|
|
@@ -51,7 +50,7 @@ For the full backend matrix, model options, Docker setup, and troubleshooting, s
|
|
|
51
50
|
|
|
52
51
|
- **61+ languages** via tree-sitter AST parsing
|
|
53
52
|
- **Hybrid search**: BM25 keyword + vector similarity, fused with Reciprocal Rank Fusion
|
|
54
|
-
- **
|
|
53
|
+
- **Opt-in cross-encoder reranking** for precision, disabled by default
|
|
55
54
|
- **Git-aware scopes and index debugging**: `--changed` / `--since` / `--base`, `explain-path`, and index health in `vera stats`
|
|
56
55
|
- **Markdown codeblock output** by default with file paths, line ranges, and optional symbol info (use `--json` for compact JSON; `--raw` works with `vera search`, `vera grep`, and `vera references`; `--timing` works with `vera search` and `vera grep`, before or after the subcommand)
|
|
57
56
|
|