Skip to content

Local Agent ecosystem

Local Agent is the conversation, model, permission, and foreground-goal host. The surrounding projects remain focused tools with explicit interfaces. They are not all bundled integrations.

The shared transcript vocabulary keeps those ownership boundaries legible:

ToolProduct roleEvidence meaning
MCPHubGateway and lazy catalogRouting only
CortexCoordination, criteria, and evidence closurePreserves claims and proof relationships
VecgrepSemantic discoveryCandidate
CodemapCode structure and impactSupported, or stale when its index reports drift
GlyphrunCLI and TUI verificationVerified or contradicted from a versioned run
CairntraceBrowser verificationVerified or contradicted from a versioned run
VidtraceVideo evidenceArtifact-backed support
file.cheapArtifact storagePreserves evidence; does not create truth by itself
TinyVaultSecret boundarySecurity state, never evidence content
MonitorAmbient and requested observabilityOperational support
BobRepository contract and convergenceClean, drift, conflict, blocked, or failed
VecLiteVector storageInternal capability, not an independent claim

Local Agent shows these as semantic tool receipts in one chronological transcript. A green transport receipt is never substituted for a domain result or verification outcome.

Connected runtime

Cortex

An evidence-guided engineering kernel for durable task state, bounded changes, and verification. Local Agent can use Cortex as the optional semantic advisor for durable goals, directly or through MCPHub. Local acceptance IDs and statements cross that boundary as typed, immutable acceptanceCriteria; they are never flattened into goal prose.

MCPHub

A single configuration and gateway for discovering MCP servers and synchronizing them to agent harnesses. MCPHub is the recommended gateway for Local Agent; it does not replace Local Agent's final approval policy.

The MCPHub website and source repository document the gateway, synchronization, and deployment workflow.

Discovery and local data

Codemap

Structural code maps, references, impact, and index freshness. Local Agent treats fresh structural results as support, while missing or stale indexes remain visible instead of being interpreted as negative evidence.

Vecgrep

Local-first semantic code search with Ollama embeddings, hybrid search, and an MCP surface. It is MCP-capable and related to Local Agent; it is not a native embedded search engine inside Local Agent.

TinyVault

A local-first secrets manager and MCP server in a Go binary. It can be configured through MCP; it is not bundled.

file.cheap

A local-first CLI and MCP file vault for storing, finding, compressing, and comparing workflow artifacts. It can be configured through MCP; it is not Local Agent's session store.

VecLite

An embeddable Go vector database with single-file storage, HNSW, BM25, and hybrid search. It is related infrastructure; Local Agent's current ICE store does not embed VecLite.

Evidence and verification

Glyphrun

Black-box testing for CLI and TUI workflows over a real pseudo-terminal and deterministic emulator. Local Agent uses Glyphrun as test infrastructure for its terminal contracts.

Cairntrace

Local-first behavioral browser specs for coding agents, with repairable steps and evidence-backed outcomes. It is a related verifier, not bundled into Local Agent.

Vidtrace

A local-first Go CLI that turns bug recordings into frames, OCR, transcripts, and timestamped evidence timelines.

Operations and building

Monitor

A terminal system monitor for macOS and Linux with a TUI, JSON CLI, and MCP surface. It can be configured through MCP; it is not a built-in resource scheduler.

Bob

A deterministic, model-free repository factory that turns a bob.yaml contract into owned infrastructure and detects drift in CI. It complements Local Agent's coding workflow but is not embedded.

Bob is built to be driven by agents. Run bob learn --json once at the start of a session for a machine-readable onboarding brief: every command, the exit-code contract (0 success, 2 conflicts, 3 drift without conflicts, 4 invalid input; plan always exits 0), the stable data.error.code values, and the recipe catalog. Every --json failure envelope carries copy-pasteable corrective commands in next_actions, and every plan action carries a stable code field for branching without parsing prose.

Bob's files recipe lets an agent declare an arbitrary file tree in bob.yaml — paths, modes, contents, and literal ${vars.key} substitution — and scaffold or reconcile any repository through Bob's plan/apply/lock conflict safety; bob recipe show files --json returns the schema with an example. When Bob is reached as a configured MCP tool, Local Agent reads its versioned structured result and keeps transport separate from clean, drift, conflict, blocked, and failed repository states.

The Bob website and source repository document its repository contracts and build workflow; the agent guide is the onboarding reference for coding agents.

Relationship rule

“MCP-capable” means a tool can be exposed through a configured MCP server. It does not mean Local Agent ships, authenticates, or silently trusts that tool. Every configured MCP call still crosses the Local Agent approval boundary.

Local-first by default. Approval-gated by design.