v0.2.0 — Workspace & RAG

What's New

Workspace Management

Organize Zotero items by research topic with local workspaces — no Zotero API needed.

• zot workspace new <name> — create workspace with optional description
• zot workspace add <name> KEY... — add items (validates against Zotero DB)
• zot workspace remove <name> KEY... — remove items
• zot workspace show <name> — display items with full metadata
• zot workspace list — list all workspaces
• zot workspace delete <name> — delete workspace

Workspace RAG (Retrieval-Augmented Search)

Built-in lightweight RAG over workspace papers — zero new dependencies.

• zot workspace index <name> — build BM25 index from metadata + PDF fulltext
• zot workspace query "question" --workspace <name> — natural language search
• BM25 keyword search always available (pure Python, no new deps)
• Optional semantic search via external embedding API (Jina AI default, 10M free tokens)
• Hybrid mode fuses BM25 + semantic via reciprocal rank fusion
• PDF converted to Markdown via pymupdf4llm (if installed) for better chunking

Configuration

# Optional: enable semantic search
export ZOT_EMBEDDING_URL="https://api.jina.ai/v1/embeddings"
export ZOT_EMBEDDING_KEY="your-key"

Full Changelog

• feat: workspace command group (new, delete, add, remove, list, show)
• feat: RAG engine with BM25, chunking, embedding client, hybrid fusion
• feat: EmbeddingConfig with Jina defaults and env overrides
• docs: SKILL.md v0.5.0 with workspace docs, removed rak section