Release v0.1.3: CLI embedding configuration

New Features:
- CLI embedding provider selection via --embedder flag
- Support for mock, hf, openai, cohere, voyage providers
- --model flag for specifying embedding model
- --dimension flag for API embedders
- Automatic embedder initialization based on CLI flags

Documentation:
- CLI_EMBEDDINGS.md with complete usage guide
- Quick start examples for all providers
- Environment variable requirements
- Updated CHANGELOG.md

Examples:
  indra --embedder hf create "thought"
  indra --embedder openai --model text-embedding-3-small create "thought"
  indra --embedder voyage --model voyage-code-3 create "code"

Author: moonstripe

CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.3] - 2026-02-05
+
+### Added
+- **CLI Embedding Configuration**: New flags for choosing embedding providers
+  - `--embedder`: Choose provider (mock, hf, openai, cohere, voyage)
+  - `--model`: Specify model name for the embedder
+  - `--dimension`: Set embedding dimension (required for API providers)
+  - Examples: `indra --embedder hf create "thought"`, `indra --embedder openai --model text-embedding-3-small create "thought"`
+  
+- **Documentation**: `CLI_EMBEDDINGS.md` with complete CLI embedding guide
+  - Quick start examples for all providers
+  - Environment variable requirements
+  - Consistency guidelines
+  - Troubleshooting tips
+
+### Changed
+- Updated `open_db()` function to accept embedder configuration parameters
+- All CLI commands now support embedder selection
+
 ## [0.1.2] - 2026-02-05
 
 ### Added
@@ -75,6 +94,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Graph traversal operations (neighbors, BFS, shortest path)
 - Complete test suite (54 tests)
 
+[0.1.3]: https://github.com/moonstripe/indra_db/compare/v0.1.2...v0.1.3
 [0.1.2]: https://github.com/moonstripe/indra_db/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/moonstripe/indra_db/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/moonstripe/indra_db/releases/tag/v0.1.0

CLI_EMBEDDINGS.md

@@ -0,0 +1,109 @@
+# CLI Embedding Configuration
+
+The `indra` CLI supports multiple embedding providers via command-line flags.
+
+## Quick Start
+
+```bash
+# Default (MockEmbedder)
+indra create "My thought"
+
+# HuggingFace local model
+indra --embedder hf create "My thought"
+
+# OpenAI API
+indra --embedder openai create "My thought"
+
+# Custom model
+indra --embedder hf --model sentence-transformers/all-mpnet-base-v2 create "Better embeddings"
+```
+
+## Options
+
+### `--embedder <PROVIDER>`
+
+Choose embedding provider (default: `mock`):
+- `mock` - Fast, deterministic, no dependencies
+- `hf` - Local HuggingFace models (requires `--features hf-embeddings`)
+- `openai` - OpenAI API (requires `--features api-embeddings`)
+- `cohere` - Cohere API (requires `--features api-embeddings`)
+- `voyage` - Voyage AI API (requires `--features api-embeddings`)
+
+### `--model <MODEL>`
+
+Model name for the embedder:
+- **HF**: `sentence-transformers/all-MiniLM-L6-v2` (default)
+- **OpenAI**: `text-embedding-3-small` (default), `text-embedding-3-large`
+- **Cohere**: `embed-english-v3.0` (default)
+- **Voyage**: `voyage-3` (default), `voyage-code-3`
+
+### `--dimension <DIM>`
+
+Embedding dimension (required for API embedders):
+- OpenAI: 1536 (small), 3072 (large)
+- Cohere: 1024
+- Voyage: 1024
+
+## Examples
+
+### MockEmbedder (Default)
+```bash
+indra init
+indra create "Test thought"
+```
+
+### HuggingFace Local
+```bash
+# Requires: cargo install indra_db --features hf-embeddings
+indra --embedder hf create "Rust is fast"
+indra --embedder hf search "programming" -l 5
+```
+
+### OpenAI
+```bash
+# Requires: 
+#   cargo install indra_db --features api-embeddings
+#   export OPENAI_API_KEY=sk-...
+
+indra --embedder openai create "AI memory"
+indra --embedder openai --model text-embedding-3-large --dimension 3072 create "High quality"
+```
+
+### Cohere
+```bash
+# Requires: export COHERE_API_KEY=...
+indra --embedder cohere create "Multilingual text"
+```
+
+### Voyage AI
+```bash
+# Requires: export VOYAGE_API_KEY=...
+indra --embedder voyage create "General text"
+indra --embedder voyage --model voyage-code-3 create "function main() {}"
+```
+
+## Environment Variables
+
+- `HF_HOME` - HuggingFace cache directory
+- `HF_TOKEN` - HuggingFace API token
+- `OPENAI_API_KEY` - OpenAI API key
+- `COHERE_API_KEY` - Cohere API key
+- `VOYAGE_API_KEY` - Voyage AI API key
+
+## Consistency
+
+**Important:** Use the same embedder for all operations on a database:
+
+```bash
+# ✅ Good
+indra -d db.indra --embedder hf init
+indra -d db.indra --embedder hf create "thought"
+
+# ❌ Bad - dimension mismatch
+indra -d db.indra --embedder hf init       # 384 dim
+indra -d db.indra --embedder openai create # 1536 dim
+```
+
+## Complete Documentation
+
+See [EMBEDDINGS.md](EMBEDDINGS.md) for full embedding documentation.

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "indra_db"
-version = "0.1.2"
+version = "0.1.3"
 edition = "2021"
 description = "A content-addressed graph database for versioned thoughts"
 license = "MIT"