glirastes 0.3.2 → 0.5.0

package/dist/types.js

@@ -21,7 +21,7 @@ export function createUiActionSchema(extraSchemas = []) {
         .object({
         type: z.literal('run-client-action'),
         actionId: z.string().min(1),
-        payload: z.record(z.unknown()).optional(),
+        payload: z.record(z.string(), z.unknown()).optional(),
     })
         .strict();
     const navigateSchema = z
@@ -43,12 +43,40 @@ export function createUiActionSchema(extraSchemas = []) {
         return (typeof id === 'string' &&
             /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id));
     }, { message: 'Entity action must include valid {entity}Id (UUID)' });
-    return z.union([
+    // Results of the generated UI tools (`ui.navigate`, `ui.filter.<view>`,
+    // `ui.<actionId>`). The browser bridge checks the href again, and the app's
+    // contract checks a client action payload when it is dispatched.
+    const generatedNavigateSchema = z
+        .object({
+        type: z.literal('glirastes.navigate'),
+        actionId: z.literal('glirastes.navigate'),
+        payload: z.object({ href: z.string().startsWith('/').max(2_048) }).passthrough(),
+    })
+        .strict();
+    const generatedClientActionSchema = z
+        .object({
+        type: z.literal('glirastes.action'),
+        actionId: z.string().min(1).max(200),
+        payload: z.record(z.string(), z.unknown()),
+    })
+        .strict();
+    const builtInSchema = z.union([
         runClientActionSchema,
         navigateSchema,
-        ...extraSchemas,
+        generatedNavigateSchema,
+        generatedClientActionSchema,
         entityActionSchema, // Fallback — must be last
     ]);
+    return {
+        safeParse(value) {
+            for (const schema of extraSchemas) {
+                const result = schema.safeParse(value);
+                if (result.success)
+                    return result;
+            }
+            return builtInSchema.safeParse(value);
+        },
+    };
 }
 export function defineEndpointTool(definition) {
     return definition;

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsExB;;GAEG;AACH,MAAM,UAAU,UAAU,CAAoC,IAc7D;IACC,OAAO,IAAY,CAAC;AACtB,CAAC;AAiBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,eAA+B,EAAE;IAEjC,MAAM,qBAAqB,GAAG,CAAC;SAC5B,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;QACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;KAC1C,CAAC;SACD,MAAM,EAAE,CAAC;IAEZ,MAAM,cAAc,GAAG,CAAC;SACrB,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KACxB,CAAC;SACD,MAAM,EAAE,CAAC;IAEZ,4DAA4D;IAC5D,MAAM,kBAAkB,GAAG,CAAC;SACzB,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sCAAsC,CAAC;KAC/D,CAAC;SACD,WAAW,EAAE;SACb,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;QACP,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,GAAG,MAAM,IAAI,CAAC;QAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,CACL,OAAO,EAAE,KAAK,QAAQ;YACtB,iEAAiE,CAAC,IAAI,CACpE,EAAE,CACH,CACF,CAAC;IACJ,CAAC,EACD,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAClE,CAAC;IAEJ,OAAO,CAAC,CAAC,KAAK,CAAC;QACb,qBAAqB;QACrB,cAAc;QACd,GAAG,YAAY;QACf,kBAAkB,EAAE,0BAA0B;KACI,CAAC,CAAC;AACxD,CAAC;AAqGD,MAAM,UAAU,kBAAkB,CAIhC,UAAqD;IAErD,OAAO,UAAU,CAAC;AACpB,CAAC;AAsCD,MAAM,UAAU,YAAY,CAI1B,UAA+C;IAE/C,OAAO,UAAU,CAAC;AACpB,CAAC;AAoBD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA0B;IACvD,QAAQ,EAAE,CAAC;IACX,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,UAAU;CACtB,CAAC;AA8PF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,QAAwB;IAExB,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;QACzD,OAAO,QAAQ,CAAC,YAAY,CAAC;IAC/B,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC;QAC3C,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;IACnF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/embed/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../dist/cjs/embed/index.js",
+  "module": "../dist/embed/index.js",
+  "types": "../dist/embed/index.d.ts"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glirastes",
-  "version": "0.3.2",
+  "version": "0.5.0",
   "description": "Official Chainmatics SDK for building AI-powered chat, tools, and agent systems. Part of the Glirastes platform.",
   "license": "Apache-2.0",
   "author": {
@@ -31,7 +31,7 @@
     "react"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=20.6"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -62,6 +62,66 @@
         "default": "./dist/cjs/index.js"
       }
     },
+    "./contracts": {
+      "import": {
+        "types": "./dist/contracts/index.d.ts",
+        "default": "./dist/contracts/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/contracts/index.d.ts",
+        "default": "./dist/cjs/contracts/index.js"
+      }
+    },
+    "./runtime": {
+      "import": {
+        "types": "./dist/runtime/index.d.ts",
+        "default": "./dist/runtime/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/runtime/index.d.ts",
+        "default": "./dist/cjs/runtime/index.js"
+      }
+    },
+    "./runtime/ai-sdk": {
+      "import": {
+        "types": "./dist/runtime/ai-sdk/index.d.ts",
+        "default": "./dist/runtime/ai-sdk/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/runtime/ai-sdk/index.d.ts",
+        "default": "./dist/cjs/runtime/ai-sdk/index.js"
+      }
+    },
+    "./ai-sdk": {
+      "import": {
+        "types": "./dist/runtime/ai-sdk/index.d.ts",
+        "default": "./dist/runtime/ai-sdk/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/runtime/ai-sdk/index.d.ts",
+        "default": "./dist/cjs/runtime/ai-sdk/index.js"
+      }
+    },
+    "./stt": {
+      "import": {
+        "types": "./dist/stt/index.d.ts",
+        "default": "./dist/stt/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/stt/index.d.ts",
+        "default": "./dist/cjs/stt/index.js"
+      }
+    },
+    "./sync": {
+      "import": {
+        "types": "./dist/sync/index.d.ts",
+        "default": "./dist/sync/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/sync/index.d.ts",
+        "default": "./dist/cjs/sync/index.js"
+      }
+    },
     "./server": {
       "import": {
         "types": "./dist/server/index.d.ts",
@@ -82,25 +142,19 @@
         "default": "./dist/cjs/server/adapters/nextjs/index.js"
       }
     },
-    "./server/nestjs": {
+    "./adapter/nextjs": {
       "import": {
-        "types": "./dist/server/adapters/nestjs/index.d.ts",
-        "default": "./dist/server/adapters/nestjs/index.js"
+        "types": "./dist/server/adapters/nextjs/index.d.ts",
+        "default": "./dist/server/adapters/nextjs/index.js"
       },
       "require": {
-        "types": "./dist/cjs/server/adapters/nestjs/index.d.ts",
-        "default": "./dist/cjs/server/adapters/nestjs/index.js"
+        "types": "./dist/cjs/server/adapters/nextjs/index.d.ts",
+        "default": "./dist/cjs/server/adapters/nextjs/index.js"
       }
     },
     "./server/testing": {
-      "import": {
-        "types": "./dist/server/testing/index.d.ts",
-        "default": "./dist/server/testing/index.js"
-      },
-      "require": {
-        "types": "./dist/cjs/server/testing/index.d.ts",
-        "default": "./dist/cjs/server/testing/index.js"
-      }
+      "types": "./dist/server/testing/index.d.ts",
+      "default": "./dist/server/testing/index.js"
     },
     "./react": {
       "types": "./dist/react/index.d.ts",
@@ -110,26 +164,108 @@
       "types": "./dist/react/transports/vercel/index.d.ts",
       "default": "./dist/react/transports/vercel/index.js"
     },
-    "./react/langgraph": {
-      "types": "./dist/react/transports/langgraph/index.d.ts",
-      "default": "./dist/react/transports/langgraph/index.js"
-    },
     "./react/styles.css": "./dist/react/styles.css",
+    "./embed": {
+      "types": "./dist/embed/index.d.ts",
+      "default": "./dist/embed/index.js"
+    },
+    "./browser": {
+      "import": {
+        "types": "./dist/browser/index.d.ts",
+        "default": "./dist/browser/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/browser/index.d.ts",
+        "default": "./dist/cjs/browser/index.js"
+      }
+    },
     "./codegen": {
       "types": "./dist/codegen/index.d.ts",
       "default": "./dist/codegen/index.js"
-    },
-    "./openapi": {
-      "types": "./dist/openapi/index.d.ts",
-      "default": "./dist/openapi/index.js"
     }
   },
   "files": [
     "dist",
+    "!dist/openapi",
+    "!dist/cjs/openapi",
+    "!dist/server/adapters/nestjs",
+    "!dist/cjs/server/adapters/nestjs",
+    "!dist/react/transports/langgraph.*",
+    "!dist/react/transports/langgraph",
+    "!dist/cjs/react/transports/langgraph.*",
+    "!dist/cjs/react/transports/langgraph",
+    "!dist/codegen/skill-generator.*",
+    "!dist/cjs/codegen/skill-generator.*",
+    "!dist/codegen/mcp-generator.*",
+    "!dist/cjs/codegen/mcp-generator.*",
+    "!dist/codegen/output-recommender.*",
+    "!dist/cjs/codegen/output-recommender.*",
+    "!dist/codegen/asset-sync.*",
+    "!dist/cjs/codegen/asset-sync.*",
+    "!dist/codegen/nestjs-scanner.*",
+    "!dist/cjs/codegen/nestjs-scanner.*",
+    "!dist/codegen/endpoint-scanner.*",
+    "!dist/cjs/codegen/endpoint-scanner.*",
+    "!dist/codegen/ui-scanner.*",
+    "!dist/cjs/codegen/ui-scanner.*",
+    "!dist/codegen/module-generator.*",
+    "!dist/cjs/codegen/module-generator.*",
+    "!dist/codegen/validator.*",
+    "!dist/cjs/codegen/validator.*",
+    "!dist/codegen/coverage.*",
+    "!dist/cjs/codegen/coverage.*",
+    "!dist/codegen/scaffolder.*",
+    "!dist/cjs/codegen/scaffolder.*",
+    "!dist/cli/commands/check-upgrade.*",
+    "!dist/cjs/cli/commands/check-upgrade.*",
+    "!dist/cli/commands/test.*",
+    "!dist/cjs/cli/commands/test.*",
+    "!dist/cli/utils",
+    "!dist/cli/deferred-full.*",
+    "!dist/cjs/cli/utils",
+    "!dist/cjs/cli/deferred-full.*",
+    "!dist/endpoint-scanner.*",
+    "!dist/cjs/endpoint-scanner.*",
+    "!dist/route-scanner.*",
+    "!dist/cjs/route-scanner.*",
+    "!dist/ui-scanner.*",
+    "!dist/cjs/ui-scanner.*",
+    "!dist/module-generator.*",
+    "!dist/cjs/module-generator.*",
+    "!dist/validator.*",
+    "!dist/cjs/validator.*",
+    "!dist/coverage.*",
+    "!dist/cjs/coverage.*",
+    "!dist/scaffolder.*",
+    "!dist/cjs/scaffolder.*",
+    "!dist/format.*",
+    "!dist/cjs/format.*",
+    "!dist/fs-utils.*",
+    "!dist/cjs/fs-utils.*",
+    "!dist/skill-generator.*",
+    "!dist/cjs/skill-generator.*",
+    "!dist/mcp-generator.*",
+    "!dist/cjs/mcp-generator.*",
+    "!dist/output-recommender.*",
+    "!dist/cjs/output-recommender.*",
+    "!dist/asset-sync.*",
+    "!dist/cjs/asset-sync.*",
+    "!dist/nestjs-scanner.*",
+    "!dist/cjs/nestjs-scanner.*",
+    "contracts",
+    "runtime",
+    "ai-sdk",
+    "stt",
+    "sync",
     "server",
+    "!server/nestjs",
+    "adapter",
+    "!adapter/nestjs",
     "react",
+    "!react/langgraph",
+    "embed",
+    "browser",
     "codegen",
-    "openapi",
     "skills",
     "CHANGELOG.md",
     "CODE_OF_CONDUCT.md",
@@ -140,21 +276,25 @@
     "SECURITY.md"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && cp src/react/styles.css dist/react/styles.css && node -e \"require('fs').writeFileSync('dist/cjs/package.json', '{\\\"type\\\":\\\"commonjs\\\"}\\n')\" && node scripts/generate-subpath-shims.mjs",
+    "build": "node scripts/generate-embed-styles.mjs --check && tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && cp src/react/styles.css dist/react/styles.css && cp src/react/styles.css dist/cjs/react/styles.css && node -e \"require('fs').writeFileSync('dist/cjs/package.json', '{\\\"type\\\":\\\"commonjs\\\"}\\n')\" && node scripts/generate-subpath-shims.mjs && cp src/codegen/tools/probe-child.mjs src/codegen/tools/probe-loader.mjs dist/codegen/tools/ && cp src/codegen/tools/sources/fastapi-routes.py dist/codegen/tools/sources/",
     "typecheck": "tsc --noEmit",
+    "typecheck:tests": "tsc -p tsconfig.test.json",
     "test": "vitest run"
   },
   "dependencies": {
-    "zod": "^3.25.76",
+    "typescript": "^5.7.3",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "zod": "^4.0.0",
     "snowball-stemmers": "^0.6.0",
     "ai": "^6.0.0"
   },
   "peerDependencies": {
+    "@ai-sdk/openai": "^3",
     "react": "^18 || ^19",
     "react-dom": "^19",
     "@ai-sdk/react": "^3.0.0",
     "react-markdown": "^10.1.0",
-    "wavesurfer.js": "^7",
     "@nestjs/common": "^10 || ^11",
     "@nestjs/core": "^10 || ^11",
     "@nestjs/config": "^3 || ^4",
@@ -168,6 +308,9 @@
     "vitest": ">=2.0.0"
   },
   "peerDependenciesMeta": {
+    "@ai-sdk/openai": {
+      "optional": true
+    },
     "react": {
       "optional": true
     },
@@ -180,9 +323,6 @@
     "react-markdown": {
       "optional": true
     },
-    "wavesurfer.js": {
-      "optional": true
-    },
     "@nestjs/common": {
       "optional": true
     },
@@ -218,31 +358,32 @@
     }
   },
   "devDependencies": {
-    "typescript": "^5.7.3",
-    "vitest": "^4.0.18",
     "@ai-sdk/openai": "^3",
-    "@types/node": "^25.6.0",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "@types/express": "^5.0.0",
-    "@types/ws": "^8.5.0",
-    "@types/snowball-stemmers": "^0.6.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
     "@ai-sdk/react": "^3.0.0",
-    "react-markdown": "^10.1.0",
-    "wavesurfer.js": "^7.12.1",
     "@nestjs/common": "^11.0.0",
-    "@nestjs/core": "^11.0.0",
     "@nestjs/config": "^4.0.0",
+    "@nestjs/core": "^11.0.0",
     "@nestjs/passport": "^11",
     "@nestjs/swagger": "^11.4.1",
-    "next": "^15.0.0",
+    "@testing-library/react": "^16.3.2",
+    "@types/express": "^5.0.0",
+    "@types/node": "^25.6.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@types/snowball-stemmers": "^0.6.0",
+    "@types/ws": "^8.5.0",
+    "class-transformer": "^0.5.0",
+    "class-validator": "^0.15.1",
     "express": "^5.0.0",
+    "jsdom": "^28.1.0",
+    "next": "^15.0.0",
     "passport": "^0.7",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-markdown": "^10.1.0",
+    "reflect-metadata": "^0.2.0",
+    "vitest": "^4.0.18",
     "ws": "^8.0.0",
-    "class-validator": "^0.15.1",
-    "class-transformer": "^0.5.0",
-    "reflect-metadata": "^0.2.0"
+    "zod-v3": "npm:zod@3.25.76"
   }
 }

