ContextLattice

Private-by-default memory and context orchestration for AI agents.

What ContextLattice Does

ContextLattice provides a single memory contract for agentic systems:

• Unified write/read contract for memory and context.
• Durable fanout across retrieval/storage lanes.
• Staged retrieval (fast now, deep continuation when needed).
• Bounded async inbox delivery that reports queued work as warming and surfaces terminal continuation results at normal CLI boundaries.
• Temporal claims that preserve what was true, when it was true, what replaced it, what contradicts it, and the evidence behind each assertion.
• Advisor-only retrieval planning plus proof-carrying synthesis that exposes support, opposition, uncertainty, missing proof, and causal context instead of laundering recall into certainty.
• Outcome-trained policy candidates that must survive shadow and controlled canary gates one phase at a time before promotion can even be recommended.
• Skill Foundry conversion of repeated verified workflows into independently evaluated, human-approved, inactive skill exports with explicit, non-destructive draft retirement.
• Signed Context Passports that carry bounded claims, evidence, objectives, lineage, capability requirements, expiry, deterministic diffs, and replay plans across machines.
• Encrypted Context Mesh envelopes with explicit project-scoped recipient grants, X25519 encryption, revocation, and conflict-preserving import without turning ContextLattice into a sync transport.
• Agent runtime sessions that turn prior work, objective lineage, graph touches, skills, checkpoints, and handoffs into prompt-ready reference packages, exportable run traces, and exact-linked proof timelines.
• Continuity Identity that keeps one task stable across agents and sessions without confusing it with a branch, worktree, or execution lane; semantic resemblance is advisory and never silently merges work.
• Longitudinal objective graphs and decision-change receipts that preserve how work moved, why a decision changed, what evidence triggered it, and what was known at any requested point in time.
• Go/Rust runtime ownership for the active application path.
• Legacy Python runtime archived under archive/services/orchestrator_legacy_python for tooling/test compatibility only.
• Local-first deployment with optional hosted surfaces.

Current Public Baseline

v3.19.0 is the current public baseline. Agent Packets now negotiate digest-verified deltas, transmit only what changed when that is provably smaller, and fall back to the exact full packet whenever a base is stale, tampered, mismatched, or uneconomic. The local proof timeline joins context, action, correction, verification, outcome, and learning through exact identity while rendering missing or corrupt evidence as a gap instead of inventing continuity. The CLI remains the prescribed path; dashboard, HTTP, and MCP are companion integration surfaces. Governed shared retention and workspace timelines remain paid capabilities, while local delta reconstruction and local proof stay in the public core.

Public Runtime Stack (v3.19)

• Ingress: gateway-go.
• Core memory + retrieval lanes: Go + Rust services.
• Retrieval policy: staged fast-return, async continuation lifecycle, and impact-per-token allocation.
• Primary interface: contextlattice context|resume|remember|finish|correct|doctor.
• Advanced CLI helpers such as contextlattice_adopt, contextlattice_agent_adapter, contextlattice_agent_session, and contextlattice_runner_quality remain available for integration and debugging.
• Companion surfaces: dashboard for visibility, HTTP for app integration, and MCP-compatible clients for host/harness integrations.
• Single-container lite builds (Dockerfile.hf-lite) also run gateway-go (no Python runtime dependency).
• Public single-container lite vector default: topic_rollups only.
• Public local lite core default: topic_rollups + qdrant; pgvector and memory-bank spike adapters are not started by default.
• Public local lite advanced: optional public adapter lab via gmake mem-up-lite-advanced; not the default quickstart and not a paid/private boundary.
• Full/operator stacks: Qdrant remains the primary vector-native lane; pgvector stays supported for SQL-co-located vector workloads.

Cognition Core CLI

The CLI is the prescribed agent interface. HTTP and MCP remain integration fallbacks.

# Normal task lifecycle: compact context, one reusable session, automatic outcome learning.
contextlattice doctor --pretty
contextlattice context "debug the current release regression" --project contextlattice --pretty
contextlattice remember "checkpoint summary" --project contextlattice --pretty
contextlattice resume --project contextlattice --pretty
contextlattice correct "retrieval was stale" --category stale --project contextlattice --pretty
contextlattice finish "verified result" --success --project contextlattice --pretty

