ContextLattice

Why ContextLattice

ContextLattice reduces repeated inference by turning prior project work into high-signal, retrievable context.

• Durable memory writes with fanout to specialized stores.

• Fast + deep retrieval modes with staged fetch and fail-open continuation.

• Rollup-first context to keep token use efficient while preserving drill-down paths to raw artifacts.

• Local-first deployment with optional cloud-backed dependencies.

• Human + agent UX through HTTP APIs, MCP transport, and operations dashboard.

Architecture (Public v3 lane)

Install

Less-technical installers

• macOS DMG: https://github.com/sheawinkler/ContextLattice/releases/latest/download/ContextLattice-macOS-universal.dmg

• Linux bundle: https://github.com/sheawinkler/ContextLattice/releases/latest/download/ContextLattice-linux-bootstrap.tar.gz

• Windows MSI: https://github.com/sheawinkler/ContextLattice/releases/latest/download/ContextLattice-windows-x64.msi

Developer install

git clone git@github.com:sheawinkler/ContextLattice.git
cd ContextLattice
gmake quickstart

Quickstart

Prerequisites

• Docker/Compose v2-compatible runtime

• macOS, Linux, or Windows (WSL2)

• gmake, jq, rg, python3, curl

Launch

1) Configure environment

cp .env.example .env
ln -svf ../../.env infra/compose/.env
gmake quickstart

gmake quickstart prompts for a runtime profile and launches with sensible defaults. If launched from the macOS DMG bootstrap, it also generates:

• ~/ContextLattice/setup/agent_contextlattice_instructions.md (copied to clipboard)

• ~/ContextLattice/setup/agent_smoke_write_read.md (operator write/read smoke check)

Verify

ORCH_KEY="$(awk -F= '/^CONTEXTLATTICE_ORCHESTRATOR_API_KEY=/{print substr($0,index($0,"=")+1)}' .env)"

curl -fsS http://127.0.0.1:8075/health | jq
curl -fsS -H "x-api-key: ${ORCH_KEY}" http://127.0.0.1:8075/status | jq '.service,.sinks'

Runtime Profiles

Core API examples

MCP Tool Contract (Glama-lite / stdio bridge)

The Glama single-container profile exposes three MCP tools with explicit scope:

• health: read-only readiness/troubleshooting check (GET /health), no side effects.

• memory.search: read-only scoped retrieval (POST /memory/search) with lifecycle states (ready|pending|degraded|empty) and optional grounding/debug payloads.

• memory.write: state-changing durable write (POST /memory/write) with explicit fanout status and warning fields.

All three tools return JSON in both text content and structured payload form for client compatibility.

Write memory

curl -X POST "http://127.0.0.1:8075/memory/write" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ${ORCH_KEY}" \
  -d '{
    "projectName": "my_project",
    "fileName": "notes/decision.md",
    "content": "Switched retrieval_mode to balanced for normal runs.",
    "topicPath": "runbooks/retrieval"
  }'

Read memory

curl -X POST "http://127.0.0.1:8075/memory/search" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ${ORCH_KEY}" \
  -d '{
    "project": "my_project",
    "query": "retrieval mode decision",
    "topic_path": "runbooks/retrieval",
    "include_grounding": true
  }'

Deep read with continuation metadata

curl -X POST "http://127.0.0.1:8075/memory/search" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ${ORCH_KEY}" \
  -d '{
    "project": "my_project",
    "query": "full architecture context",
    "retrieval_mode": "deep",
    "include_grounding": true,
    "include_retrieval_debug": true
  }'

Configuration (public-safe essentials)

Set only what you need for normal operation:

CONTEXTLATTICE_ORCHESTRATOR_URL=http://127.0.0.1:8075
CONTEXTLATTICE_ORCHESTRATOR_API_KEY=<set-by-setup>
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=<long-random-secret>
APP_URL=http://localhost:3000

For full config reference, use .env.example.

Dashboard

• UI: http://127.0.0.1:3000/console

• Mindmap: http://127.0.0.1:3000/mindmap

• Status: http://127.0.0.1:3000/status

Public vs paid

This repository tracks the public free lane (v3.x). Advanced premium tuning, proprietary optimization policy, and private commercialization docs live outside this public lane.

Documentation

• Website docs: https://contextlattice.io/

• Local docs index: docs/

• Hugging Face lite deployment: docs/huggingface-space-lite.md

License

Apache 2.0. See LICENSE.