do not repeat

I build infrastructure that makes AI agents waste fewer tokens and remember more.

Helioy is context engineering for AI agents. The thesis: larger context windows don't solve the problem. Better representations do. Code as indexed structure. Documentation as scoped sections. Decisions as distilled knowledge. Identity as geometric memory. Every token earns its place.

helix

A unified context API. One interface between your agents and every context source that matters.

helix recall <query>     # curated context from all sources
helix save <content>     # distill and store knowledge
helix conflicts          # surface overlaps for resolution

Both reads and writes pass through an LLM-powered proxy for curation. Tantivy handles candidate retrieval. The proxy shapes responses to token budget. Your agent never touches individual backends.

The adapters

helix draws from four context sources:

context-matters — Structured context store. Facts, decisions, patterns, and trade-offs persisted across agent lifetimes. SQLite + FTS5, hierarchical scopes (global > project > repo > session), BLAKE3 content deduplication. Rust.

attention-matters — Organizational identity through geometric memory on the S³ hypersphere. Quaternion positions, SLERP drift along geodesics, phasor interference between conscious and subconscious manifolds, Kuramoto phase coupling. Conservation laws keep it grounded: total mass M=1, coupling K_CON + K_SUB = 1. The geometry does the thinking. Rust.

markdown-matters — Structural intelligence for markdown. Section-aware indexing, hybrid search (BM25 + semantic), 80%+ token compression. Your agent gets relevant sections under a token budget, not entire directories. TypeScript + Effect.

frontmatter-matters — Code as indexed structure. Export maps, import graphs, dependency topology, file outlines. 5 structural queries replace 30+ file reads. Rust + tree-sitter.

The tools

helioy-bus — Inter-agent messaging. SQLite registry, file-based mailboxes, tmux nudges. Direct, role-based, and broadcast addressing. No central daemon. Coordination through shared state.

nancyr — Multi-agent orchestrator. Context routing between agents, token budgets, adaptive coordination. Rust.

helioy-plugins — Claude Code plugin layer. Skills, MCP servers, hooks. The glue.

The architecture

Agent  →  helix  →  Proxy LLM  →  Adapters
                        │
                   curates both
                   reads and writes
                        │
          ┌─────────────┼─────────────┐
          │             │             │
    context-matters  attention-   markdown-    frontmatter-
    (decisions)      matters     matters       matters
                     (identity)  (docs)        (code)

Agent  ↔  helioy-bus  ↔  Agent
               │
             nancy
          (orchestration)

Principles

• Every token counts. An operational principle, not a slogan.
• Better representations, not larger windows. Indexed structure outperforms raw text at every benchmark.
• Ship working code. Fix forward.
• One brain, not one brain per project. Cross-pollination is a feature.
• Independent repos, not a monorepo. Each component stands alone.