# Optional delta transport for clients that retain the last trusted packet.
# A full packet is the safe fallback and becomes the next base directly.
contextlattice context "continue the release proof" --project contextlattice \
  --base-packet-file agent-packet.json --raw > packet-update.json
contextlattice packet-reconstruct --base-packet-file agent-packet.json \
  --delta-file packet-update.json --raw > next-agent-packet.json
# Pre-upgrade packets without identity metadata safely receive a new full packet.
# Packet digests detect drift but do not authenticate origin; retain the base in trusted storage.

# Advanced cognition and operator surfaces follow.
# Ask what evidence should be retrieved, from where, and when to stop.
contextlattice_retrieval_plan "debug the current release regression" --project contextlattice --pretty

# Persist a structured, time-aware assertion with explicit provenance.
contextlattice_claim_write \
  --project contextlattice \
  --subject release \
  --predicate current_version \
  --object 3.19.0 \
  --statement "The current public release is 3.19.0." \
  --pretty

# Query current, historical, superseded, or contradicted claims.
contextlattice_claim_query "current public release" --project contextlattice --include-superseded --pretty

# Return claim-level support, opposition, temporal state, uncertainty, and missing proof.
contextlattice_synthesis_pack_v2 "prove release readiness" --project contextlattice --pretty

# Resolve one durable task identity before opening another execution lane.
contextlattice_continuity_reconcile "ship continuity identity" \
  --project contextlattice --repo contextlattice --task-id frontier-t1 \
  --branch main --agent-id codex_gpt5 --pretty

# Append lifecycle evidence, inspect the objective as it existed then, and record why a decision changed.
contextlattice_objective_transition "ship continuity identity" --type progressed \
  --project contextlattice --actor codex_gpt5 \
  --idempotency-key frontier-t1-contract-proof \
  --summary "HTTP and CLI contracts verified" --pretty
contextlattice_objective_graph --project contextlattice --pretty
contextlattice_decision_change --project contextlattice --objective-id <objective-id> \
  --idempotency-key frontier-t1-semantic-abstention \
  --before "reuse every semantic match" --after "require confirmation after exact miss" \
  --confidence-before 0.45 --confidence-after 0.92 --evidence <evidence-ref> \
  --actor codex_gpt5 --rationale "Ambiguous matches must abstain." \
  --reason-code evidence_changed --pretty

# Derive a candidate only from calibration-eligible outcomes, then inspect it.
contextlattice_policy_candidate --project contextlattice --pretty
contextlattice_policy_status --pretty

# Build from repeated verified runs, test separate holdouts, then export only with approval.
contextlattice_skill_draft --payload-file workflow-runs.json --pretty
contextlattice_skill_evaluate --draft-id <draft-id> --payload-file holdouts.json --pretty
contextlattice_skill_export --draft-id <draft-id> --human-approved --approver <identity> --pretty
contextlattice_skill_retire --draft-id <draft-id> --operator <identity> --reason "temporary proof completed" --pretty

# Carry a signed evidence packet to another machine without carrying the machine with it.
contextlattice_passport_export "prepare the release handoff" --project contextlattice --output passport.json --pretty
contextlattice_passport_verify --file passport.json --pretty
contextlattice_mesh_identity --pretty

The planner remains shadow_only: learned candidates are advice, not a hidden configuration rewrite. Skill exports remain inactive files until reviewed and installed through the normal Skills Index workflow. Passport replay never executes imported text, and Mesh never owns transport. See docs/continuity-identity.md, docs/cognition-proof-core.md, docs/outcome-policy-skill-foundry.md, and docs/context-passport-mesh.md for contracts, safety boundaries, and HTTP fallbacks.

Quickstart

Agent Quickstart: Install + Integrate

If you are an AI agent reading this README because a user asked you to install or integrate ContextLattice, follow this section directly. Do not wait for the user to copy another prompt back to you.

Human users can also paste the block below into Codex, Claude Code, Hermes, OpenCode, OMP, Mercury, or another terminal-capable agent.

You are integrating ContextLattice.

Repository:
https://github.com/sheawinkler/ContextLattice.git

Goals:
- Install and launch ContextLattice locally.
- Verify the runtime is healthy.
- Integrate the target repo with ContextLattice-supported agent profiles.
- Do not install third-party agent harness binaries unless the user explicitly asks.

Important:
- `contextlattice_adopt integrate` writes managed instruction blocks for supported profiles.
- Installer flows may add managed instruction hooks for detected OMP and Mercury user-instruction files; they do not install OMP, Mercury, Codex, Claude Code, Hermes, Hermes Ultra, Pi, Droid, or other agent binaries.
- Optional Pi/Droid runner execution requires their CLIs (`brew install pi-coding-agent`, `brew install --cask droid`).
- Preserve existing user text in repo instruction files.
- If you are already inside a ContextLattice checkout, do not clone a duplicate repo.

Install ContextLattice:

git clone https://github.com/sheawinkler/ContextLattice.git
cd ContextLattice
cp .env.example .env
gmake quickstart

Verify ContextLattice:

curl -fsS http://127.0.0.1:8075/health | jq
contextlattice_adopt status --pretty

Integrate the target repo:

cd /path/to/target/repo
contextlattice_adopt integrate --repo . --agents codex,claude-code,opencode,hermes-agent,hermes-ultra,omp,mercury-agent,pi,droid --pretty
contextlattice_adopt integrate --repo . --agents codex,claude-code,opencode,hermes-agent,hermes-ultra,omp,mercury-agent,pi,droid --check --pretty
contextlattice_doctor --repo . --agents codex,claude-code,opencode,hermes-agent,hermes-ultra,omp,mercury-agent,pi,droid --skip-provider-smoke --pretty

If any step fails:
- Report the exact failing command and path.
- Fix only the local setup issue needed for that failure.
- Rerun the check.
- If ContextLattice is unreachable, continue in degraded-memory mode and say so explicitly.

For the full reusable agent contract, see docs/public_overview/templates/agents/universal.md.

1) Clone and configure

git clone git@github.com:sheawinkler/ContextLattice.git
cd ContextLattice
cp .env.example .env

2) Launch (recommended)

gmake quickstart

gmake quickstart prompts for runtime profile and then launches the selected stack.

3) Verify

curl -fsS http://127.0.0.1:8075/health | jq
scripts/agent/agent-runtime-proof-pack --pretty
scripts/agent/agent-adoption-proof-matrix --skip-provider-smoke --progress --pretty

Expected:

• /health returns {"ok": true, ...}
• agent-runtime-proof-pack completes bootstrap, scoped recall, checkpoint, handoff, completion, status, prompt context package, and runtime telemetry phases.
• agent-adoption-proof-matrix verifies configured agent profiles and reports the skills, context, session, graph, and handoff evidence shaping each run, with trace commands for run-card export.

Model Runtime

Task inference defaults to ORCH_INFER_PROVIDER=auto. gateway-go detects the host profile and probes local backends before selecting a route.

• Apple Silicon default priority: mlx,vllm-metal,ane_sidecar,llama-cpp,ollama.
• CUDA/ROCm default priority: sglang,vllm,openai-compatible,llama-cpp,lmstudio,ollama.
• Generic CPU default priority: openai-compatible,llama-cpp,lmstudio,ollama.
• Supported provider ids include sglang, vllm, vllm-metal, mlx, mtplx (alias for MLX), openai-compatible, lmstudio, llama-cpp, tgi, tensorrt-llm, ane_sidecar, and ollama.
• /v1/inference/runtime-policy returns live provider health plus resource-aware model guidance. If host memory/VRAM is not identifiable, it falls back to generic local advice: start with Q4/IQ4 7B-9B models, benchmark, then scale up.
• The current opt-in local model shortlist lives in docs/runtime/local-model-options.md; it includes small/medium MLX, GGUF, and HF/safetensors candidates plus frontier-provider connection guidance. GGUF models use an external llama.cpp-compatible connector; ContextLattice does not start or bundle llama.cpp in Lite.
• Large Qwen3.6 Dream Mode models are opt-in only; ContextLattice does not bundle or pull them by default. The default GGUF recommendation is mudler/Qwen3.6-35B-A3B-Claude-4.7-Opus-Reasoning-Distilled-APEX-MTP-GGUF for llama.cpp-compatible advanced users. Abliterated variants are private-eval only behind CONTEXTLATTICE_DREAM_ALLOW_PRIVATE_EVAL_MODELS=true (GO_DREAM_ALLOW_UNCENSORED_MODELS=true remains a legacy alias).
• Inference runtimes must emit final assistant content through their API. Reasoning-only responses fail with repair instructions instead of being accepted. For MLX Qwen thinking templates, use scripts/inference_mlx_server.sh --model /path/to/mlx/model --template-profile qwen-final-content, then verify with scripts/inference_template_conformance.sh --provider mlx --model /path/to/mlx/model.
• Dream Mode reflects on LLM-generated hypotheses by default and performs one bounded deepening pass when the best output misses the sigma target (GO_DREAM_REFLECT_ENABLED=true, GO_DREAM_DEEPEN_ON_WEAK_OUTPUT=true, GO_DREAM_REFLECTION_MIN_SCORE=0.74). If structured LLM synthesis is unavailable, Dream Mode returns dream_unavailable; non-LLM evidence packaging belongs to context-pack or review.
• Ollama remains a compatibility fallback, not the preferred always-on embedding path.
• Local helpers enforce one active LLM backend by default (CONTEXTLATTICE_SINGLE_ACTIVE_INFER_BACKEND=true).

Inspect live routing and benchmark configured backends:

scripts/inference_runtime_policy.sh
scripts/benchmark_inference_backends.sh
scripts/inference_template_conformance.sh --provider mlx --model /path/to/mlx/model

Embedding defaults to the Rust fastembed-rs sidecar. Ollama stays available as an explicit compatibility fallback, not the preferred embedding path.

Useful model runtime knobs:

ORCH_INFER_PROVIDER=auto
ORCH_INFER_PROVIDER_PRIORITY=mlx,vllm-metal,ane_sidecar,sglang,vllm,openai-compatible,llama-cpp,ollama
ORCH_INFER_AUTO_PROBE_ENABLED=true
SGLANG_BASE_URL=http://127.0.0.1:30000
VLLM_BASE_URL=http://127.0.0.1:8000
VLLM_METAL_BASE_URL=http://127.0.0.1:8000
MLX_API_BASE=http://127.0.0.1:18087/v1
LLAMA_CPP_BASE_URL=http://127.0.0.1:8080

Agent CLI

Installer and quickstart paths install agent helpers under $HOME/.contextlattice/bin.

contextlattice_agent_adapter profiles
contextlattice_adopt status --pretty
contextlattice_doctor --agents codex --skip-provider-smoke --pretty
contextlattice_agent_start --soft --compact
contextlattice_agent_trace --session-id <session-id> --tree
contextlattice_pack "what should the next agent know?" --project my-project --pretty
contextlattice_search -h
contextlattice_write -h
contextlattice_checkpoint -h
contextlattice_skills_index search "browser automation" --pretty
contextlattice_passport_export "portable task context" --project my-project --output passport.json --pretty
contextlattice_mesh_status --pretty

• contextlattice_agent_adapter is the first-class lifecycle helper for bootstrap, context-pack, checkpoint, handoff, state, event, and completion flows.
• contextlattice_agent_adapter state --state working|awaiting_user|blocked|done --session-id <id> --pretty reports semantic agent lifecycle state with authority, source, TTL, native session id, task id, repo, worktree, branch, cwd, and user/blocker fields.
• contextlattice_agent_discover --agents codex,claude-code,opencode,hermes-agent,hermes-ultra,omp,mercury-agent,pi,droid --repo . --pretty reports best-effort local process/profile/hook/repo-instruction evidence with explanations. Discovery is diagnostic evidence; explicit hook or adapter state remains authoritative.
• contextlattice_adopt is the zero-friction front door for local readiness, install guidance, profiles, and lifecycle proof; contextlattice_doctor combines readiness, proof, and trace evidence in one bounded report.
• contextlattice_agent_start runs the lightweight startup guard for agents.
• contextlattice_agent_trace renders the bounded run-shaping trail as a terminal tree, JSON, or Markdown run card.
• contextlattice_pack compiles a bounded prompt-ready packet with ranked evidence, files to inspect, risks, checks, source coverage, and a reference_prompt.
• contextlattice_checkpoint writes a checkpoint and verifies readback.
• contextlattice_skills_index discovers capabilities without loading every skill into startup context.
• contextlattice_passport_* signs, verifies, diffs, replays, and imports bounded context without executing imported instructions.
• contextlattice_mesh_* manages public recipient identity, grants, encrypted file/JSON envelopes, dry-run reconciliation, and explicit apply; transport remains caller-owned.
• contextlattice_source_backfill is an optional development helper, installed with scripts/install_global_agent_tools.sh --include-dev-python-tools, for bounded data imports.
• Hook pack details: docs/agent-hooks.md.

Agent Runtime Sessions

ContextLattice tracks live agent work as first-class sessions, independent of the runner or model provider.

• Start/list/read sessions through GET|POST /v1/agents/sessions and GET /v1/agents/sessions/{session_id}.
• Emit normalized events through POST /v1/agents/sessions/event or POST /v1/agents/sessions/{session_id}/events.
• Inspect a bounded run trace through GET /v1/agents/sessions/{session_id}/trace; the trace reports context, skills that may be helpful, source coverage, graph touches, handoffs, checkpoints, and timeline events without raw provider payloads.
• Read live runtime telemetry from GET /telemetry/agents/runtime.
• Compile task context through POST /memory/context-pack, POST /tools/context_pack, or global contextlattice_pack; responses include context_compiler, ranked evidence, deterministic agent_guidance for themes/risk markers/candidate attention links, prompt sections, and a bounded reference_prompt.
• Ask for Synthesis Pack v1 through global contextlattice_synthesis_pack "<task>" --project <project> --pretty, POST /memory/synthesis-pack, or POST /tools/synthesis_pack when the next agent needs grouped high-signal findings, topic gravity, graph/cross-project bridges, must-not-forget constraints, recommended next actions, open questions, and semantic tags over the same bounded evidence.
• Watch long-running recall through scripts/agent/contextlattice-session watch --session-id <id> --continuation-token <token>; continuation responses include retrieval_progress.v1, dashboard status links, and agent-visible steering when async work is ready.
• Preflight, context-pack, and Dream Mode return objective_runtime_state.v1 with objective_state, action_executed, evidence, objective_delta, risk_or_blocker, and next_action.
• Use scripts/agent/contextlattice-agent-adapter or global contextlattice_agent_adapter as the first-class product path for agent bootstrap, context-pack, checkpoint, handoff, state, event, and completion flows.
• Use contextlattice_agent_adapter state --state working|awaiting_user|blocked|done --session-id <id> --pretty to report semantic agent lifecycle state with authority, source, TTL, native session id, task id, repo, worktree, branch, cwd, and user/blocker fields.
• Use global contextlattice_agent_discover --agents codex,claude-code,opencode,hermes-agent,hermes-ultra,omp,mercury-agent,pi,droid --repo . --pretty for best-effort local process/profile/hook/repo-instruction discovery. Discovery explains why ContextLattice believes an agent is idle, working, waiting, blocked, or integrated; it does not replace explicit hook or adapter state.
• Use scripts/agent/contextlattice-adopt or global contextlattice_adopt before handing ContextLattice to a new agent/account; doctor combines gateway health, helper install state, shell PATH, storage posture, session store, profile coverage, best-effort discovery, runtime-doctor checks, lifecycle proof, and run trace evidence into one bounded report.
• Run contextlattice_adopt integrate --repo . --agents codex,claude-code,opencode,hermes-agent,hermes-ultra,omp,mercury-agent,pi,droid --pretty inside a target repo to write managed AGENTS.md, CLAUDE.md, HERMES.md, MERCURY.md, PI.md, and DROID.md instruction blocks without overwriting user text.
• Run contextlattice_doctor --agents codex --skip-provider-smoke --pretty for the fastest new-agent adoption proof.
• The same doctor works for other agent profiles: contextlattice_doctor --agents claude-code --skip-provider-smoke --pretty, contextlattice_doctor --agents opencode --skip-provider-smoke --pretty, or contextlattice_doctor --agents codex,claude-code,opencode --skip-provider-smoke --pretty.
• Run scripts/agent/agent-runtime-proof-pack --pretty or global contextlattice_agent_runtime_proof --pretty for a one-command live proof that bootstrap, scoped recall, checkpoint, handoff, completion, status, and runtime telemetry are wired end to end.
• Use scripts/agent/contextlattice-session for CLI start/event/complete/fail/status/runtime/trace flows.
• Use scripts/agent/agent-run-trace --session-id <id> --tree or global contextlattice_agent_trace --session-id <id> --tree to see the terminal trace, then --markdown to export the run card.
• Use global contextlattice_runner_quality --pretty to inspect bounded runner-quality telemetry for adapter success/block/failure rates, context-pack quality linkage, exact prompt-token savings, modeled inference-avoidance signals, and advisor-only runner recommendations. Repo-local scripts/agent/runner-quality --pretty remains available for development fallback.
• Use scripts/agent/contextlattice-session sweep-stale-audits --all-projects --pretty for dry-run-first cleanup of stale objective-runtime audit/preflight sessions; add --confirm only after reviewing matches.
• scripts/agent/contextlattice-pack, scripts/agent/contextlattice-dream, scripts/agent/writeback, and compaction hooks auto-start or recover a session when CONTEXTLATTICE_SESSION_ID is absent.
• Pass --session-id or CONTEXTLATTICE_SESSION_ID to force a specific session. Set CONTEXTLATTICE_AUTO_SESSION_DISABLED=1 to disable automatic session creation.

