@untitled-devs/wasla 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mohamed SAEED HAMMAD
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,431 @@
+
+```
+██╗    ██╗ █████╗ ███████╗██╗      █████╗      ██████╗ ███████╗███╗   ██╗██╗███████╗
+██║    ██║██╔══██╗██╔════╝██║     ██╔══██╗    ██╔════╝ ██╔════╝████╗  ██║██║██╔════╝
+██║ █╗ ██║███████║███████╗██║     ███████║    ██║  ███╗█████╗  ██╔██╗ ██║██║█████╗  
+██║███╗██║██╔══██║╚════██║██║     ██╔══██║    ██║   ██║██╔══╝  ██║╚██╗██║██║██╔══╝  
+╚███╔███╔╝██║  ██║███████║███████╗██║  ██║    ╚██████╔╝███████╗██║ ╚████║██║███████╗
+ ╚══╝╚══╝ ╚═╝  ╚═╝╚══════╝╚══════╝╚═╝  ╚═╝     ╚═════╝ ╚══════╝╚═╝  ╚═══╝╚═╝╚══════╝
+```
+<div align="center">
+
+**وصل جيني** — *One skill layer. Every AI orchestrator. Zero duplication.*
+
+[![MIT License](https://img.shields.io/badge/license-MIT-00C896?style=flat-square)](LICENSE)
+[![GitHub](https://img.shields.io/badge/github-The--Untitled--Org-00C896?style=flat-square&logo=github)](https://github.com/The-Untitled-Org/wasla-genie)
+[![CI & Docs Deployment](https://github.com/The-Untitled-Org/wasla-genie/actions/workflows/ci-docs.yml/badge.svg)](https://github.com/The-Untitled-Org/wasla-genie/actions/workflows/ci-docs.yml)
+[![Coverage](https://codecov.io/gh/The-Untitled-Org/wasla-genie/branch/main/graph/badge.svg)](https://codecov.io/gh/The-Untitled-Org/wasla-genie)
+[![Status](https://img.shields.io/badge/status-alpha-orange?style=flat-square)]()
+[![Contributors](https://img.shields.io/github/contributors/The-Untitled-Org/wasla-genie?style=flat-square&color=00C896)](https://github.com/The-Untitled-Org/wasla-genie/graphs/contributors)
+
+</div>
+
+---
+
+## ❗ The Problem
+
+You work across multiple AI orchestrators — **Claude Code**, **Gemini CLI**, and **OpenClaw**.
+
+Each one is its own universe.
+
+```
+You build an agent in Gemini CLI.
+You open Claude Code.
+It knows nothing about it.
+
+You configure an MCP in Claude Code.
+You open Codex.
+Gone.
+
+You write a skill, a command, a cron job — in one tool.
+Every other tool: blank slate.
+```
+
+There is no shared layer. Every orchestrator hoards what lives inside it.  
+You end up **copy-pasting configs, duplicating agent definitions, and maintaining the same thing in five places** — and the moment one changes, everything else is out of date.
+
+---
+
+## ✨ What WaslaGenie Does
+
+WaslaGenie syncs assets across orchestrators from the CLI. Helper skill registration is optional.
+
+When sync is triggered — manually (`sync`) or continuously (`watch`) — WaslaGenie:
+
+1. **Scans** the known config directories of every supported orchestrator on your machine  
+   (`~/.claude/`, `~/.gemini/`, `~/.openclaw/`)
+2. **Discovers** all agents and MCPs — wherever they were originally created
+3. **Mirrors the full content** into every other tool's equivalent directory using the **"Latest is Greatest"** strategy.
+4. **No more duplication.** Whichever tool you used most recently to edit the asset becomes the source of truth for the next sync.
+
+> Full content mirroring. No complex imports. No duplication.  
+> Just seamless synchronization that lets each tool use what the other built.
+
+---
+
+## 🔬 How Cross-Referencing Works
+
+Say you create an agent inside Gemini CLI:
+
+```
+~/.gemini/agents/researcher.md   ← original, owned by Gemini
+```
+
+After `waslagenie sync`, WaslaGenie writes a minimal stub into every other tool:
+
+```
+~/.claude/agents/researcher.md   ← stub, written by WaslaGenie
+~/.codex/agents/researcher.md    ← stub, written by WaslaGenie
+~/.openclaw/agents/researcher.md ← stub, written by WaslaGenie
+```
+
+Each stub contains only the minimum that native tool needs to load the original:
+
+```markdown
+---
+# researcher
+waslagenie_ref: ~/.gemini/agents/researcher.md
+origin: gemini
+---
+Refer to source definition at ~/.gemini/agents/researcher.md
+```
+
+Claude Code reads its stub → loads the Gemini original → agent is live.  
+**Zero bytes duplicated. Zero maintenance.**
+
+The same pattern applies across every asset type:
+
+```
+~/.gemini/agents/       →  stubs written to  .claude  .codex  .openclaw  .hermes
+~/.claude/mcp/          →  stubs written to  .gemini  .codex  .openclaw  .hermes
+~/.codex/skills/        →  stubs written to  .claude  .gemini  .openclaw  .hermes
+~/.openclaw/commands/   →  stubs written to  .claude  .gemini  .codex  .hermes
+~/.hermes/crons/        →  stubs written to  .claude  .gemini  .codex  .openclaw
+```
+
+**Source of truth = the tool that created it first. Always. Forever.**
+
+---
+
+## 🗂️ What Gets Synced
+
+| Asset | Scanned From | Synced To |
+|---|---|---|
+| **Agents / Sub-agents** | `~/.{tool}/agents/` | All other tools' agent dirs |
+| **MCP Servers** | `~/.{tool}/mcp/` | All other tools' MCP configs |
+
+---
+
+## 🚀 Installation
+
+WaslaGenie is cross-platform via `npx` — no global install required:
+
+```bash
+npx wasla-genie sync
+```
+
+This runs the CLI directly. It does not register helper skills inside Claude, Gemini, or other tools.
+
+**Or install globally:**
+
+```bash
+npm install -g wasla-genie
+waslagenie sync
+```
+
+Optional helper registration:
+
+```bash
+waslagenie register
+```
+
+`register` detects supported orchestrators and adds the WaslaGenie helper skill inside each one.
+Use `waslagenie register --to claude` (or comma-separated targets) to install only specific providers.
+
+---
+
+## 🧭 Which Command When
+
+### End users (installed package)
+
+```bash
+# Run once on demand
+waslagenie sync
+
+# Keep syncing while you work
+waslagenie watch
+
+# Optional: install helper skill in all detected providers
+waslagenie register
+
+# Optional: install helper skill in specific providers only
+waslagenie register --to claude,gemini
+```
+
+You can also run without global install:
+
+```bash
+npx wasla-genie sync
+```
+
+### You (developing this repo)
+
+```bash
+# Build + run sync (workspace scope) using your local source
+npm run sync
+
+# Build + run watch (workspace scope)
+npm run watch
+```
+
+Use `npm run ...` while developing because it runs your local code (`dist`) after build.
+
+### Do I need to reinstall after code changes?
+
+If you run through `npm run ...` in this repo: **No reinstall needed**. Just run the script again; it rebuilds.
+
+If you installed globally with `npm install -g wasla-genie`: **Yes**, reinstall (or relink) to test your latest local changes.
+
+For local development without repeated global installs:
+
+```bash
+npm link
+waslagenie sync
+```
+
+Then after code changes, run `npm run build` (or any script that builds) and use `waslagenie` again.
+
+---
+
+## ⚡ Usage
+
+### One-time sync
+
+```bash
+waslagenie sync
+```
+
+```
+🔍  Scanning ~/.claude/     →  3 agents, 2 MCPs, 4 commands
+🔍  Scanning ~/.gemini/     →  5 agents, 1 MCP,  2 skills
+🔍  Scanning ~/.codex/      →  1 agent,  3 commands
+🔍  Scanning ~/.openclaw/   →  2 agents, 2 crons
+🔍  Scanning ~/.hermes/     →  1 agent,  1 skill
+
+✔   Stubs written to ~/.claude/     →  6 new references
+✔   Stubs written to ~/.gemini/     →  4 new references
+✔   Stubs written to ~/.codex/      →  7 new references
+✔   Stubs written to ~/.openclaw/   →  5 new references
+✔   Stubs written to ~/.hermes/     →  8 new references
+
+✨  Sync complete — 30 cross-references written, 0 files duplicated
+```
+
+---
+
+### Automatic background sync — watch mode
+
+`waslagenie watch` is the background sync process. It watches for file changes across all tool directories while the command is running.
+
+```
+[watch starts] → WaslaGenie process launched
+[File changes] → WaslaGenie detects change and syncs immediately
+[watch stops]  → WaslaGenie process exits cleanly
+```
+
+```
+👁  WaslaGenie active (session: Claude Code)
+    Monitoring: ~/.claude  ~/.gemini  ~/.codex  ~/.openclaw
+
+[14:32:01]  New agent detected → ~/.gemini/agents/planner.md
+[14:32:01]  Syncing stubs     → .claude ✔  .codex ✔  .openclaw ✔
+
+[15:10:44]  Agent updated     → ~/.claude/agents/researcher.md (Latest is Greatest)
+[15:10:44]  Syncing stubs     → .gemini ✔  .codex ✔  .openclaw ✔
+```
+
+No restart. No manual trigger. The moment something changes — it's everywhere.
+
+---
+
+### Scope — workspace or user level
+
+```bash
+# Sync only within current project workspace
+waslagenie sync --scope workspace
+
+# Sync across your entire user space (default)
+waslagenie sync --scope user
+```
+
+---
+
+### Status — see everything and where it lives
+
+```bash
+waslagenie status
+```
+
+```
+ASSET              TYPE       ORIGIN      SYNCED TO
+researcher         agent      gemini      claude ✔  codex ✔  openclaw ✔  hermes ✔
+planner            agent      claude      gemini ✔  codex ✔  openclaw ✔  hermes ✔
+notion-mcp         mcp        claude      gemini ✔  codex ✔  openclaw ✔
+web-scraper        skill      codex       claude ✔  gemini ✔  openclaw ✔  hermes ✔
+daily-standup      cron       gemini      claude ✔  codex ✔
+review-pr          command    openclaw    claude ✔  gemini ✔  codex ✔  hermes ✔
+```
+
+---
+
+## 🧩 Supported Orchestrators
+
+### CLI / Terminal Agents
+
+| Tool | Auto-detect | Scan | Sync | Skill Install | Daemon |
+|---|---|---|---|---|---|
+| **Claude Code** | ✅ | ✅ | ✅ | ✅ | ✅ |
+| **Gemini CLI** | ✅ | ✅ | ✅ | ✅ | ✅ |
+| **OpenAI Codex CLI** | ✅ | ✅ | ✅ | ✅ | ✅ |
+| **OpenClaw** | ✅ | ✅ | ✅ | ✅ | ✅ |
+| **Hermes** | 🔧 | 🔧 | 🔧 | 🔧 | 🔧 |
+| **Custom / BYO** | 🔧 | 🔧 | 🔧 | 🔧 | 🔧 |
+
+### IDE-based Agents
+
+| Tool | Auto-detect | Scan | Sync | Skill Install | Daemon |
+|---|---|---|---|---|---|
+| **Cursor** | 🔜 | 🔜 | 🔜 | 🔜 | 🔜 |
+| **GitHub Copilot** | 🔜 | 🔜 | 🔜 | 🔜 | 🔜 |
+
+> ✅ Supported &nbsp;·&nbsp; 🔜 Planned &nbsp;·&nbsp; 🔧 Custom adapter required  
+> Adding a new tool? See [Writing an Adapter](docs/adapters.md).
+
+---
+
+## 🗃️ Registry Storage
+
+WaslaGenie keeps its own state separately from all orchestrators. You choose the scope at install time:
+
+**User-level** (default — available across all your projects):
+```
+~/.waslagenie/
+├── registry.json     ← every discovered asset + origin tool + stub locations
+├── stubs/            ← log of every stub written and when
+└── config.json       ← your scope and preferences
+```
+
+**Workspace-level** (scoped to current project only):
+```
+.waslagenie/
+├── registry.json
+├── stubs/
+└── config.json
+```
+
+Switch anytime:
+```bash
+waslagenie config --scope workspace
+waslagenie config --scope user
+```
+
+---
+
+## 🌱 Gradual Centralization
+
+WaslaGenie respects the **zero-friction promise**: your agents live where they were born. You don't need to learn a new canonical location on day one.
+
+But over time, WaslaGenie offers a path toward centralization — for portability, backup, and eventually team sharing.
+
+```
+Day 1    — Agents live in ~/.claude/, ~/.gemini/, ~/.codex/
+           WaslaGenie syncs them via stubs. You don't change anything.
+
+Over time — You discover agents scattered across 5 tool directories.
+           You run: waslagenie migrate researcher --to ~/.waslagenie/
+           Now researcher lives in ~/.waslagenie/ and stubs point there.
+
+Later    — All your agents are in ~/.waslagenie/.
+           Backup is: waslagenie export
+           New machine is: waslagenie import backup.tar
+```
+
+**Commands:**
+
+```bash
+waslagenie status                          # see where every asset lives today
+waslagenie migrate <name> --to ~/.waslagenie/   # optionally move an asset to central location
+waslagenie export                          # bundle everything for backup or new machine
+waslagenie import backup.tar              # restore on a new machine
+```
+
+Nothing is forced. Centralization is a convenience, not a requirement.
+
+---
+
+## 🏗️ Project Structure
+
+```
+wasla-genie/
+├── src/
+│   ├── cli/              # CLI entry point and commands
+│   ├── scanner/          # Scans known tool config directories
+│   ├── registry/         # Builds and maintains the asset registry
+│   ├── syncer/           # Writes and tracks stub files
+│   ├── watcher/          # Daemon / filesystem watcher
+│   └── adapters/         # Per-tool directory knowledge + stub format
+│       ├── claude.js
+│       ├── gemini.js
+│       ├── codex.js
+│       ├── openclaw.js
+│       └── hermes.js
+├── docs/
+│   ├── how-stubs-work.md
+│   ├── adapters.md
+│   └── roadmap.md
+├── package.json
+└── README.md
+```
+
+---
+
+## 🌍 Why "WaslaGenie"?
+
+**Wasla (وصلة)** is Arabic for *connection* — the act of joining what was always separate.
+
+**Genie** — it appears when summoned, connects what you need, and watches quietly in the background until called again.
+
+Your agents live where they were born.  
+Your tools see everything.  
+Nothing is ever duplicated.
+
+---
+
+## 🤝 Contributing
+
+```bash
+git clone https://github.com/The-Untitled-Org/wasla-genie
+cd wasla-genie
+npm install
+npm run dev
+```
+
+- [Contributing Guide](CONTRIBUTING.md)
+- [Architecture Docs](docs/docs/architecture/index.md)
+
+---
+
+## 📄 License
+
+MIT © [The Untitled Org](https://github.com/The-Untitled-Org)
+
+---
+
+<div align="center">
+
+**Your agents live where they were born.**  
+**WaslaGenie makes sure every tool can find them.**
+
+⭐ Star this repo if you are tired of copy-pasting the same config into five different tools.
+
+</div>

package/dist/adapters/base.d.ts

@@ -0,0 +1,27 @@
+import { WaslaGenieAdapter, Asset, AssetFormat } from '../core/types.js';
+export declare abstract class BaseAdapter implements WaslaGenieAdapter {
+    abstract name: string;
+    abstract displayName: string;
+    abstract mcpKey: string;
+    abstract contextFile: string;
+    abstract skillDirs: string[];
+    abstract paths: {
+        agent?: string;
+        skill?: string;
+        mcp?: string;
+        context?: string;
+    };
+    abstract formats: {
+        agent?: AssetFormat;
+        skill?: AssetFormat;
+        mcp?: AssetFormat;
+        context?: AssetFormat;
+    };
+    abstract isInstalled(): Promise<boolean>;
+    mcpFromNative(server: Record<string, unknown>): Record<string, unknown>;
+    mcpToNative(server: Record<string, unknown>): Record<string, unknown>;
+    abstract writeStub(asset: Asset, content: string, targetPath: string): Promise<void>;
+    abstract installSkill(): Promise<void>;
+    abstract getRootConfigAppend(): string | null;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEzE,8BAAsB,WAAY,YAAW,iBAAiB;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAE7B,QAAQ,CAAC,KAAK,EAAE;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE;QAChB,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,GAAG,CAAC,EAAE,WAAW,CAAC;QAClB,OAAO,CAAC,EAAE,WAAW,CAAC;KACvB,CAAC;IAEF,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAExC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIvE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIrE,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACpF,QAAQ,CAAC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IACtC,QAAQ,CAAC,mBAAmB,IAAI,MAAM,GAAG,IAAI;CAC9C"}

package/dist/adapters/base.js

@@ -0,0 +1,9 @@
+export class BaseAdapter {
+    mcpFromNative(server) {
+        return server;
+    }
+    mcpToNative(server) {
+        return server;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/adapters/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAEA,MAAM,OAAgB,WAAW;IAsB/B,aAAa,CAAC,MAA+B;QAC3C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,WAAW,CAAC,MAA+B;QACzC,OAAO,MAAM,CAAC;IAChB,CAAC;CAKF"}

package/dist/adapters/claude.d.ts

@@ -0,0 +1,31 @@
+import { BaseAdapter } from './base.js';
+import { Asset } from '../core/types.js';
+export declare class ClaudeAdapter extends BaseAdapter {
+    name: string;
+    displayName: string;
+    private scope;
+    constructor(scope?: 'user' | 'workspace');
+    get paths(): {
+        agent: string;
+        skill: string;
+        mcp: string;
+        context: string;
+    };
+    mcpKey: string;
+    contextFile: string;
+    formats: {
+        agent: "md";
+        skill: "md";
+        mcp: "json";
+        context: "md";
+    };
+    get skillDirs(): string[];
+    isInstalled(): Promise<boolean>;
+    writeStub(asset: Asset, content: string, targetPath: string): Promise<void>;
+    private writeAgentStub;
+    private writeSkillStub;
+    private writeMcpStub;
+    installSkill(): Promise<void>;
+    getRootConfigAppend(): string | null;
+}
+//# sourceMappingURL=claude.d.ts.map

package/dist/adapters/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAKzC,qBAAa,aAAc,SAAQ,WAAW;IAC5C,IAAI,SAAY;IAChB,WAAW,SAAiB;IAC5B,OAAO,CAAC,KAAK,CAAuB;gBAExB,KAAK,GAAE,MAAM,GAAG,WAAyB;IAKrD,IAAI,KAAK;;;;;MAWR;IAED,MAAM,SAAgB;IACtB,WAAW,SAAe;IAE1B,OAAO;;;;;MAKL;IAEF,IAAI,SAAS,aAEZ;IAEK,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAK/B,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAUnE,cAAc;YAMd,cAAc;YAMd,YAAY;IAMpB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAgCnC,mBAAmB,IAAI,MAAM,GAAG,IAAI;CAGrC"}

package/dist/adapters/claude.js

@@ -0,0 +1,96 @@
+import { BaseAdapter } from './base.js';
+import { fileExists, writeText, ensureDir } from '../utils/fs.js';
+import { join } from 'path';
+import { getToolMarkers } from '../utils/paths.js';
+export class ClaudeAdapter extends BaseAdapter {
+    constructor(scope = 'workspace') {
+        super();
+        this.name = 'claude';
+        this.displayName = 'Claude Code';
+        this.mcpKey = 'mcpServers';
+        this.contextFile = 'CLAUDE.md';
+        this.formats = {
+            agent: 'md',
+            skill: 'md',
+            mcp: 'json',
+            context: 'md',
+        };
+        this.scope = scope;
+    }
+    get paths() {
+        const markers = getToolMarkers(this.scope);
+        return {
+            agent: join(markers.claude, 'agents'),
+            skill: join(markers.claude, 'skills'),
+            mcp: this.scope === 'workspace'
+                ? join(markers.claude, 'mcp.json')
+                : join(markers.claude, 'settings.json'),
+            context: join(markers.claude, 'CLAUDE.md'),
+        };
+    }
+    get skillDirs() {
+        return [this.paths.skill];
+    }
+    async isInstalled() {
+        const markers = getToolMarkers(this.scope);
+        return fileExists(markers.claude);
+    }
+    async writeStub(asset, content, targetPath) {
+        if (asset.type === 'agent') {
+            await this.writeAgentStub(targetPath, content);
+        }
+        else if (asset.type === 'skill') {
+            await this.writeSkillStub(targetPath, content);
+        }
+        else {
+            await this.writeMcpStub(targetPath, content);
+        }
+    }
+    async writeAgentStub(targetPath, content) {
+        const { dirname } = await import('path');
+        await ensureDir(dirname(targetPath));
+        await writeText(targetPath, content);
+    }
+    async writeSkillStub(targetPath, content) {
+        const { dirname } = await import('path');
+        await ensureDir(dirname(targetPath));
+        await writeText(targetPath, content);
+    }
+    async writeMcpStub(targetPath, content) {
+        const { dirname } = await import('path');
+        await ensureDir(dirname(targetPath));
+        await writeText(targetPath, content);
+    }
+    async installSkill() {
+        // Write a WaslaGenie skill into Claude's native skills directory.
+        // We do NOT touch CLAUDE.md — that file belongs to the user.
+        const skillDir = join(this.paths.skill, 'waslagenie');
+        await ensureDir(skillDir);
+        const skillPath = join(skillDir, 'SKILL.md');
+        if (await fileExists(skillPath)) {
+            return; // already installed, idempotent
+        }
+        const skillContent = `---
+description: >
+  Runs WaslaGenie CLI commands to sync, inspect, or manage agents and MCPs
+  across AI orchestrators. Use when asked to sync tools, check sync status,
+  install WaslaGenie, or troubleshoot why an agent isn't appearing in a tool.
+---
+
+# WaslaGenie Operator
+
+Use the \`waslagenie\` CLI to sync agents and MCPs across all installed AI tools.
+
+\`\`\`bash
+waslagenie sync     # Mirror agents across all tools
+waslagenie status   # Show registry state
+waslagenie watch    # Auto-sync on file changes
+\`\`\`
+`;
+        await writeText(skillPath, skillContent);
+    }
+    getRootConfigAppend() {
+        return null;
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/adapters/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"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"}

package/dist/adapters/cursor.d.ts

@@ -0,0 +1,30 @@
+import { BaseAdapter } from './base.js';
+import { Asset } from '../core/types.js';
+export declare class CursorAdapter extends BaseAdapter {
+    name: string;
+    displayName: string;
+    protected scope: 'user' | 'workspace';
+    constructor(scope?: 'user' | 'workspace');
+    get paths(): {
+        agent: string;
+        skill: string;
+        mcp: string;
+        context: string | undefined;
+    };
+    mcpKey: string;
+    contextFile: string;
+    get skillDirs(): string[];
+    formats: {
+        agent: "md";
+        skill: "md";
+        mcp: "json";
+        context: "md";
+    };
+    isInstalled(): Promise<boolean>;
+    writeStub(asset: Asset, content: string, targetPath: string): Promise<void>;
+    private writeAgentStub;
+    private writeMcpStub;
+    installSkill(): Promise<void>;
+    getRootConfigAppend(): string | null;
+}
+//# sourceMappingURL=cursor.d.ts.map

package/dist/adapters/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/adapters/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAKzC,qBAAa,aAAc,SAAQ,WAAW;IAC5C,IAAI,SAAY;IAChB,WAAW,SAAY;IACvB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;gBAE1B,KAAK,GAAE,MAAM,GAAG,WAAyB;IAKrD,IAAI,KAAK;;;;;MASR;IAED,MAAM,SAAgB;IACtB,WAAW,SAAe;IAE1B,IAAI,SAAS,aAEZ;IAED,OAAO;;;;;MAKL;IAEI,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAK/B,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAQnE,cAAc;YAKd,YAAY;IAKpB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC,mBAAmB,IAAI,MAAM,GAAG,IAAI;CAGrC"}