Skip to content

Semble

v0.3.0 Breaking

This release includes 4 breaking changes for platform teams planning a safe upgrade.

Published 7d MCP Developer Tools
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ 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 summary

Updates 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 from SembleIndex.from_path() and SembleIndex.from_git() in favor of .sembleignore.
  • model= was replaced by model_path=.
  • Encoder is no longer exported from semble.

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-files with --content all.
  • Replace include_text_files=True with content=[ContentType.CODE, ContentType.DOCS, ContentType.CONFIG].
  • Replace extensions= with content= for built-in file groups, or .sembleignore negation rules like !*.proto for custom extensions. See "Controlling which files are indexed" in the CLI section for more info.
  • Replace model= with model_path=, or set SEMBLE_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

Track Semble

Get notified when new releases ship.

Sign up free

About Semble

All releases →

Beta — feedback welcome: [email protected]