cortex-vec
Vector store CLI for the cortex knowledge vault — hybrid retrieval over a plain-markdown vault, fusing a persistent BM25 index with OpenAI-embedding vector search (ChromaDB) via Reciprocal Rank Fusion. Handles mixed Chinese/English content.
The vault is the source of truth (markdown + git); everything this tool builds is a rebuildable derived index.
Install
# Recommended: isolated tool install via uv
uv tool install cortex-vec
# Or with pip
pip install cortex-vec
Usage
cortex-vec rebuild # full rebuild (embeddings, needs OPENAI_API_KEY)
cortex-vec rebuild --bm25-only # rebuild just the BM25 index — free, no API key
cortex-vec search "nginx certificate" --n 5
cortex-vec status # index health: vector + BM25 entry counts
Configuration lives in ~/.cortex/config.json (created by the cortex
plugin's /cortex:genesis command). OPENAI_API_KEY is required for
embeddings; without it, search automatically degrades to BM25-only.
This package is the retrieval backend of the Cortex Claude Code plugin — session recording, memory distillation, and indexed retrieval for Claude Code. See the repository for the full documentation.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cortex_vec-0.7.0.tar.gz.
File metadata
- Download URL: cortex_vec-0.7.0.tar.gz
- Upload date:
- Size: 68.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6e764bcf1f9902db5b8e5c900a5747d786d677bfd711ad2995ddff91883b881a
|
|
| MD5 |
26207f2cebb96cee65b3dd0cfbf60d2b
|
|
| BLAKE2b-256 |
88c9e31f884eba977425e874276b855c6a27e53e4a8be9adcc66ac2dd24ddca9
|
Provenance
The following attestation bundles were made for cortex_vec-0.7.0.tar.gz:
Publisher:
publish-cortex-vec.yml on XBlueSky/cortexes
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cortex_vec-0.7.0.tar.gz -
Subject digest:
6e764bcf1f9902db5b8e5c900a5747d786d677bfd711ad2995ddff91883b881a - Sigstore transparency entry: 2354372878
- Sigstore integration time:
-
Permalink:
XBlueSky/cortexes@ec788273b66f309077b09e599ae1f8106d5211b1 -
Branch / Tag:
refs/tags/cortex-vec-v0.7.0 - Owner: https://github.com/XBlueSky
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-cortex-vec.yml@ec788273b66f309077b09e599ae1f8106d5211b1 -
Trigger Event:
push
-
Statement type:
File details
Details for the file cortex_vec-0.7.0-py3-none-any.whl.
File metadata
- Download URL: cortex_vec-0.7.0-py3-none-any.whl
- Upload date:
- Size: 53.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
675f5ea6544af5167f0580198428652ed5d0fcb9f83150741e766c370328f872
|
|
| MD5 |
2c3196eb2b8b99c3ab5560950085fe6a
|
|
| BLAKE2b-256 |
afca833b17400d7d69b7223aeaa7744fdb930eebf9e33e936f87ef42fc2e68b4
|
Provenance
The following attestation bundles were made for cortex_vec-0.7.0-py3-none-any.whl:
Publisher:
publish-cortex-vec.yml on XBlueSky/cortexes
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cortex_vec-0.7.0-py3-none-any.whl -
Subject digest:
675f5ea6544af5167f0580198428652ed5d0fcb9f83150741e766c370328f872 - Sigstore transparency entry: 2354372947
- Sigstore integration time:
-
Permalink:
XBlueSky/cortexes@ec788273b66f309077b09e599ae1f8106d5211b1 -
Branch / Tag:
refs/tags/cortex-vec-v0.7.0 - Owner: https://github.com/XBlueSky
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-cortex-vec.yml@ec788273b66f309077b09e599ae1f8106d5211b1 -
Trigger Event:
push
-
Statement type:
