Skip to main content
Loom Core docs

Current State

Loom Core Implementation Status

Last Updated: April 14, 2026 Canonical status source for shipped vs in-progress work.

Current State

Loom Core is production-ready as a local MCP runtime and orchestration backend.

Shipped and actively used:

  • loom CLI for config generation/sync, daemon lifecycle, HUD launch, and agent hooks.
  • loomd daemon for routing, server lifecycle management, health monitoring, and tunneling.
  • loom proxy single-entry MCP bridge for multi-platform client support.
  • Go MCP servers spanning Git, GitLab/GitHub, Kubernetes, observability, agent memory, and sandbox execution.
  • HUD command center (web, TUI, macOS overlay) for server/agent/sandbox visibility.

Recently Shipped (Post v0.9.7)

  • HUD M3/M4 UX foundation and panel migrations.
  • Streamable HTTP transport with bearer/OIDC/mTLS auth.
  • Enterprise controls: RBAC, audit trail, cost tracking, OAuth 2.1.
  • mcp-devbox sandbox runtime with Docker and Kubernetes backends.
  • mcp-devbox tar-pipe workspace sync (SPDY) and git-clone initContainers replacing NFS dependency.
  • Devbox K8s reliability: parallel builds, per-agent pod isolation, warm pool, NFS cache flush.
  • Agent orchestration enhancements (presence, worktrees, workflows).
  • Configurable session-start recall strategies (--recall-strategy).
  • Async summarize on session end (non-blocking agent hooks).
  • Developer-safe local upgrade flow (make dev-upgrade, make dev-reload).
  • OTel tracing across all cmd/mcp-*/main.go servers plus JSON log correlation (trace_id, span_id) via pkg/mcplog.
  • HUD launchd lifecycle management (loom hud install|start|stop|status) with hud.env loading and Redis-first cache defaults in launchd mode.
  • HUD enterprise dashboard: cost dashboard, RBAC visibility, OTel status panels.
  • Worktree-first agent workflow nudges at session start and Antigravity settings.json sync parity.
  • Hub failover with prefer-hub routing and automatic local fallback (30s backoff). mcp-hub-wrapper binary with multi-source resolution (env, workspace, ~/.local/bin, PATH).
  • QdrantRegistry refactor consolidating 14 individual Qdrant client fields into a single registry (internal/agentcontext).
  • Workflow engine enhancements: RLM recursive context strategies, map_reduce step type, conditional gating, deep-copy in clone.
  • iOS companion app: sandbox start flow, ops workflows, push diagnostics.
  • Mobile HUD API: sandbox/devbox tab, control-plane read APIs, auto-sync gateway token.
  • Skills generation: priority-based assembly, \${VAR} escaping, auto-update date, asset validation.
  • CI migration from Kaniko to remote BuildKit for image builds.
  • Daemon resilience: keep neo4j/substack MCPs alive in degraded mode; retry local tool calls after transport-closed failures.
  • Autogenerated changelog via py-changelog-ai (make changelog).
  • Daemon call-pipeline hardening: centralized parse/build/route error envelopes and stage-boundary regression coverage.
  • Agent session contract convergence: shared request normalization for session-start, session-end, and heartbeat across bridge, HUD fleet handlers, and CLI fallback commands.
  • Daemon runtime OTel wiring: tracer startup/shutdown now follows env/config and loom/otel-status reports runtime state.
  • Home-authoritative CLI approvals: sync strips project-level approval drift and Codex loom-proxy configs now emit default auto-allow for Loom-managed tools.
  • Codex keepalive bootstrap and recall degradation visibility: generated Codex hooks now launch loom agent keepalive-wrap, and agent_recall surfaces backend latency/warning metadata via recall_meta.
  • Workflow auto_verify step type backed by devbox_quality_gate, including structured failure state and retry-aware workflow execution.
  • HUD traces explorer: audit-backed loom/audit-traces and /api/traces now expose recent tool-call timing/stage summaries through the desktop Traces panel.
  • Desktop live-agent unification: Fleet, Presence, Overview, and status-bar counts now use one merged agent model across sessions, presence, and spawned agents, with direct Session and filtered Traces drilldowns.
  • HUD session trace endpoint: GET /api/sessions/{id}/trace composes session metadata, lifecycle events, context entries, and daemon audit traces, returning partial data plus source-scoped errors when agent-context is unavailable or reports transport closed.
  • Mobile session trace parity: GET /api/mobile/v1/sessions/{session_id}/trace returns the same resilient session metadata, context entries, lifecycle events, and daemon audit traces in the mobile response envelope.

In Progress Now

These are active priorities and should be treated as implementation gaps until complete:

  1. Targeted follow-on coverage expansion after crossing 40.7%, focused on daemon lifecycle and devbox integration paths (Issue #2).
  2. Devbox backend seam cleanup and integration-test leverage in internal/devbox/backend (Issue #23).
  3. Daemon/runtime telemetry expansion beyond the new audit-backed trace explorer: fuller OTel export parity, percentile views, and deeper proxy/server lifecycle instrumentation (Issue #12).
  4. Fleet orchestration follow-on after live-agent unification: merge assistance, stronger conflict surfacing, and deeper cross-agent coordination flows (Issue #13).
  5. OpenAI Responses orchestration M2 controls and end-to-end policy/audit coverage (Issue #63).
  6. Onboarding/docs consistency and canonical entrypoint maintenance (Issue #6).
  7. Mobile v1 scope discipline enforcement (Issue #37): enforce milestone exit scope gates and route desktop-parity asks to post-v1 backlog.

Next After Current Focus

  • MCP server catalog/discovery workflows (Issue #14).
  • Additional proxy-layer security hardening (input/output policy controls) (#25, #26, #27, #29).

Where to Verify Status

  • Strategic roadmap and checklists: ROADMAP.md
  • Refactor sequencing details: docs/planning/2026-02-17-architecture-refactor-opportunities.md
  • User-visible changes log: CHANGELOG.md
  • Docs ownership and refresh cadence: docs/DOCS_MAINTENANCE.md

Quick Local Verification

# CLI and command surface
./bin/loom --help
./bin/loom agent --help

# Runtime health
./bin/loom status
curl http://localhost:9876/health

# Build and quality baseline
make build
go test ./...
golangci-lint run