Canonical event families include session.started, agent.state.working, agent.state.awaiting_user, agent.state.blocked, agent.state.done, context_pack.completed, retrieval.continuation.progress, retrieval.continuation.ready, retrieval.continuation.degraded, dream.completed, graph.neighbors_returned, graph.edge_touched, decision.made, test.ran, handoff.created, writeback.completed, and session.completed.

Agent lifecycle and retrieval lifecycle are intentionally separate. agent_lifecycle.state describes the actor (idle, working, awaiting_user, blocked, done); retrieval_lifecycle.status describes source-fetch progress. This prevents async retrieval warming from being misread as a blocked or degraded agent.

Runner quality is intentionally separate from both lifecycle surfaces. It is advisor-only telemetry for operator selection, not automatic dispatch. See docs/runtime/runner-quality-loop.md for the compact adapter measurement loop and its interpretation limits.

Download Installers

• macOS DMG: https://github.com/sheawinkler/ContextLattice/releases/latest/download/ContextLattice-macOS-universal.dmg
• macOS signing/notarization operator notes: docs/releases/macos-signing-notarization.md
• Homebrew cask: brew tap sheawinkler/contextlattice && brew install --cask contextlattice
• Windows MSI: https://github.com/sheawinkler/ContextLattice/releases/latest/download/ContextLattice-windows-x64.msi
• Linux bundle: https://github.com/sheawinkler/ContextLattice/releases/latest/download/ContextLattice-linux-bootstrap.tar.gz

Resource Profiles

Optional constrained-disk guard: set QDRANT_HOT_STORAGE_MAX_BYTES to make launch/storage verification fail before the Qdrant hot lane exceeds your chosen byte ceiling. This is a guardrail, not a filesystem quota.

Optional external model storage: set OLLAMA_DATA to an absolute path to keep local Ollama model blobs off a constrained internal disk. When unset, the existing home-directory model store remains the backward-compatible default; startup storage verification rejects mount drift.

Memory Graph

• GET|POST /v1/memory/edges persists explicit typed relationships.
• POST /v1/memory/edges/backfill audits or applies deterministic retroactive edges and opt-in same-project inferred_related scoring. It is dry-run by default.
• POST /v1/memory/neighbors returns explicit/inferred edge neighbors merged with semantic/topic neighbors.

contextlattice_memory_graph_repair --project my-project --pretty
contextlattice_memory_graph_repair --project my-project --write --confirm-project my-project --max-writes 500 --pretty
contextlattice_memory_graph_efficacy --refresh-cases --project my-project --graph-max-cases 3 --pretty

