Repository navigation
v3.0.0 — Modernization release
Highlights
- Pgvector by default. PostgreSQL with the
pgvectorextension is the default vector backend, replacing embedded Qdrant. Native full-text search viatsvector+ GIN replaces in-process BM25. The legacy embedded Qdrant backend remains as an opt-in fallback (RAGBOT_VECTOR_BACKEND=qdrant). - Agent Skills as first-class content. Discover and index Agent Skills (
SKILL.mdplus references and scripts) from~/.synthesis/skills,~/.claude/skills, and plugin caches. Newragbot skills {list,info,index}CLI. The compiler can include skills via asources.skillsblock incompile-config.yaml. - Workspace-rooted layout. AI Knowledge repos are discovered across
~/workspaces/*/ai-knowledge-*and via the synthesis-engineering shared~/.synthesis/console.yamlsource list. Configuration moved to~/.synthesis/(legacy~/.config/ragbot/falls through). - Reasoning / thinking modes. Models that advertise thinking support (Claude Sonnet 4.6, Claude Opus 4.7, GPT-5.5, GPT-5.5-pro, Gemini 3.x) are wired through LiteLLM's
reasoning_effort. Flagship models default tomedium; override per-call (--thinking-effort high) or globally (RAGBOT_THINKING_EFFORT). - Cross-workspace retrieval.
get_relevant_contextauto-merges results from the user's selected workspace and the canonicalskillsworkspace via reciprocal rank fusion. Disable with--no-skills.
API additions
/api/chatacceptsthinking_effortandadditional_workspacesfields./api/configand/healthreport the activevector_backend(backend name, health, version, workspaces count).
Models (engines.yaml)
- Anthropic: Haiku 4.5, Sonnet 4.6 (default), Opus 4.7.
- OpenAI: GPT-5.4-mini, GPT-5.5, GPT-5.5-pro (flagship).
- Google: Gemini 3.1 Flash Lite, Gemini 3 Flash (default), Gemini 3.1 Pro (flagship).
Dependency notes
litellmpinned>=1.83.0(post-supply-chain-incident range; avoid 1.82.7-1.82.8).- Direct
google-generativeaiusage migrated togoogle-genai(the legacy SDK is end-of-life). - 259 tests pass on the release SHA.
Breaking changes
- Vector backend default flipped to pgvector. Existing Qdrant users can opt back in with
RAGBOT_VECTOR_BACKEND=qdrant. Postgres + pgvector is required for the default path; seeCONFIGURE.md. - Configuration home moved to
~/.synthesis/. Legacy~/.config/ragbot/{keys,config}.yamlis read as a fallback.
Setup
See README.md, CONFIGURE.md, and README-DOCKER.md for setup instructions.