package/runtime/ai-sdk/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../../dist/cjs/runtime/ai-sdk/index.js",
+  "module": "../../dist/runtime/ai-sdk/index.js",
+  "types": "../../dist/runtime/ai-sdk/index.d.ts"
+}

package/runtime/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../dist/cjs/runtime/index.js",
+  "module": "../dist/runtime/index.js",
+  "types": "../dist/runtime/index.d.ts"
+}

package/skills/README.md

@@ -1,107 +1,41 @@
 # Glirastes Agent Skills
 
-Pre-built [agent skills](https://docs.claude.com/en/docs/claude-code/skills) that teach a coding agent (Claude Code, Codex, Cursor, …) how to integrate, maintain, and customize the Glirastes SDK in a real codebase. Drop them into your repo's `.claude/skills/` (or your agent's equivalent), and the agent picks the right one automatically based on the task.
-
-Skills are a separate concept from `glirastes generate-skills`:
-
-- **`generate-skills` (CLI command)** — turns *your tools* into skill files so external agents can call your tools.
-- **These skills (this directory)** — instruct an agent on how to *integrate Glirastes itself* into a project.
-
-## Available skills
+The package ships seven skills for the app's existing coding agent. Glirastes
+never calls a model: the CLI derives tools from the code and prints work
+lists, the skills tell the agent how to work through them.
 
 | Skill | Use when |
 |---|---|
-| [`integrating-glirastes-nextjs`](./integrating-glirastes-nextjs/SKILL.md) | Adding chat to a Next.js App Router app where Next.js is the only backend. |
-| [`integrating-glirastes-nestjs`](./integrating-glirastes-nestjs/SKILL.md) | Adding chat to a NestJS backend (with or without a separate frontend). |
-| [`integrating-glirastes-nextjs-with-nestjs-backend`](./integrating-glirastes-nextjs-with-nestjs-backend/SKILL.md) | Full-stack setup: Next.js frontend in one workspace, separate NestJS backend in another. |
-| [`maintaining-glirastes-tools`](./maintaining-glirastes-tools/SKILL.md) | Authoring `ai-tool.ts` / `ai-ui-tool.ts`, intent modules, codegen pipeline, all CLI commands. |
-| [`building-glirastes-chat-ui`](./building-glirastes-chat-ui/SKILL.md) | Customizing the chat UI — theming, mentions, voice input, approval cards, action bus. |
-
-The three `integrating-*` skills are mutually exclusive: pick the one that matches your stack. The other two are stack-agnostic.
+| [`setting-up-glirastes`](./setting-up-glirastes/SKILL.md) | Starting or resuming an integration after `glirastes init` |
+| [`integrating-glirastes-nextjs`](./integrating-glirastes-nextjs/SKILL.md) | Wiring chat, tools, navigation, filters and metrics in a Next.js App Router app |
+| [`integrating-glirastes-web`](./integrating-glirastes-web/SKILL.md) | A separate backend, a non-React frontend or a Node sidecar |
+| [`maintaining-glirastes-tools`](./maintaining-glirastes-tools/SKILL.md) | Resolving `glirastes tools resolve --print` findings and policy proposals |
+| [`describing-glirastes-tools`](./describing-glirastes-tools/SKILL.md) | Writing descriptions, schemas, synonyms and examples from `glirastes tools describe --print` |
+| [`building-glirastes-chat-ui`](./building-glirastes-chat-ui/SKILL.md) | Chat UI, the derived `@` entities and `/` commands (served by `createChatInteractionsHandler`, with direct commands), providers, result components, approvals and STT |
+| [`migrating-to-glirastes`](./migrating-to-glirastes/SKILL.md) | Moving off `@chainmatics/agentic-*` and `ai-tool.ts` |
 
-## Installing into your project
-
-These skills ship with the npm package, so they're always in sync with the SDK version you've installed. Use the bundled CLI installer:
+Install project-local copies with:
 
 ```bash
-# Project-local: all skills into ./.claude/skills (default)
-npx glirastes install-skills
-
-# Global: into ~/.claude/skills — picked up by every Claude Code session on this machine
-npx glirastes install-skills --global         # short: -g
-
-# Stack-filtered — only the skills relevant to your setup
-npx glirastes install-skills --stack nextjs               # Next.js standalone
-npx glirastes install-skills --stack nestjs               # NestJS standalone
-npx glirastes install-skills --stack nextjs+nestjs        # Next.js + NestJS monorepo
-npx glirastes install-skills --stack all                  # explicit "all" (default)
-
-# Combine: global + stack filter
-npx glirastes install-skills -g --stack nextjs+nestjs
-
-# Different agent? Pass --target (mutually exclusive with --global)
-npx glirastes install-skills --target .codex/skills
-
-# Symlink mode — skills auto-update when you bump glirastes
-npx glirastes install-skills --symlink
-
-# Preview without writing
-npx glirastes install-skills --dry-run
-
-# Overwrite previously installed skills
-npx glirastes install-skills --force
+npx --no-install glirastes init
 ```
 
-| Flag | Effect |
-|---|---|
-| *(default)* | Install into `./.claude/skills` relative to the current project. |
-| `-g`, `--global` | Install into `~/.claude/skills` so every project on this machine sees the skills. Mutually exclusive with `--target`. |
-| `--target <dir>` | Override the destination. Accepts relative or absolute paths and `~/`-prefixed paths. |
-| `--stack <name>` | `nextjs` \| `nestjs` \| `nextjs+nestjs` \| `all` (default). Filters which skills are installed. |
-| `--symlink` | Symlink instead of copy — skills track the installed `glirastes` version automatically on `npm install`. |
-| `--force` | Overwrite skills that already exist at the target. |
-| `--dry-run` | Print what would happen without writing anything. |
-
-### Project-local vs global — which to pick?
+Run it in the app's existing Codex/Claude session or select an installed CLI
+from an interactive terminal with `--agent codex` or `--agent claude`. It
+writes `.glirastes/tools.json`, `.glirastes/prompt-bundle.json`, the
+`predev`/`prebuild` scripts and a short hint in `AGENTS.md`/`CLAUDE.md` where
+they are missing, installs the skills and continues in the agent.
+`--dry-run --json` previews without writing or launching anything.
 
-- **Project-local** (default): each project sees skills tied to its own installed `glirastes` version. Best when teams collaborate via git — the project's `.claude/skills` is checked in (or symlinked, then `.gitignore`d).
-- **Global** (`-g`): one install per developer machine, shared across every project. Best for a solo dev who works on multiple Glirastes projects and wants consistency without re-running the installer per project.
-
-Both modes can coexist. Project-local skills override global skills when the same name is present in both.
-
-### Manual install (no CLI)
-
-If you prefer not to use the installer:
-
-```bash
-mkdir -p .claude/skills
-cp -r node_modules/glirastes/skills/*/ .claude/skills/
-```
-
-Or symlink:
+For skill installation only, use the installed Foundation CLI:
 
 ```bash
-mkdir -p .claude/skills
-for skill in node_modules/glirastes/skills/*/; do
-  ln -sf "$(pwd)/$skill" ".claude/skills/$(basename "$skill")"
-done
+npx --no-install glirastes install --host codex --with-setup-skills
 ```
 
-## Skill authoring
-
-If you fork or extend a skill, follow the [Anthropic skill creator best practices](https://github.com/anthropics/anthropic-cookbook/tree/main/agents/agent-skills):
-
-- Use the verb-ing-noun naming pattern (`integrating-glirastes-nextjs`, not `glirastes-nextjs-helper`)
-- Keep `SKILL.md` under ~500 lines — split deep references into sibling files, one level deep
-- Frontmatter `description` must be third-person and include the trigger condition
-- Include code snippets you can adapt, not just abstract guidance
-
-## Reporting issues / suggesting improvements
-
-These skills evolve with the SDK. If a skill steers an agent toward an outdated API, [open an issue](https://github.com/chainmatics/glirastes/issues) with:
-
-1. The skill name
-2. The agent's incorrect output
-3. The correct API for the current SDK version
-
-Pull requests welcome.
+Hosts install into `.agents/skills` (Codex), `.claude/skills` (Claude), or
+`.gemini/skills` (Gemini). Owned, unchanged copies refresh; customized copies
+are preserved and never force-replaced. The supported stacks and their test
+status are listed in `integrating-glirastes-web`; manifest detection and skill
+installation alone do not prove an integration. Use this Foundation package,
+not an unrelated registry package sharing its version number.