moeix 0.3.0

High-performance trigram code search for humans and AI agents.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

# ix ⚡

> Lightning-fast, safety-aware code search and indexing tool.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)]()

## See It In Action

```bash
$ ix search "fn validate"
src/llmosafe_kernel.rs:42: pub fn validate(&self) -> Result<(), KernelError>
```

## Quick Start

```bash
# Install
cargo install --path .

# Index current directory
ix --build .

# Search
ix "Mycelial Sensing"
```

## The Contract

`ix` provides two binaries:
- `ix`: The CLI search tool.
- `ixd`: The background daemon for continuous indexing.

Both are integrated with the LLMOSafe v0.4.2 Immune Substrate for proactive metabolic pacing and capability-aware execution.

## The Engine

`ix` uses a highly optimized trigram index with ZSTD-compressed posting lists:
- **Delta encoding** for position offsets (compact representation)
- **ZSTD compression** for 75% smaller indexes
- **XXHash64 checksums** for data integrity (built into ZSTD)

Index format v1.2 is **not backward compatible** with v1.1. Rebuild indexes after upgrading.

## Performance

| Metric | Value |
|--------|-------|
| Index ratio | ~4x source size |
| Query latency | <100ms for typical searches |
| Compression | ZSTD level 3 (optimal balance) |

## Context

Built for the era of AI agents where search must be both fast and system-aware.