Agentgem

▶  Watch the 60-second reel

> A local web UI that introspects your coding-agent config, redacts secrets at > capture, and builds a portable, composable Gem. > > agentgem.ninemind.ai

AgentGem reads your coding-agent config — skills, MCP servers, and CLAUDE.md — redacts secrets the moment they're read, and produces a Gem: a manifest + lock archive you can publish to a GitHub-backed registry, merge with other Gems, and deploy to several targets. A browser can't read ~/.claude (it's sandboxed), so AgentGem runs a small server on your machine; secrets never leave your device — what crosses any boundary is a config shape with `` in place of every sensitive value.

Built on AgentBack, ninemind's AI-native API/MCP framework: every operation is defined once as a Zod contract and exposed as a REST endpoint, an MCP tool, and an OpenAPI 3.1 document — so the web page and your local agent call exactly the same thing.

What it provides

• Secret-safe capture — redaction by value and by key name, before anything reaches a

REST response, an MCP result, the live preview, or the built Gem.

• A neutral Gem source — a manifest + lock archive that isn't tied to any runtime.

Build once; install into a local testbed, merge, publish, or compile to a target without re-reading raw config.

• Composition — the manifest/lock split lets small, focused Gems be reconciled into

larger agents with a single re-resolved lock, not a pile of overlapping config.

• Workflow-aware recommendations — [Analyze](docs/analyze.md) scans your agent's

session history to see which skills, MCP servers, and hooks you actually use, and suggests ready-to-build Gems grouped by recurring workflow. It also distills brand-new draft skills from the procedures you repeat by hand — review them and fold them straight into a Gem.

• Deploy targets — Eve and OpenAI Sandbox (code-gen), Flue (materialize, deployable to

Cloudflare), and Bedrock AgentCore (managed backend); code-gen targets share a common compose step.

• Agent-to-agent (A2A) — export a Gem as an [A2A](docs/a2a.md) Agent Card or a

runnable A2A server so other agents can discover and call it.

• A native desktop app — a [macOS/Windows/Linux build](docs/desktop.md) alongside the

npx CLI, hosting the same local server in its own window.

• A GitHub-backed registry — publish, resolve, merge, and install composable Gems over

the same archive format.

• An agent-native path — every operation is also an MCP tool, so your local agent can

build Gems over /mcp with no browser involved.

Quickstart

Needs Node.js ≥ 22. From the directory of the agent project you want to package, run it without installing:

npx @ninemind/agentgem         # npm
pnpm dlx @ninemind/agentgem    # pnpm

agentgem listening at http://127.0.0.1:4317
  UI:       http://127.0.0.1:4317/
  API:      http://127.0.0.1:4317/api/inventory  ·  POST http://127.0.0.1:4317/api/gem
  Explorer: http://127.0.0.1:4317/explorer/
  MCP:      http://127.0.0.1:4317/mcp

Open ****, then:

1. Open a testbed — click Create / open testbed…. AgentGem detects the project

you launched from (it has a .claude/.codex) and also lists ones from your Claude/Codex session history. Pick it and click Use this.

1. Pick artifacts — the project's skills / MCP servers / CLAUDE.md show on the

left; Import from machine… pulls in global ones. Tick what you want, name the Gem.

1. Watch it seal — the live gem.json renders with every secret as ``.

Download it — that archive is what every target and the registry consume.

" width="100%">

Prefer a persistent command? Install it globally:

npm install -g @ninemind/agentgem     # npm
pnpm add -g @ninemind/agentgem        # pnpm
agentgem --port 8080                  # honors $PORT; append ?dir=/path/to/.claude for another config

| Path | What it is | | ----------- | ------------------------------------------------------- | | / | The Gem Builder web UI | | /explorer | Swagger UI for the REST API (from the OpenAPI document) | | /mcp | The MCP endpoint — the same contract, for your agent |

From source

To hack on AgentGem, clone the repo. It's a pnpm project (npm works too), and AgentBack uses legacy decorators, so it builds with tsc then runs dist/:

pnpm install     # or: npm install
pnpm dev         # or: npm run dev   — build + start in one step
pnpm test        # or: npm test      — tsc -b && vitest run, against compiled dist/
pnpm clean       # or: npm run clean — rm -rf dist *.tsbuildinfo (run before re-testing after moves)

See [CONTRIBUTING.md](CONTRIBUTING.md) for the full workflow.

Desktop app

Prefer a double-click app over the CLI? AgentGem ships a native desktop build for macOS, Windows, and Linux — download it from Releases (a desktop-v* build). It hosts the same local server in its own window, adds a native folder picker, app menu, and system tray, and never sends secrets off your machine.

> The builds are currently unsigned: on macOS right-click → Open, on Windows > choose More info → Run anyway the first time.

To run or package it from source, see the [desktop guide](docs/desktop.md) — in short, pnpm -C desktop dev to run, pnpm -C desktop dist to build installers.

Layering

Depends on AgentBack: @agentback/core (lifecycle), @agentback/rest + @agentback/rest-explorer (HTTP + Swagger UI), @agentback/mcp + @agentback/mcp-http (MCP over HTTP), and @agentback/openapi (the OpenAPI 3.1 document). The web UI, the REST API, and the MCP endpoint are three boundaries over one set of Zod contracts — src/index.ts wires them onto a single RestApplication.

For deeper reference, see [docs/](docs/index.md): [getting started](docs/getting-started.md) · [desktop app](docs/desktop.md) · [analyze](docs/analyze.md) · [concepts](docs/concepts.md) · [targets & deploy](docs/targets.md) · [A2A](docs/a2a.md) · [registry](docs/registry.md).

License

[MIT](LICENSE) © ninemind.ai

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ninemindai
• Source: ninemindai/agentgem
• License: MIT
• Homepage: https://agentgem.ai

Install and usage instructions live in the source repository linked above.