@ninemind/agentgem 0.1.0 → 0.1.1

package/README.md

@@ -3,9 +3,10 @@
 </p>
 
 <p align="center">
+  <a href="https://www.npmjs.com/package/@ninemind/agentgem"><img src="https://img.shields.io/npm/v/%40ninemind%2Fagentgem?color=9a3324&label=npm" alt="npm version"></a>
   <a href="https://github.com/ninemindai/agentgem/actions/workflows/ci.yml"><img src="https://github.com/ninemindai/agentgem/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-9a3324" alt="MIT license"></a>
-  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-LTS-1f6b4f" alt="Node LTS"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/%40ninemind%2Fagentgem?color=1f6b4f" alt="Node version"></a>
   <a href="https://agentback.dev"><img src="https://img.shields.io/badge/built_on-AgentBack-b08436" alt="Built on AgentBack"></a>
   <a href="docs/concepts.md"><img src="https://img.shields.io/badge/MCP-native-211c15" alt="MCP-native"></a>
 </p>
@@ -44,21 +45,17 @@ call exactly the same thing.
 - **An agent-native path** — every operation is also an MCP tool, so your local agent can
   build Gems over `/mcp` with no browser involved.
 
-## Usage
+## Quickstart
 
-Requires Node.js ≥ 22 and a coding-agent config at `~/.claude`.
+Needs Node.js ≥ 22. From the directory of the agent project you want to package,
+run it without installing:
 
 ```bash
-npx @ninemind/agentgem              # run without installing
-# or install the `agentgem` command globally:
-npm install -g @ninemind/agentgem
-agentgem                            # → http://127.0.0.1:4317
-agentgem --port 8080                # override the port (also honors $PORT)
+npx @ninemind/agentgem         # npm
+pnpm dlx @ninemind/agentgem    # pnpm
 ```
 
-The server starts on `127.0.0.1` (default port `4317`) and prints:
-
-```
+```text
 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
@@ -66,29 +63,45 @@ agentgem listening at http://127.0.0.1:4317
   MCP:      http://127.0.0.1:4317/mcp
 ```
 
+Open **<http://127.0.0.1:4317/>**, 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*.
+2. **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.
+3. **Watch it seal** — the live `gem.json` renders with every secret as `<redacted>`.
+   Download it — that archive is what every target and the registry consume.
+
+<p align="center">
+  <img src="docs/screenshot.png" alt="The AgentGem Gem Builder: selected skills and MCP servers on the left, the live gem.json on the right with every secret shown as <redacted>" width="100%">
+</p>
+
+Prefer a persistent command? Install it globally:
+
+```bash
+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    |
 
-Open `/`, tick the skills / MCP servers / `CLAUDE.md` you want, name the Gem, and watch
-the live `gem.json` render with secrets already shown as `<redacted>`. Download it — that
-archive is what every target and the registry consume.
-
-Append `?dir=/path/to/.claude` to introspect a config directory other than the
-default `~/.claude`.
-
 ### From source
 
-To hack on AgentGem, clone the repo and use [pnpm](https://pnpm.io/) (AgentBack
-uses legacy decorators, so it builds with `tsc`, then runs `dist/`):
+To hack on AgentGem, clone the repo. It's a [pnpm](https://pnpm.io/) project
+(`npm` works too), and AgentBack uses legacy decorators, so it builds with `tsc`
+then runs `dist/`:
 
 ```bash
-pnpm install
-pnpm dev        # build + start in one step (→ node dist/index.js)
-pnpm test       # tsc -b && vitest run — tests run against compiled dist/
-pnpm clean      # rm -rf dist *.tsbuildinfo (run before testing after renames/moves)
+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.

package/dist/public/index.html

@@ -3,6 +3,7 @@
 <head>
 <meta charset="utf-8" /><meta name="viewport" content="width=device-width,initial-scale=1" />
 <title>agentgem — Gem Builder</title>
+<link rel="icon" type="image/svg+xml" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 40 40' fill='none'><path d='M20 2 L36 14 L20 38 L4 14 Z' fill='%239a3324'/><path d='M20 2 L36 14 L20 16 Z' fill='%23bb4a38'/><path d='M20 2 L4 14 L20 16 Z' fill='%237d2a1e'/><path d='M4 14 L20 16 L20 38 Z' fill='%238b2e21'/><path d='M36 14 L20 16 L20 38 Z' fill='%23a8392a'/><path d='M4 14 L36 14 L20 16 Z' fill='%23c8543f'/></svg>" />
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
 <link href="https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght@9..144,400;9..144,500;9..144,600;9..144,700&family=Hanken+Grotesk:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ninemind/agentgem",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A local web UI that introspects your coding-agent config, redacts secrets at capture, and builds a portable, composable Gem.",
   "license": "MIT",
   "bin": {