This release includes 4 breaking changes for platform teams planning a safe upgrade.
Published 7d
MCP Developer Tools
✓ No known CVEs patched
✓ No known CVEs patched in this version
Topics
agents
code-search
embeddings
mcp
mcp-server
model-context-protocol
+1 more
retrieval
Affected surfaces
breaking_upgrade
Summary
AI summaryUpdates Breaking changes 🚨, Migration notes, and feat across a mixed release.
Full changelog
What's Changed
- feat: Add --content flag for docs, config, and code search by @Pringled in https://github.com/MinishLab/semble/pull/142
- feat: add index persistence by @stephantul in https://github.com/MinishLab/semble/pull/140
- feat: add JSON output by @stephantul in https://github.com/MinishLab/semble/pull/147
- chore: Add pull request template, update contributing guidelines, update docs by @Pringled in https://github.com/MinishLab/semble/pull/157
- chore: Update email by @Pringled in https://github.com/MinishLab/semble/pull/158
- feat: Auto-indexing in cache folder. by @stephantul in https://github.com/MinishLab/semble/pull/162
Breaking changes 🚨
- CLI and MCP results are now JSON instead of formatted text.
extensions=was removed fromSembleIndex.from_path()andSembleIndex.from_git()in favor of.sembleignore.model=was replaced bymodel_path=.Encoderis no longer exported fromsemble.
Deprecation warnings ⚠️
--include-text-files and include_text_files= are deprecated and will be removed in a future release. --content now controls this.
Migration notes
- Replace
--include-text-fileswith--content all. - Replace
include_text_files=Truewithcontent=[ContentType.CODE, ContentType.DOCS, ContentType.CONFIG]. - Replace
extensions=withcontent=for built-in file groups, or.sembleignorenegation rules like!*.protofor custom extensions. See "Controlling which files are indexed" in the CLI section for more info. - Replace
model=withmodel_path=, or setSEMBLE_MODEL_NAME. - If you parse CLI output, update scripts to parse JSON.
Full Changelog: https://github.com/MinishLab/semble/compare/v0.2.0...v0.3.0
Breaking Changes
- CLI and MCP results are now JSON instead of formatted text.
- `extensions=` removed from `SembleIndex.from_path()` and `SembleIndex.from_git()`; use `.sembleignore` for custom extensions.
- `model=` replaced by `model_path=`, or set env var `SEMBLE_MODEL_NAME`.
- `Encoder` is no longer exported from the `semble` module.
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About Semble
All releases →Related context
Beta — feedback welcome: [email protected]