Skip to main content
Glama
abdul-hamid-achik

Minerva

by abdul-hamid-achik
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Go
Local

Minerva

Release Changelog

Skill intelligence for agent harnesses. Minerva reads conversations and tool calls from Claude Code, Codex, Cursor, OpenCode, Copilot, Gemini, and sonar — then proposes SKILL.md files and keeps the canonical ~/.agents/skills library in sync.

It is not a second agent runtime, not Cortex, and not a monitor for companion CLIs.

Built with Go + Cobra + MCP stdio.

What Minerva does

Surface

Role

Sessions

Discover and parse harness transcripts (JSONL / JSON)

Analyze

Deterministic signals: retries, corrections, load-gaps, tool n-grams

Propose

Ranked new_skill / update_skill / load_gap drafts with evidence

Skills

Create/list/show/compare/delete/lint under ~/.agents/skills/

Sync

Link or copy skills into writable harness dirs; doctor drift

MCP

Compact stdio surface for harnesses / MCPHub

Related MCP server: OSource-Manager

Quick start

Prerequisites

Install / build

# Homebrew (recommended for macOS and Linux)
brew install --cask abdul-hamid-achik/tap/minerva

# From source
task build              # bin/minerva
# or
go install github.com/abdul-hamid-achik/minerva/cmd/minerva@latest

Initialize

minerva init

Creates:

~/.agents/
  skills/       # skill definitions (SKILL.md)
  .minerva/     # proposal store and local cache

Override the library root with MINERVA_AGENTS_DIR. Override the home used to find harness session files with MINERVA_HOME (tests should set both).

CLI

minerva learn
minerva harness list
minerva harness doctor
minerva sessions --since 7d --harness claude
minerva analyze --last --json
minerva propose --since 30d
minerva propose apply <proposal-id>

minerva skill list
minerva skill show <name>
minerva skill resolve "review this PR"
minerva skill create <name> [content] [-d description]
minerva skill update <name> [--content body|--from-file path]
minerva skill lint
minerva skill install owner/repo[/path]
minerva skill sync --to claude,codex --dry-run

MCP

minerva mcp serve

Eight tools: minerva_learn, minerva_sessions, minerva_analyze, minerva_propose, minerva_resolve_skill, minerva_skill, minerva_harness, minerva_apply. Only minerva_apply writes disk.

Wire via MCPHub:

servers:
  minerva:
    command: minerva
    args: [mcp, serve]
    enabled: true

Architecture

cmd/minerva/
internal/
  cli/           Cobra commands
  mcp/           MCP stdio server
  skill/         SKILL.md discovery + CRUD + resolve
  harness/       Runtime catalog (paths, capabilities)
  session/       Transcript adapters → Trace
  signal/        Deterministic extractors
  propose/       Signals → SKILL.md drafts
  sync/          Cross-harness link/copy + lockfile
  library/       Skill lint
  surface/       Compact MCP contract

Canonical skills live in ~/.agents/skills. Harness copies/symlinks are derived. Cursor's ~/.cursor/skills-cursor is treated as harness-owned and is never overwritten.

Development

task build
task test
task lint
task glyph-fast
task docs:dev      # VitePress site → http://127.0.0.1:5173

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • skillmcp

    yulinlina
    A
    license
    Not graded
    quality
    C
    maintenance
    Turns any folder of agent skills into a live MCP server, exposing skills_list, skills_get, and skills_search tools with zero-dependency stdio support.
    MIT

  • skillcp

    lum1n
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables managing a canonical library of agent skills and MCP servers, syncing them across multiple development harnesses, and adding, importing, or configuring them through MCP tools.
    14 npm
    MIT