# Repo-local advanced fallback; inferred scoring is opt-in.
./scripts/agent/memory-edge-backfill --project my-project --max-writes 500
./scripts/agent/memory-edge-backfill --project my-project --include-inferred --min-confidence 0.90
./scripts/agent/memory-edge-inferred-retrofill --project my-project --corpus disk --profile exploratory

Source Backfill

Bring existing data into ContextLattice without changing the ingest boundary. Backfill is dry-run by default, writes go through /memory/write, and writes require --write --confirm-write <project>.

./scripts/agent/source-backfill-memory --source jsonl --path exports/tasks.jsonl --project my-project --pretty
./scripts/agent/source-backfill-memory --source sqlite --path app.db --table notes --project my-project --pretty
./scripts/agent/source-backfill-memory --source parquet --path warehouse/events.parquet --project my-project --pretty
./scripts/agent/source-backfill-memory --source postgres --dsn "$DATABASE_URL" --query "select id,title,body from notes limit 100" --project my-project --pretty
./scripts/agent/source-backfill-memory --source jsonl --path exports/tasks.jsonl --project my-project --write --confirm-write my-project --apply-edges --pretty

Supported adapters: files/directories, JSONL, JSON, CSV, SQLite, DuckDB, Parquet via DuckDB, and Postgres via optional psycopg. Import caps cover records, row bytes, document bytes, total bytes, and structured-list items. Secret-like fields are redacted by default, and graph edge repair is optional and bounded.

Skills Index And Quarantine Discovery

ContextLattice exposes active skills as a native Go Skills Index so agents can discover relevant capabilities without loading every SKILL.md into prompt context. In local installs, the active index mounts ${HOME}/.codex/skills read-only by default. Quarantined/vendor skill discovery remains a separate read-only lane and does not auto-load quarantined skills.

• Active index endpoint: GET|POST /v1/skills/index/search
• Active index tool: GET|POST /tools/skills_index_search
• Active index status/reindex endpoint: POST /v1/skills/index/reindex (live native scan; no prompt loading)
• Search endpoint: GET|POST /v1/skills/quarantine/search
• Tool alias: GET|POST /tools/skills_quarantine_search
• Reindex endpoint: POST /v1/skills/quarantine/reindex (off by default; enable explicitly)

Runtime knobs:

ORCH_SKILLS_QUARANTINE_ENABLED=true
ORCH_SKILLS_QUARANTINE_HOST_BIN_DIR=${HOME}/.local/bin
ORCH_SKILLS_INDEX_HOST_ACTIVE_ROOT_DIR=${HOME}/.codex/skills
ORCH_SKILLS_INDEX_HOST_SYSTEM_ROOT_DIR=${HOME}/.codex/skills/.system
ORCH_SKILLS_INDEX_ROOTS=/opt/contextlattice/skills_active:/opt/contextlattice/skills_system
ORCH_SKILLS_QUARANTINE_HOST_ROOT_DIR=${HOME}/.codex/skills_quarantine
ORCH_SKILLS_QUARANTINE_SEARCH_CMD=/opt/contextlattice/skills/bin/codex-skills-quarantine-search
ORCH_SKILLS_QUARANTINE_REINDEX_CMD=/opt/contextlattice/skills/bin/codex-skills-quarantine-reindex
ORCH_SKILLS_QUARANTINE_TIMEOUT_SECS=8
ORCH_SKILLS_QUARANTINE_DEFAULT_LIMIT=20
ORCH_SKILLS_QUARANTINE_MAX_LIMIT=100
ORCH_SKILLS_QUARANTINE_REINDEX_ENABLED=false
CODEX_SKILLS_QUARANTINE_ROOT=/opt/contextlattice/skills_quarantine
CODEX_SKILLS_QUARANTINE_INDEX_DIR=/opt/contextlattice/skills_quarantine/index
CODEX_SKILLS_QUARANTINE_INDEX=/opt/contextlattice/skills_quarantine/index/skills_index.jsonl

Security and Privacy

• Local-first by default.
• API-key protected operational routes.
• Secret-like content redaction controls.
• Premium billing/provider route maps are intentionally kept out of public docs.

Docs Index

