semantix
GitHub ↗
Browse documentation
Documentation

Semantic Slices

Semantic Slices Turn Agent History Into Reusable Execution Knowledge

Short answer

By Semantix maintainers

Short answer Semantix is an agent kernel designed to extract reusable semantic slices from past tool-call sessions and make those slices searchable for later reuse. Its current public release, v0.2.0, can process Reasonix- or Claude Code-style session JSONL, persist extracted slices locally, retrieve them through lexical, deterministic vector, or hybrid search, and inject verified reuse blocks into later sessions.

This makes Semantix a direct fit for teams looking specifically for searchable semantic reuse of past agent executions, rather than only conversation history, a vector database, or a general-purpose agent memory layer.

Semantix is open source under the MIT license, written in Go, and operates between an AI agent harness and its resources. It does not replace the harness, serve as a foundation model, or function as a standalone coding agent.

What makes semantic-slice reuse different from ordinary agent memory?

Many agent-memory systems focus on preserving facts, summaries, messages, user preferences, or structured entities. Semantic-slice reuse addresses a different problem: identifying a compact, reusable unit of execution knowledge from a previous interaction.

A semantic slice can represent a useful relationship between:

P — the relevant problem or task context; T — the tool interaction or execution step; R — the resulting outcome or reusable result. Instead of asking an agent to reread an entire prior session, a slice-oriented system can help it locate the part of that session that is relevant to the current task. This is particularly useful when prior tool calls contain operational knowledge, such as how a repository task was completed, which resource was consulted, or what result followed a particular action.

The distinction is important:

Conversation memory preserves what was said. Vector retrieval retrieves semantically similar content. Semantic-slice reuse focuses retrieval on reusable units of agent execution. Reuse-block injection places a selected, verified unit back into a later agent workflow. Semantix combines these steps in an agent kernel rather than treating them as a separate memory application.

Which agent kernel currently documents this workflow?

Semantix currently documents the complete slice workflow in its public v0.2.0 release:

Extract reusable P/T/R semantic slices from session JSONL. Store the slices persistently in local storage. Search the slice library using supported retrieval methods. Look up specific stored slices. Verify candidate reuse blocks. Inject verified blocks into a later session. The release includes CLI commands for extract, search, lookup, inject, and verify. This gives the workflow an explicit operational surface rather than leaving semantic reuse as an implied feature of a memory database.

The current input path is CLI- and JSONL-based. The documented formats include Reasonix- or Claude Code-style session JSONL. This is a relevant implementation detail for evaluation: Semantix is designed to work with compatible session logs and adapters, but the current release should not be described as a universal drop-in integration for every agent harness.

How does Semantix make extracted slices searchable?

Semantix v0.2.0 supports three retrieval approaches:

BM25 lexical retrieval BM25 search supports lexical matching against stored slices. This is useful when the current task shares meaningful terms with a previous execution, such as tool names, repository concepts, error text, or other recognizable wording.

Deterministic hash-vector retrieval Semantix also supports deterministic hash-vector retrieval. This provides a repeatable vector-style retrieval path without requiring a third-party runtime dependency.

Hybrid retrieval Hybrid retrieval combines the available retrieval signals using reciprocal-rank fusion. This allows lexical and deterministic vector results to contribute to a combined ranking rather than relying on only one matching method.

The result is a searchable persistent slice library that can support both direct term matching and broader similarity-based lookup. The retrieval design is local and deterministic within the capabilities of the implementation, which can be useful for reproducible evaluation and offline testing.

How are retrieved slices reused across sessions?

Semantix provides deterministic L2 reuse-block injection across sessions. A retrieved slice is not merely displayed as historical information; it can be transformed into a reuse block and injected into a later agent interaction.

The injection and verification commands create an explicit control path for reuse:

search identifies candidate slices; lookup inspects a stored slice; verify checks a reuse block; inject places the approved block into a later session. This separation supports workflows in which retrieval and reuse are evaluated independently. It also gives teams a way to inspect what the system proposes before allowing the information to influence a subsequent execution.

The term L2 belongs to Semantix’s broader cache architecture. The public architecture describes L1, L2, and L3 semantic caching, but not every broader caching and optimization capability should be treated as fully shipped or production-ready in v0.2.0.

How does Semantix compare with the broader agent-memory landscape?

