@eidola.app/cli 0.2.0 → 0.2.1

package/README.md

@@ -0,0 +1,56 @@
+# @eidola.app/cli
+
+Published npm package (`npm install -g @eidola.app/cli`) — unified `eidola` CLI for MCP server and Shrine HTTP display.
+
+Runs over stdio (`eidola mcp`) or browser Shrine (`eidola shrine`). Binds locally; never proxies API keys.
+
+**Packaging:** `@eidola/tool-state` is bundled into `dist/vendor/` (not published separately). Shrine server + Vite renderer ship in `dist/shrine/`; Three.js and Lottie are prebuilt into renderer assets — single `npm install -g @eidola.app/cli`, no peer packages.
+
+## Install
+
+```bash
+npm install -g @eidola.app/cli
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `eidola mcp` | MCP server over stdio |
+| `eidola shrine` | Shrine HTTP server at `http://127.0.0.1:9743/shrine` |
+
+## Cursor MCP config
+
+```json
+{
+  "mcpServers": {
+    "eidola": {
+      "command": "eidola",
+      "args": ["mcp"],
+      "env": {
+        "EIDOLA_ROOT": "/absolute/path/to/your/Eidola-folder"
+      }
+    }
+  }
+}
+```
+
+Unzip Engrams directly into your Eidola folder (no `engrams/` subfolder required for published installs).
+
+## Environment
+
+| Variable | Default | Description |
+|---|---|---|
+| `EIDOLA_ROOT` | cwd (published) or monorepo root (dev) | Shaper folder or repo root |
+| `EIDOLA_ENGRAMS_DIR` | `$EIDOLA_ROOT` (published) or `$EIDOLA_ROOT/engrams` (monorepo dev) | Engram scan path |
+| `EIDOLA_VESSELS_DIR` | `$EIDOLA_ROOT/vessels` | Vessel pack path |
+
+## Dev (monorepo)
+
+```bash
+pnpm install
+pnpm --filter eidola run build
+node scripts/setup-mcp-config.mjs
+```
+
+See [docs/mcp-install.md](../../../docs/mcp-install.md).

package/dist/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@eidola.app/cli",
+  "version": "0.2.1",
+  "type": "module",
+  "description": "Portable AI personality runtime — MCP server, Shrine display, and reactive Vessel control.",
+  "license": "MIT",
+  "keywords": [
+    "eidola",
+    "mcp",
+    "ai-persona",
+    "avatar",
+    "engram",
+    "vessel",
+    "model-context-protocol",
+    "cursor"
+  ],
+  "main": "index.js",
+  "types": "index.d.ts",
+  "bin": {
+    "eidola": "cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    },
+    "./server": {
+      "types": "./server.d.ts",
+      "import": "./server.js"
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "js-yaml": "^4.1.0",
+    "lottie-web": "^5.13.0",
+    "three": "^0.176.0",
+    "zod": "^4.4.3"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}