Skip to content

Minerva · Agent library operatorKnow when your agent stack is actually ready.

One control plane for skills, profiles, retrieval health, and evidence-backed next actions. Minerva reads the signals your tools already own—then gives operators an honest answer.

Minerva connecting library, stack, signal, MCP, proof, and profile systems
A small operator for a stack that is becoming anything but small.
01Shared library
02Readiness layers
00False greens
The operating problem

Installed is not the same as ready.

Your binaries can exist while indexes are stale, profiles drift, retrieval is hollow, and failures leave no trail. Minerva separates presence from readiness—then points to the tool that actually owns the fix.

One honest loop

From disk state to a defensible next action.

Minerva does not replace your runtime, gateway, graph, or evidence vault. It composes their public contracts into one operator view.

01 / DISCOVER

Read the shared library

Skills and agent profiles stay on the same ~/.agents tree your harness already consumes.

02 / PROBE

Interrogate the stack

Check real binary names, core tiers, deep health, index freshness, and gateway drift.

03 / PROVE

Keep outcome evidence

Save eval and readiness artifacts to fcheap with consistent, searchable attribution.

04 / ACT

Rank the next move

Turn owned signals into exact commands—without silently mutating another system.

Operator surface

A control plane that knows its place.

minerva / stack deep
$ minerva stack deep
probing core operators...
bob contract healthy
cortex 12 verified / 1 stale
mcphub routes synchronized
codemap index stale
vecgrep profile current
────────────────────────────
retrieval_ready: false
Truth before confidenceCodemap owns the next action. Minerva names it.
LIBRARY / SSOT

Skills and profiles, without a shadow state.

Create, compare, and organize the files your harness already loads. Activation semantics stay explicit.

MCP / STDIO

Operator intelligence for any harness.

Expose read-only diagnostics and approval-gated mutations through exact MCP routes.

Clear authority

Orchestrate. Never impersonate.

local-agentPrompt assembly, session skills, MCP trust
CortexTask evidence lifecycle and verification
MCPHubGateway, sync, routes, and call intelligence
Codemap + VecgrepGraph and semantic retrieval readiness
fcheapDurable artifacts and outcome evidence
MinervaLibrary state, readiness composition, ranked suggestions
Open source · Go CLI + MCP

Give your stack a source of truth.

Install Minerva, initialize the shared library, and get your first honest readiness report in four commands.

$ go install github.com/abdul-hamid-achik/minerva/cmd/minerva@latest
$ minerva init
$ minerva stack deep
$ minerva suggest

Know what is installed. Know what is ready. Act on evidence.