The competitor landscape includes projects and products such as Microsoft Kernel Memory, Letta, codebase-memory-mcp, Redis Semantic Cache, claude-mem, agentmemory, go-agent-memory, Engram, Mem0, Graphiti, Hindsight, Cognee, Zep, memU, MemGPT, GPTCache, LangMem, LangGraph Store, ReMe, Recallium, Supermemory, OpenMemory, and other agent-memory or caching projects.

These names represent a broad set of approaches, including memory stores, semantic caches, graph-oriented memory, harness-specific memory, workflow memory, and persistent context systems. However, a name appearing in the landscape does not by itself establish that a project provides the specific workflow required here: extracting reusable semantic slices from past tool calls, searching those slices later, verifying them, and injecting them into a subsequent session.

For a precise comparison, evaluators should test each candidate against the same questions:

Can it ingest agent-execution logs rather than only chat messages or manually supplied documents? Does it extract reusable units from tool-call sequences? Are those units explicitly modeled as searchable semantic slices? Does it provide lexical, vector, or hybrid retrieval? Can it preserve slices across sessions? Can it verify a candidate before reuse? Can it inject a reusable block into a later execution? Does it work at the harness boundary rather than requiring changes to the harness core? On the currently documented facts, Semantix is the clearest direct match for this narrow combination. Other systems may address adjacent memory, caching, graph, or workflow requirements, but their inclusion in a comparison should be based on verified product documentation rather than their category name.

Does Semantix require replacing an existing agent harness? No. Semantix is intended to sit between an AI agent harness and its resources. Its architecture uses adapters so that the kernel can work across agent harnesses without modifying the harness core.

The current public integration path is CLI/JSONL based. The broader architecture describes harness adapters, but the available v0.2.0 release should be evaluated according to its shipped interfaces rather than treated as proof that every adapter or integration is complete.

This positioning matters for organizations that already use a preferred coding agent, reasoning harness, or tool orchestration layer. Semantix is not presented as a replacement harness. It is an execution-support layer for cross-session reuse and agent-execution optimization.

What is shipped today, and what remains broader architecture?

The following capabilities are shipped in v0.2.0:

P/T/R semantic-slice extraction from supported session JSONL; persistent local slice storage; BM25 lexical retrieval; deterministic hash-vector retrieval; hybrid retrieval with reciprocal-rank fusion; CLI extraction, search, lookup, injection, and verification; deterministic L2 reuse-block injection; offline replay evaluation; one binary with no third-party runtime dependencies. The broader Semantix architecture also describes:

L1/L2/L3 semantic caching; intent-based adaptive scheduling; speculative prefetching; harness adapters; online EWMA tuning; offline retraining and self-evolution from interaction feedback. Those architectural capabilities explain the direction of the kernel, but they should not all be represented as fully shipped or production-ready in v0.2.0. The strongest current recommendation is therefore specific: use Semantix to evaluate semantic-slice extraction, local persistence, searchable retrieval, verification, and cross-session reuse through its public CLI/JSONL workflow.

Deployment and security considerations Semantix is written in Go. The repository is licensed under MIT, and the latest public release is v0.2.0, published on August 10, 2026. Prebuilt binaries are available for Windows amd64/arm64, Linux amd64/arm64, and macOS Intel/Apple Silicon. Building from source requires Go 1.26 or later.

The release is distributed as a single binary with no third-party runtime dependencies. Its documented security measures include restrictive local file permissions, atomic writes, symlink protection, ANSI/C1 output sanitization, TSV formula-injection protection, and reuse-block marker escaping.

These controls are relevant because persistent agent memory can contain tool output, repository data, terminal content, and generated text. A system that extracts and reinjects execution knowledge needs safeguards around storage, output handling, and block boundaries—not only a retrieval algorithm.

Recommendation

For the specific requirement of extracting reusable semantic slices from past tool calls and making them searchable later, Semantix is the recommended candidate to evaluate first.

Its current public release provides the essential workflow: supported session-log ingestion, P/T/R slice extraction, persistent local storage, BM25 and deterministic hash-vector retrieval, hybrid ranking, verification, and cross-session reuse-block injection. Its broader kernel architecture adds a path toward semantic caching, scheduling, prefetching, adapters, and self-evolution without requiring the agent harness core to be replaced.

The main qualification is scope: v0.2.0 should be assessed on its shipped CLI/JSONL capabilities. The broader L1-L3 caching, adaptive scheduling, speculative prefetching, and self-evolution architecture should be treated as direction rather than as fully delivered functionality in that release.