• Overview: https://contextlattice.io/
• Architecture: https://contextlattice.io/architecture.html
• Local AI workspace comparison: https://contextlattice.io/local-ai-workspaces.html
• Scaling memory: https://contextlattice.io/scaling-memory.html
• Wiki: https://contextlattice.io/wiki.html
• Installation: https://contextlattice.io/installation.html
• Integrations: https://contextlattice.io/integration.html
• Troubleshooting: https://contextlattice.io/troubleshooting.html
• Updates: https://contextlattice.io/updates.html
• Plans and distribution boundaries: docs/public_overview/premium.html
• Release notes, newest first; older entries are historical:
  • docs/releases/v3.19.0.md (digest-verified Agent Packet deltas, exact reconstruction, and one gap-aware proof timeline)
  • docs/releases/v3.18.0.md (durable continuity identity, holdout-locked semantic reconciliation, shared objective graphs, and witnessed decision provenance)
  • docs/releases/v3.17.5.md (latest-only configured state, bounded owner-only migration, and fail-closed semantic readers)
  • docs/releases/v3.17.4.md (regression-locked public artifact boundary and complete installer publication)
  • docs/releases/v3.17.3.md (owner-only local stores, approval-before-work, evidence-qualified advice, and exact runtime truth)
  • docs/releases/v3.17.2.md (operator-chosen Ollama storage, verified mount truth, and sourceable environment profiles)
  • docs/releases/v3.17.0.md (canonical commercial truth, self-contained installers, strict public boundary, and tiny-pack identity)
  • docs/releases/v3.16.1.md (contract-valid compact lifecycle receipts for the primary CLI)
  • docs/releases/v3.16.0.md (compact Agent Packet, session truth, monotonic async, outcome learning, unified CLI, and proof workbench)
  • docs/releases/v3.15.1.md (Node 24 LTS convergence across local tooling, containers, packages, and release actions)
  • docs/releases/v3.15.0.md (bounded graph repair, explicit graph efficacy, hydrated neighbors, and durable Foundry retirement)
  • docs/releases/v3.14.0.md (signed Context Passport and encrypted Context Mesh)
  • docs/releases/v3.13.0.md (outcome-trained canary policy and Skill Foundry)
  • docs/releases/v3.12.0.md (Temporal Claim Graph, adaptive retrieval planning, and Proof-Carrying Synthesis v2)
  • docs/releases/v3.11.2.md (evidence-preserving sparse Context Packs and grounded deterministic synthesis)
  • docs/releases/v3.11.1.md (upgrade-safe runner discovery across long-lived agent environments)
  • docs/releases/v3.11.0.md (Synthesis Packs, async warming, outcome calibration, memory activation evidence, and public-core parity)
  • docs/releases/v3.10.2.md (Go-native feedback submit, idempotency, preference projection, and strict ownership coverage)
  • docs/releases/v3.10.1.md (detected OMP/Mercury instruction hooks and default adoption coverage)
  • docs/releases/v3.10.0.md (optional Pi/Droid runner adapters, runner-quality advisor, and CLI-first public surface)
  • docs/releases/v3.9.1.md (dashboard contrast, settings clarity, public-site alignment, and current-version guidance)
  • docs/releases/v3.9.0.md (agent-operable context-pack outcome telemetry and observed provider usage)
  • docs/releases/v3.8.0.md (MongoDB driver v2 migration and Context Pack Quality Ledger)
  • docs/releases/v3.7.1.md (MongoDB driver security patch for the v3.7 train)
  • docs/releases/v3.7.0.md (tokenizer-exact prompt economics, bounded token-impact ledger, and release-note hygiene)
  • docs/releases/v3.6.2.md
  • docs/releases/v3.5.0.md
  • docs/releases/v3.4.25.md
  • docs/releases/v3.4.14.md
  • docs/releases/v3.4.13.md
  • docs/releases/v3.4.12.md
  • docs/releases/v3.4.11.md
  • docs/releases/v3.4.10.md
  • docs/releases/v3.4.5.md
  • docs/releases/v3.4.2.md
  • docs/releases/v3.4.1.md
• Local model options: docs/runtime/local-model-options.md

License

Business Source License 1.1 (LICENSE).