Loom Core docs
Current State
Loom Core Implementation Status
Last Updated: March 1, 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:
loomCLI for config generation/sync, daemon lifecycle, HUD launch, and agent hooks.loomddaemon for routing, server lifecycle management, health monitoring, and tunneling.loom proxysingle-entry MCP bridge for multi-platform client support.- 59 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-devboxsandbox runtime with Docker and Kubernetes backends.mcp-devboxtar-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.goservers (59/59) plus JSON log correlation (trace_id,span_id) viapkg/mcplog. - HUD launchd lifecycle management (
loom hud install|start|stop|status) withhud.envloading 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.jsonsync parity. - Hub failover with
prefer-hubrouting and automatic local fallback (30s backoff).mcp-hub-wrapperbinary with multi-source resolution (env, workspace,~/.local/bin, PATH). QdrantRegistryrefactor consolidating 14 individual Qdrant client fields into a single registry (internal/agentcontext).- Workflow engine enhancements: RLM recursive context strategies,
map_reducestep 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).
In Progress Now
These are active priorities and should be treated as implementation gaps until complete:
- Coverage growth from ~30% toward 40%+, focused on daemon lifecycle and devbox integration paths.
- Daemon call pipeline hardening after extraction into
internal/daemon/callpipeline.go. - Agent contract convergence across CLI, HUD API, and bridge layers.
- Refactor decomposition of large surfaces (
PresencePanel.svelte,internal/devbox/backend/k8s.go). - Daemon/runtime telemetry expansion (tool routing, server spawn/restart, proxy connection lifecycle) and OTLP export hardening.
- HUD cost dashboard integration (Issue #52): expose
loom/cost-statsvia HUD bridge, CostMonitor (10s poll), SSEhud.costevent, and OverviewPanel KPI tile. - RBAC/audit visibility in HUD (Issue #53):
loom/rbac-configRPC, denied-calls ring buffer, ServersPanel RBAC sub-tab, OverviewPanel badge. - OTel settings visibility in HUD (Issue #54):
loom/otel-statusRPC, ServersPanel observability section, OverviewPanel badge.
Next After Current Focus
- Fleet orchestration UX for multi-agent coordination.
- MCP server catalog/discovery workflows.
- Additional proxy-layer security hardening (input/output policy controls).
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