Skip to content

Commit 655bd95

Browse files
committed
Remove outdated embedding/semantic search references
Search is BM25-only (via Tantivy). Local embedding models and the cas models CLI were removed previously. Updated docs to reflect current state.
1 parent 0870a20 commit 655bd95

2 files changed

Lines changed: 4 additions & 92 deletions

File tree

CLAUDE.md

Lines changed: 1 addition & 77 deletions
Original file line numberDiff line numberDiff line change
@@ -54,8 +54,7 @@ crates/ # Workspace crates (cas-core, cas-store, cas-search, etc.)
5454
|-----------|---------|
5555
| `src/types/` | Core data: Entry, Task, Rule, Skill |
5656
| `src/store/` | Storage abstraction (SqliteStore primary) |
57-
| `src/search/` | BM25 + semantic hybrid search |
58-
| `src/embedding/` | Qwen3 embeddings via Candle |
57+
| `src/search/` | Full-text search (BM25 via Tantivy) |
5958
| `src/cli/` | Command handlers |
6059
| `src/hooks/` | Claude Code integration |
6160

@@ -199,81 +198,6 @@ Patterns:
199198
- `Bash(cas task:*)` - Allow task operations only
200199
- `Bash(:* --help)` - Allow help for any command
201200

202-
## Embedding Model Configuration
203-
204-
CAS supports configurable embedding models for semantic search. Models can be local (downloaded) or API-based.
205-
206-
### Available Models
207-
208-
| Model | Dimension | Type | Provider |
209-
|-------|-----------|------|----------|
210-
| `Qwen/Qwen3-Embedding-0.6B` | 1024 | Local | Default |
211-
| `BAAI/bge-small-en-v1.5` | 384 | Local | Lightweight |
212-
| `BAAI/bge-base-en-v1.5` | 768 | Local | Balanced |
213-
| `sentence-transformers/all-MiniLM-L6-v2` | 384 | Local | Fast |
214-
| `text-embedding-3-small` | 1536 | API | OpenAI |
215-
| `text-embedding-3-large` | 3072 | API | OpenAI |
216-
| `voyage-3` | 1024 | API | Voyage |
217-
218-
### Model Commands (Human CLI)
219-
220-
```bash
221-
# List available models
222-
cas models list # All models
223-
cas models list --local # Local models only
224-
cas models list --api # API models only
225-
cas models list --embedding # Embedding models only
226-
cas models list --reranker # Reranker models only
227-
228-
# View current configuration
229-
cas models info
230-
231-
# Set embedding model
232-
cas models set BAAI/bge-small-en-v1.5
233-
234-
# Set reranker model
235-
cas models set Qwen/Qwen3-Reranker-0.6B --reranker
236-
237-
# Check download status
238-
cas models status
239-
240-
# Download models
241-
cas models download # Embedding model
242-
cas models download --all # Both embedding and reranker
243-
244-
# Migrate embeddings after model change
245-
cas models migrate # Preview
246-
cas models migrate --confirm # Execute
247-
```
248-
249-
### Configuration
250-
251-
Model settings are stored in `.cas/config.yaml`:
252-
253-
```yaml
254-
embedding:
255-
model: "Qwen/Qwen3-Embedding-0.6B" # Embedding model ID
256-
reranker: "Qwen/Qwen3-Reranker-0.6B" # Optional reranker
257-
```
258-
259-
### API Models
260-
261-
For OpenAI or Voyage models, set environment variables:
262-
- `OPENAI_API_KEY` for OpenAI models
263-
- `VOYAGE_API_KEY` for Voyage models
264-
265-
### Migration
266-
267-
When changing to a model with different dimensions, existing embeddings must be regenerated:
268-
269-
```bash
270-
# Set new model
271-
cas models set text-embedding-3-small
272-
273-
# Migrate (regenerates all embeddings)
274-
cas models migrate --confirm
275-
```
276-
277201
## Code Search with ast-grep
278202

279203
Use `ast-grep` for syntax-aware structural matching instead of text-only tools like `rg` or `grep`. This is especially useful for finding code patterns, refactoring, and understanding structure.

README.md

Lines changed: 3 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ CAS is a local-first context system that gives AI agents persistent memory acros
3737
| **Tasks** | Track work with dependencies, priorities, and structured progress notes |
3838
| **Rules** | Coding conventions that earn trust through use and auto-sync to your editor |
3939
| **Skills** | Reusable agent capabilities with templates and usage tracking |
40-
| **Search** | Hybrid BM25 + semantic retrieval across all stored context |
40+
| **Search** | Fast full-text search (BM25) across all stored context |
4141
| **Factory** | Multi-agent orchestration — supervisor + workers in parallel git worktrees |
4242

4343
## Quick Start
@@ -198,7 +198,7 @@ CAS stores all data locally in your project:
198198
| `cas-cli` | CLI binary and MCP server |
199199
| `cas-core` | Core logic, hooks, and integrations |
200200
| `cas-store` | SQLite storage layer |
201-
| `cas-search` | BM25 + semantic hybrid search |
201+
| `cas-search` | Full-text search (BM25 via Tantivy) |
202202
| `cas-mcp` | MCP protocol handlers |
203203
| `cas-types` | Shared data types |
204204
| `cas-factory` | Multi-agent orchestration TUI |
@@ -210,26 +210,14 @@ CAS stores all data locally in your project:
210210
- **Rust** for performance and reliability
211211
- **SQLite** for local-first storage
212212
- **Tantivy** for full-text search (BM25)
213-
- **Qwen3 embeddings** for semantic search (runs locally)
214213
- **rmcp** for MCP protocol support
215214
- **Ratatui** for the factory TUI
216215

217216
## Configuration
218217

219-
```yaml
220-
# .cas/config.yaml
221-
embedding:
222-
model: "Qwen/Qwen3-Embedding-0.6B" # Local embedding model
223-
reranker: "Qwen/Qwen3-Reranker-0.6B" # Optional reranker
224-
```
218+
CAS is configured via `.cas/config.yaml` in your project root. Run `cas config list` to see all options or `cas config describe <key>` for details on any setting.
225219

226220
```bash
227-
# List available embedding models
228-
cas models list
229-
230-
# Switch models
231-
cas models set BAAI/bge-small-en-v1.5
232-
233221
# Self-update
234222
cas update
235223
```

0 commit comments

Comments
 (0)