What's Changed

• feat: Add Codex subagent support by @Pringled in #207
• feat: make repo mandatory, remove default source & ref by @stephantul in #208
• fix: Validate cached MCP indexes on query by @Pringled in #211

Full Changelog: v0.4.0...v0.4.1

What's Changed

• feat: Optimize MCP and AGENTS.md instructions, add snippet_lines by @Pringled in #198
• fix: correctly read cache metadata as UTF-8 by @Pililink in #203
• chore: Bump version by @Pringled in #205
• fix: Ensure savings are correct when max_snippet_lines is used by @Pringled in #206

New Contributors

• @Pililink made their first contribution in #203

Migration notes

• For CLI/sub-agent users: this release features optimizations to the Semble prompts and MCP instructions that further improve performance and reduce costs. We recommend running semble install after upgrading. The MCP instructions are automatically updated when installing the latest version.

Full Changelog: v0.3.4...v0.4.0

What's Changed

• feat: add Command Code agent support by @hubaibmahmood in #192
• feat: Add antigravity support by @Pringled in #196
• fix: Prevent concurrent write corruption in savings.jsonl by @Pringled in #195
• feat: Make savings output prettier by @Pringled in #197

New Contributors

• @hubaibmahmood made their first contribution in #192

Full Changelog: v0.3.3...v0.3.4

What's Changed

• docs: add information about index storage in cache folder by @stephantul in #179
• fix: disallow relative paths in user-supplied cache dir by @stephantul in #182
• chore: make functions public, remove callable paths by @stephantul in #180
• feat: add clear command to clear indices by @stephantul in #181
• feat: Add reasonix and pi support by @Pringled in #183

Full Changelog: v0.3.2...v0.3.3

What's Changed

• feat: support cache location overrides (#177) by @ciaranj in #178
• feat: Add semble install by @Pringled in #176

Deprecation warnings ⚠️

• semble init is deprecated in favor of semble install

New Contributors

• @ciaranj made their first contribution in #178

Full Changelog: v0.3.1...v0.3.2

What's Changed

• docs: Update docs, add acknowledgements by @Pringled in #164
• fix: mismatch in roundtrip by @stephantul in #168

Full Changelog: v0.3.0...v0.3.1

What's Changed

• feat: Add --content flag for docs, config, and code search by @Pringled in #142
• feat: add index persistence by @stephantul in #140
• feat: add JSON output by @stephantul in #147
• chore: Add pull request template, update contributing guidelines, update docs by @Pringled in #157
• chore: Update email by @Pringled in #158
• feat: Auto-indexing in cache folder. by @stephantul in #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: v0.2.0...v0.3.0

What's Changed

• feat: check depth and chunk bounds to prevent recursion errors by @stephantul in #122
• feat: remove mode argument from Semble by @stephantul in #119
• chore: upper pin tree sitter by @stephantul in #129
• fix: Add agent-specific init files by @Pringled in #132
• chore: pin actions by @stephantul in #134
• feat: Make model loading non-blocking in MCP serve by @Pringled in #136

Deprecation warnings ⚠️

• mode is no longer supported in search as of #119. Search behavior can still be controlled by enabling/disabling reranking with the rerank argument, and by setting the alpha value to use more semantic vs lexical search, though the recommended use is to not touch this and rely on the defaults which are tuned for code search.

Full Changelog: v0.1.10...v0.2.0

What's Changed

• feat: Support more subagents via semble init, add more installation docs by @Pringled in #118

Full Changelog: v0.1.9...v0.1.10

What's Changed

• feat: fall back to line chunking when parsing unavailable by @stephantul in #115
• chore: bump version by @stephantul in #116

Full Changelog: v0.1.8...v0.1.9