Orbit 0.2.2
Agents can now search your codebase by meaning, not just by keywords. Turn it on in Settings β Tools β Semantic Codebase Search, point it at a local embedding model (Ollama with nomic-embed-text, forβ¦
π Semantic Codebase Search
Agents can now search your codebase by meaning, not just by keywords. Turn it on in Settings β Tools β Semantic Codebase Search, point it at a local embedding model (Ollama with nomic-embed-text, for instance), and Orbit builds a private per-workspace index of your source code. Once indexed, the agent's CodebaseSearch tool finds relevant files, functions, and patterns from a natural-language description β no need to know the exact identifier or grep for the right string.
- Works locally and privately. Use Ollama on the same machine and all indexing stays on your hardware. OpenAI-compatible endpoints (OpenAI, vLLM, etc.) are also supported if you prefer a remote model; data is sent to whichever provider you configure.
- Agents use it automatically. When the agent needs to find a concept, architecture pattern, or implementation detail (
CodebaseSearch), it falls back toGreporGlobfor exact searches andReadfor digging into results. - Fast incremental updates. After the initial index, Orbit watches your files and re-indexes only the changed ones in the background β saves, creates, deletes, and renames all update the index within about a second.
- Control what gets indexed. Orbit respects your existing search exclusions and
.gitignorepatterns. Add a.orbitignorefile at the workspace root for indexing-specific exclusions:
private/
fixtures/generated/**
*.generated.ts
- Resilient to interruptions. If the embedding provider goes down mid-index, the last valid index is preserved and agents fall back to
Grep,Glob, andReadwith a graceful message β no hard-failing tools. - Index state visible in Settings. An in-settings status panel shows the indexing phase (scanning / embedding / saving), file progress, the current file being processed, and a summary of indexed files and chunks once ready.
Note: Semantic indexing is disabled by default and requires a trusted workspace. Enable it in Settings β Tools β Semantic Codebase Search, then configure an embedding endpoint and model.
Bug fixes
- Fixed a bug where toggling semantic search off and back on would re-embed the entire codebase instead of reusing the cached index from disk.
- Fixed a bug where changing the embedding model/provider while search was enabled could produce an index with vectors from two different models, making rankings meaningless.
- Fixed an indexing progress counter inaccuracy for files larger than the 512 KiB size limit.
macOS install
- Recommended (no Gatekeeper warning):
curl -fsSL https://raw.githubusercontent.com/ashish200729/orbiteditor/main/install.sh | bash
- Or download the
.dmgfrom the release, drag Orbit to Applications, then run once:
xattr -cr /Applications/Orbit.app
(Orbit isn't notarized by Apple yet, so a browser-downloaded .dmg shows a one-time "unverified developer" prompt; the command above clears it.)
