clawsouls 0.0.1 → 0.1.1

package/LICENSE

@@ -0,0 +1,204 @@
+Copyright 2026 ClawSouls
+
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,143 @@
+# 🧠 ClawSouls CLI
+
+**Give your AI a soul.** Install, manage, and switch AI agent personas for [OpenClaw](https://github.com/openclaw/openclaw).
+
+[![npm](https://img.shields.io/npm/v/clawsouls)](https://www.npmjs.com/package/clawsouls)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
+
+## What is ClawSouls?
+
+ClawSouls is a persona sharing platform for AI agents. A **Soul** is a personality package — a set of markdown files that define how your AI thinks, talks, and behaves. Same LLM, completely different personality.
+
+Browse available souls at [clawsouls.ai](https://clawsouls.ai).
+
+## Quick Start
+
+```bash
+# Install a soul
+npx clawsouls install brad
+
+# Activate it (backs up your current workspace)
+npx clawsouls use brad
+
+# Restart your OpenClaw session — done!
+```
+
+## Installation
+
+```bash
+# Use directly with npx (no install needed)
+npx clawsouls <command>
+
+# Or install globally
+npm install -g clawsouls
+```
+
+**Requirements:** Node.js 22+
+
+## Commands
+
+### `clawsouls install <name>`
+
+Download and install a soul from the registry.
+
+```bash
+clawsouls install minimalist
+clawsouls install devops-veteran
+clawsouls install brad --force  # overwrite existing
+```
+
+### `clawsouls use <name>`
+
+Activate an installed soul. Your current workspace files are automatically backed up before switching.
+
+```bash
+clawsouls use minimalist
+```
+
+**Protected files** — these are never overwritten:
+- `USER.md` (your personal data)
+- `MEMORY.md` (your AI's memories)
+- `TOOLS.md` (your tool configuration)
+
+### `clawsouls restore`
+
+Revert to your previous soul from the latest backup.
+
+```bash
+clawsouls restore
+```
+
+### `clawsouls list`
+
+Show all installed souls.
+
+```bash
+clawsouls list
+```
+
+## Available Souls
+
+| Soul | Category | Description |
+|------|----------|-------------|
+| 🅱️ **Brad** | Engineering | Formal, project-focused development partner |
+| 🔧 **DevOps Veteran** | DevOps | Battle-scarred infrastructure engineer |
+| 🎮 **GameDev Mentor** | Game Dev | Experienced game developer and mentor |
+| ⚡ **Minimalist** | Lifestyle | Extremely concise responses |
+| 🔍 **Code Reviewer** | Engineering | Thorough, constructive code reviewer |
+| 📚 **Coding Tutor** | Education | Patient programming teacher |
+| 📋 **Personal Assistant** | Lifestyle | Proactive daily life assistant |
+| 📝 **Tech Writer** | Writing | Clear technical documentation writer |
+| 📊 **Data Analyst** | Data | Insight-driven data analyst |
+| ✍️ **Storyteller** | Creative | Narrative crafter and worldbuilder |
+
+Browse all at [clawsouls.ai](https://clawsouls.ai).
+
+## What's in a Soul?
+
+A soul is a directory with these files:
+
+```
+my-soul/
+├── clawsoul.json    # Metadata (name, version, tags)
+├── SOUL.md          # Personality & behavior
+├── IDENTITY.md      # Name, emoji, avatar
+├── AGENTS.md        # Workflow & rules
+├── HEARTBEAT.md     # Periodic task config
+└── README.md        # Documentation
+```
+
+The spec is open — see [Soul Spec](https://github.com/clawsouls/clawsouls/blob/main/docs/SOUL_SPEC.md).
+
+## How It Works
+
+```
+┌─────────────┐     install     ┌──────────────┐
+│  Registry    │ ──────────────→│ ~/.openclaw/  │
+│  (GitHub)    │                │   souls/brad/ │
+└─────────────┘                └──────┬───────┘
+                                      │ use
+                                      ▼
+                               ┌──────────────┐
+                               │ ~/.openclaw/  │
+                               │  workspace/   │
+                               │  ├ SOUL.md    │
+                               │  ├ IDENTITY.md│
+                               │  └ AGENTS.md  │
+                               └──────────────┘
+```
+
+1. **Install** downloads soul files to `~/.openclaw/souls/<name>/`
+2. **Use** backs up your workspace, then copies soul files in
+3. **Restart** your OpenClaw session to load the new personality
+
+## Links
+
+- 🌐 [clawsouls.ai](https://clawsouls.ai) — Browse souls
+- 📦 [npm](https://www.npmjs.com/package/clawsouls) — Package
+- 📋 [Soul Spec](https://github.com/clawsouls/clawsouls/blob/main/docs/SOUL_SPEC.md) — Create your own
+- 🐙 [GitHub Org](https://github.com/clawsouls) — Source code
+
+## License
+
+Apache 2.0 — see [LICENSE](LICENSE).

package/dist/bin/clawsouls.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/clawsouls.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { installCommand } from '../commands/install.js';
+import { useCommand } from '../commands/use.js';
+import { restoreCommand } from '../commands/restore.js';
+import { listCommand } from '../commands/list.js';
+const program = new Command();
+program
+    .name('clawsouls')
+    .description('AI agent persona manager for OpenClaw')
+    .version('0.1.0');
+program
+    .command('install <name>')
+    .description('Install a soul from the registry')
+    .option('-f, --force', 'Overwrite if already installed')
+    .action(installCommand);
+program
+    .command('use <name>')
+    .description('Activate an installed soul (backs up current workspace)')
+    .action(useCommand);
+program
+    .command('restore')
+    .description('Restore workspace from the latest backup')
+    .action(restoreCommand);
+program
+    .command('list')
+    .alias('ls')
+    .description('List installed souls')
+    .action(listCommand);
+program.parse();
+//# sourceMappingURL=clawsouls.js.map

package/dist/bin/clawsouls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clawsouls.js","sourceRoot":"","sources":["../../src/bin/clawsouls.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,uCAAuC,CAAC;KACpD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,aAAa,EAAE,gCAAgC,CAAC;KACvD,MAAM,CAAC,cAAc,CAAC,CAAC;AAE1B,OAAO;KACJ,OAAO,CAAC,YAAY,CAAC;KACrB,WAAW,CAAC,yDAAyD,CAAC;KACtE,MAAM,CAAC,UAAU,CAAC,CAAC;AAEtB,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,cAAc,CAAC,CAAC;AAE1B,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,KAAK,CAAC,IAAI,CAAC;KACX,WAAW,CAAC,sBAAsB,CAAC;KACnC,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1 @@
+export declare function initCommand(name?: string): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,107 @@
+import chalk from 'chalk';
+import { writeFileSync, mkdirSync, existsSync } from 'fs';
+import { join } from 'path';
+export async function initCommand(name) {
+    const soulName = name || 'my-soul';
+    const dir = join(process.cwd(), soulName);
+    if (existsSync(dir)) {
+        console.log(chalk.red(`Directory "${soulName}" already exists.`));
+        return;
+    }
+    mkdirSync(dir, { recursive: true });
+    // clawsoul.json
+    const meta = {
+        name: soulName,
+        displayName: soulName.split('-').map(w => w[0].toUpperCase() + w.slice(1)).join(' '),
+        version: '1.0.0',
+        description: 'Describe your soul in one sentence.',
+        author: {
+            name: 'Your Name',
+            github: 'your-github',
+        },
+        license: 'Apache-2.0',
+        tags: [],
+        category: 'work/engineering',
+        compatibility: {
+            openclaw: '>=2026.2.0',
+        },
+        files: {
+            soul: 'SOUL.md',
+            identity: 'IDENTITY.md',
+            agents: 'AGENTS.md',
+            heartbeat: 'HEARTBEAT.md',
+        },
+        skills: [],
+    };
+    writeFileSync(join(dir, 'clawsoul.json'), JSON.stringify(meta, null, 2));
+    // SOUL.md
+    writeFileSync(join(dir, 'SOUL.md'), `# ${meta.displayName}
+
+Describe who this AI persona is.
+
+## Personality
+
+- **Tone**: 
+- **Style**: 
+- **Philosophy**: 
+
+## Principles
+
+1. ...
+2. ...
+3. ...
+
+## Communication
+
+- ...
+
+## Boundaries
+
+- ...
+`);
+    // IDENTITY.md
+    writeFileSync(join(dir, 'IDENTITY.md'), `# ${meta.displayName}
+
+- **Name:** 
+- **Creature:** 
+- **Vibe:** 
+- **Emoji:** 
+`);
+    // AGENTS.md
+    writeFileSync(join(dir, 'AGENTS.md'), `# ${meta.displayName} — Workflow
+
+## Every Session
+1. Read SOUL.md, USER.md, memory files
+2. ...
+
+## Work Rules
+- ...
+
+## Safety
+- ...
+
+## Heartbeats
+- ...
+`);
+    // HEARTBEAT.md
+    writeFileSync(join(dir, 'HEARTBEAT.md'), '# Heartbeat Checks\n# Add your periodic checks here\n');
+    // README.md
+    writeFileSync(join(dir, 'README.md'), `# ${meta.displayName}
+
+Short description.
+
+**Best for:** ...
+
+**Personality:** ...
+
+**Skills:** ...
+`);
+    console.log();
+    console.log(chalk.green(`✅ Soul "${soulName}" created!`));
+    console.log();
+    console.log(`  ${chalk.cyan('Edit:')}     cd ${soulName} && edit SOUL.md`);
+    console.log(`  ${chalk.cyan('Test:')}     clawsouls use ${soulName} (after install)`);
+    console.log(`  ${chalk.cyan('Publish:')}  clawsouls publish (coming soon)`);
+    console.log();
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAa;IAC7C,MAAM,QAAQ,GAAG,IAAI,IAAI,SAAS,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAE1C,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,QAAQ,mBAAmB,CAAC,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IAED,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpC,gBAAgB;IAChB,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACpF,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,qCAAqC;QAClD,MAAM,EAAE;YACN,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,aAAa;SACtB;QACD,OAAO,EAAE,YAAY;QACrB,IAAI,EAAE,EAAE;QACR,QAAQ,EAAE,kBAAkB;QAC5B,aAAa,EAAE;YACb,QAAQ,EAAE,YAAY;SACvB;QACD,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,aAAa;YACvB,MAAM,EAAE,WAAW;YACnB,SAAS,EAAE,cAAc;SAC1B;QACD,MAAM,EAAE,EAAE;KACX,CAAC;IACF,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzE,UAAU;IACV,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;CAuB1D,CAAC,CAAC;IAED,cAAc;IACd,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,KAAK,IAAI,CAAC,WAAW;;;;;;CAM9D,CAAC,CAAC;IAED,YAAY;IACZ,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,KAAK,IAAI,CAAC,WAAW;;;;;;;;;;;;;;CAc5D,CAAC,CAAC;IAED,eAAe;IACf,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,uDAAuD,CAAC,CAAC;IAElG,YAAY;IACZ,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,KAAK,IAAI,CAAC,WAAW;;;;;;;;;CAS5D,CAAC,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,QAAQ,YAAY,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,QAAQ,kBAAkB,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,sBAAsB,QAAQ,kBAAkB,CAAC,CAAC;IACtF,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,mCAAmC,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC"}

package/dist/commands/install.d.ts

@@ -0,0 +1,3 @@
+export declare function installCommand(nameWithVersion: string, options: {
+    force?: boolean;
+}): Promise<void>;

package/dist/commands/install.js

@@ -0,0 +1,53 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { RegistryClient } from '../registry/client.js';
+import { StorageManager } from '../storage/manager.js';
+import { writeFileSync } from 'fs';
+import { join } from 'path';
+import { ensureDir } from '../utils/config.js';
+export async function installCommand(nameWithVersion, options) {
+    const [name, version] = nameWithVersion.split('@');
+    const spinner = ora(`Installing soul "${name}"...`).start();
+    try {
+        const storage = new StorageManager();
+        const registry = new RegistryClient();
+        // Check if already installed
+        if (storage.isInstalled(name) && !options.force) {
+            spinner.fail(`Soul "${name}" is already installed. Use ${chalk.yellow('--force')} to overwrite.`);
+            process.exit(1);
+        }
+        // Fetch metadata
+        spinner.text = `Fetching "${name}" metadata...`;
+        const meta = await registry.getSoulMeta(name);
+        // Get file list and download each
+        spinner.text = `Downloading "${name}" files...`;
+        const fileList = await registry.getSoulFiles(name);
+        const files = new Map();
+        for (const filename of fileList) {
+            try {
+                const content = await registry.downloadFile(name, filename);
+                files.set(filename, content);
+            }
+            catch {
+                // Skip missing optional files
+            }
+        }
+        // Save to souls directory
+        spinner.text = `Saving to local storage...`;
+        const soulDir = storage.getSoulDir(name);
+        ensureDir(soulDir);
+        for (const [filename, content] of files) {
+            const filePath = join(soulDir, filename);
+            ensureDir(join(filePath, '..'));
+            writeFileSync(filePath, content, 'utf-8');
+        }
+        spinner.succeed(`Installed ${chalk.green(meta.displayName || name)} v${meta.version || '?'}\n` +
+            `  ${chalk.dim(meta.description || '')}\n` +
+            `  Run ${chalk.cyan(`clawsouls use ${name}`)} to activate.`);
+    }
+    catch (err) {
+        spinner.fail(err.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

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

package/dist/commands/list.d.ts

@@ -0,0 +1 @@
+export declare function listCommand(): Promise<void>;

package/dist/commands/list.js

@@ -0,0 +1,21 @@
+import chalk from 'chalk';
+import { StorageManager } from '../storage/manager.js';
+export async function listCommand() {
+    const storage = new StorageManager();
+    const souls = storage.listInstalled();
+    if (souls.length === 0) {
+        console.log(chalk.dim('No souls installed.'));
+        console.log(`  Run ${chalk.cyan('clawsouls install <name>')} to get started.`);
+        return;
+    }
+    console.log(chalk.bold(`\n  Installed Souls (${souls.length})\n`));
+    for (const soul of souls) {
+        console.log(`  ${chalk.green(soul.displayName)} ${chalk.dim(`v${soul.version}`)}` +
+            `  ${chalk.yellow(soul.category)}`);
+        if (soul.description) {
+            console.log(`    ${chalk.dim(soul.description)}`);
+        }
+    }
+    console.log();
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAEtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,kBAAkB,CAAC,CAAC;QAC/E,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IAEnE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CACT,KAAK,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE;YACrE,KAAK,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CACnC,CAAC;QACF,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC"}

package/dist/commands/restore.d.ts

@@ -0,0 +1 @@
+export declare function restoreCommand(): Promise<void>;

package/dist/commands/restore.js

@@ -0,0 +1,21 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { StorageManager } from '../storage/manager.js';
+export async function restoreCommand() {
+    const spinner = ora('Restoring previous soul...').start();
+    try {
+        const storage = new StorageManager();
+        const restored = storage.restore();
+        if (!restored) {
+            spinner.fail('No backups found. Nothing to restore.');
+            process.exit(1);
+        }
+        spinner.succeed(`Restored from backup ${chalk.dim(restored)}\n` +
+            `  ${chalk.yellow('⚠')}  Restart your OpenClaw session for changes to take effect.`);
+    }
+    catch (err) {
+        spinner.fail(err.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=restore.js.map

package/dist/commands/restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../src/commands/restore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,OAAO,GAAG,GAAG,CAAC,4BAA4B,CAAC,CAAC,KAAK,EAAE,CAAC;IAE1D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAEnC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,OAAO,CACb,wBAAwB,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI;YAC/C,KAAK,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,6DAA6D,CACpF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/use.d.ts

@@ -0,0 +1 @@
+export declare function useCommand(name: string): Promise<void>;

package/dist/commands/use.js

@@ -0,0 +1,28 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { StorageManager } from '../storage/manager.js';
+export async function useCommand(name) {
+    const spinner = ora(`Switching to soul "${name}"...`).start();
+    try {
+        const storage = new StorageManager();
+        if (!storage.isInstalled(name)) {
+            spinner.fail(`Soul "${name}" is not installed.\n` +
+                `  Run ${chalk.cyan(`clawsouls install ${name}`)} first.`);
+            process.exit(1);
+        }
+        // Backup current workspace
+        spinner.text = 'Backing up current workspace...';
+        const backupPath = storage.backupWorkspace();
+        // Apply soul
+        spinner.text = `Applying "${name}"...`;
+        storage.applySoul(name);
+        spinner.succeed(`Switched to ${chalk.green(name)}\n` +
+            `  ${chalk.dim('Backup saved. Use')} ${chalk.cyan('clawsouls restore')} ${chalk.dim('to revert.')}\n` +
+            `  ${chalk.yellow('⚠')}  Restart your OpenClaw session for changes to take effect.`);
+    }
+    catch (err) {
+        spinner.fail(err.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=use.js.map

package/dist/commands/use.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use.js","sourceRoot":"","sources":["../../src/commands/use.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,sBAAsB,IAAI,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;IAE9D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;QAErC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CACV,SAAS,IAAI,uBAAuB;gBACpC,SAAS,KAAK,CAAC,IAAI,CAAC,qBAAqB,IAAI,EAAE,CAAC,SAAS,CAC1D,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,2BAA2B;QAC3B,OAAO,CAAC,IAAI,GAAG,iCAAiC,CAAC;QACjD,MAAM,UAAU,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;QAE7C,aAAa;QACb,OAAO,CAAC,IAAI,GAAG,aAAa,IAAI,MAAM,CAAC;QACvC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAExB,OAAO,CAAC,OAAO,CACb,eAAe,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI;YACpC,KAAK,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI;YACrG,KAAK,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,6DAA6D,CACpF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/registry/client.d.ts

@@ -0,0 +1,24 @@
+export interface SoulMeta {
+    name: string;
+    displayName: string;
+    version: string;
+    description: string;
+    category: string;
+    tags: string[];
+}
+/**
+ * MVP: GitHub raw URL 기반 레지스트리 + 로컬 경로 지원
+ * Phase 4 이후: API 서버로 전환
+ */
+export declare class RegistryClient {
+    private cdn;
+    private isLocal;
+    constructor();
+    /** Soul의 clawsoul.json 가져오기 */
+    getSoulMeta(name: string): Promise<SoulMeta>;
+    /** Soul 파일 다운로드 */
+    downloadFile(name: string, filename: string): Promise<string>;
+    /** Soul 파일 목록 (clawsoul.json의 files 필드 기반) */
+    getSoulFiles(name: string): Promise<string[]>;
+    private readFile;
+}

package/dist/registry/client.js

@@ -0,0 +1,55 @@
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { getConfig } from '../utils/config.js';
+/**
+ * MVP: GitHub raw URL 기반 레지스트리 + 로컬 경로 지원
+ * Phase 4 이후: API 서버로 전환
+ */
+export class RegistryClient {
+    cdn;
+    isLocal;
+    constructor() {
+        const config = getConfig();
+        this.cdn = config.cdn;
+        this.isLocal = !this.cdn.startsWith('http');
+    }
+    /** Soul의 clawsoul.json 가져오기 */
+    async getSoulMeta(name) {
+        const content = await this.readFile(name, 'clawsoul.json');
+        return JSON.parse(content);
+    }
+    /** Soul 파일 다운로드 */
+    async downloadFile(name, filename) {
+        return this.readFile(name, filename);
+    }
+    /** Soul 파일 목록 (clawsoul.json의 files 필드 기반) */
+    async getSoulFiles(name) {
+        const meta = await this.getSoulMeta(name);
+        const files = ['clawsoul.json', 'README.md'];
+        const fileMap = meta.files || {};
+        for (const path of Object.values(fileMap)) {
+            if (typeof path === 'string')
+                files.push(path);
+        }
+        return [...new Set(files)];
+    }
+    async readFile(name, filename) {
+        if (this.isLocal) {
+            const filePath = join(this.cdn, name, filename);
+            if (!existsSync(filePath)) {
+                throw new Error(`Soul "${name}" not found in registry`);
+            }
+            return readFileSync(filePath, 'utf-8');
+        }
+        const url = `${this.cdn}/${name}/${filename}`;
+        const res = await fetch(url);
+        if (!res.ok) {
+            if (res.status === 404) {
+                throw new Error(`Soul "${name}" not found in registry`);
+            }
+            throw new Error(`Registry error: ${res.status} ${res.statusText}`);
+        }
+        return res.text();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/registry/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/registry/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAW/C;;;GAGG;AACH,MAAM,OAAO,cAAc;IACjB,GAAG,CAAS;IACZ,OAAO,CAAU;IAEzB;QACE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,WAAW,CAAC,IAAY;QAC5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,QAAgB;QAC/C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,YAAY,CAAC,IAAY;QAC7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAI,IAAY,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,QAAgB;QACnD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAChD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,yBAAyB,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,yBAAyB,CAAC,CAAC;YAC1D,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/storage/local.d.ts

@@ -0,0 +1,21 @@
+import type { ClawSoul } from '../utils/validate.js';
+export declare class LocalStorage {
+    private soulsDir;
+    private workspace;
+    private backupDir;
+    constructor();
+    /** Soul이 로컬에 설치되어 있는지 확인 */
+    isInstalled(name: string): boolean;
+    /** 설치된 Soul 목록 */
+    listInstalled(): ClawSoul[];
+    /** Soul 파일을 로컬에 저장 */
+    saveSoulFile(name: string, filename: string, content: string): void;
+    /** 현재 workspace 파일 백업 */
+    backupWorkspace(): string;
+    /** Soul을 workspace에 적용 */
+    applySoul(name: string): void;
+    /** 최신 백업에서 복원 */
+    restoreFromBackup(): string | null;
+    /** Soul 디렉토리 경로 */
+    getSoulPath(name: string): string;
+}

package/dist/storage/local.js

@@ -0,0 +1,98 @@
+import { existsSync, readdirSync, readFileSync, writeFileSync, cpSync } from 'fs';
+import { join } from 'path';
+import { getConfig, ensureDir } from '../utils/config.js';
+export class LocalStorage {
+    soulsDir;
+    workspace;
+    backupDir;
+    constructor() {
+        const config = getConfig();
+        this.soulsDir = config.soulsDir;
+        this.workspace = config.workspace;
+        this.backupDir = join(this.soulsDir, '_backup');
+    }
+    /** Soul이 로컬에 설치되어 있는지 확인 */
+    isInstalled(name) {
+        return existsSync(join(this.soulsDir, name, 'clawsoul.json'));
+    }
+    /** 설치된 Soul 목록 */
+    listInstalled() {
+        ensureDir(this.soulsDir);
+        const entries = readdirSync(this.soulsDir, { withFileTypes: true });
+        const souls = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory() || entry.name.startsWith('_'))
+                continue;
+            const metaPath = join(this.soulsDir, entry.name, 'clawsoul.json');
+            if (existsSync(metaPath)) {
+                try {
+                    const raw = readFileSync(metaPath, 'utf-8');
+                    souls.push(JSON.parse(raw));
+                }
+                catch {
+                    // skip invalid
+                }
+            }
+        }
+        return souls;
+    }
+    /** Soul 파일을 로컬에 저장 */
+    saveSoulFile(name, filename, content) {
+        const dir = join(this.soulsDir, name);
+        ensureDir(dir);
+        writeFileSync(join(dir, filename), content, 'utf-8');
+    }
+    /** 현재 workspace 파일 백업 */
+    backupWorkspace() {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const backupPath = join(this.backupDir, timestamp);
+        ensureDir(backupPath);
+        const filesToBackup = ['SOUL.md', 'IDENTITY.md', 'AGENTS.md', 'HEARTBEAT.md'];
+        for (const file of filesToBackup) {
+            const src = join(this.workspace, file);
+            if (existsSync(src)) {
+                cpSync(src, join(backupPath, file));
+            }
+        }
+        return backupPath;
+    }
+    /** Soul을 workspace에 적용 */
+    applySoul(name) {
+        const soulDir = join(this.soulsDir, name);
+        const filesToApply = [
+            { src: 'SOUL.md', dst: 'SOUL.md' },
+            { src: 'IDENTITY.md', dst: 'IDENTITY.md' },
+            { src: 'AGENTS.md', dst: 'AGENTS.md' },
+            { src: 'HEARTBEAT.md', dst: 'HEARTBEAT.md' },
+        ];
+        for (const { src, dst } of filesToApply) {
+            const srcPath = join(soulDir, src);
+            if (existsSync(srcPath)) {
+                cpSync(srcPath, join(this.workspace, dst));
+            }
+        }
+    }
+    /** 최신 백업에서 복원 */
+    restoreFromBackup() {
+        if (!existsSync(this.backupDir))
+            return null;
+        const backups = readdirSync(this.backupDir, { withFileTypes: true })
+            .filter(e => e.isDirectory())
+            .map(e => e.name)
+            .sort()
+            .reverse();
+        if (backups.length === 0)
+            return null;
+        const latest = join(this.backupDir, backups[0]);
+        const files = readdirSync(latest);
+        for (const file of files) {
+            cpSync(join(latest, file), join(this.workspace, file));
+        }
+        return backups[0];
+    }
+    /** Soul 디렉토리 경로 */
+    getSoulPath(name) {
+        return join(this.soulsDir, name);
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/storage/local.js.map

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

package/dist/storage/manager.d.ts

@@ -0,0 +1,31 @@
+export interface InstalledSoul {
+    name: string;
+    displayName: string;
+    version: string;
+    description: string;
+    category: string;
+    path: string;
+}
+export declare class StorageManager {
+    private soulsDir;
+    private workspace;
+    private backupDir;
+    constructor();
+    /** List all installed souls */
+    listInstalled(): InstalledSoul[];
+    /** Check if a soul is installed */
+    isInstalled(name: string): boolean;
+    /** Get soul install directory */
+    getSoulDir(name: string): string;
+    /** Save downloaded soul files to souls dir */
+    saveSoul(name: string, files: Map<string, string>): void;
+    /** Backup current workspace files before applying a new soul */
+    backupWorkspace(): string;
+    /** Apply a soul to the workspace (copy soul files) */
+    applySoul(name: string): void;
+    /** Restore workspace from latest backup */
+    restore(): string | null;
+    /** List available backups */
+    listBackups(): string[];
+    private mapFileKey;
+}

package/dist/storage/manager.js

@@ -0,0 +1,141 @@
+import { existsSync, readdirSync, readFileSync, writeFileSync, copyFileSync } from 'fs';
+import { join } from 'path';
+import { getConfig, ensureDir } from '../utils/config.js';
+/** Files that get copied to workspace on `use` */
+const SOUL_FILES = ['SOUL.md', 'IDENTITY.md', 'AGENTS.md', 'HEARTBEAT.md'];
+/** Files that are NEVER overwritten (personal data) */
+const PROTECTED_FILES = ['USER.md', 'MEMORY.md', 'TOOLS.md'];
+export class StorageManager {
+    soulsDir;
+    workspace;
+    backupDir;
+    constructor() {
+        const config = getConfig();
+        this.soulsDir = config.soulsDir;
+        this.workspace = config.workspace;
+        this.backupDir = join(this.soulsDir, '_backup');
+    }
+    /** List all installed souls */
+    listInstalled() {
+        ensureDir(this.soulsDir);
+        const entries = readdirSync(this.soulsDir, { withFileTypes: true });
+        const souls = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory() || entry.name.startsWith('_'))
+                continue;
+            const manifestPath = join(this.soulsDir, entry.name, 'clawsoul.json');
+            if (!existsSync(manifestPath))
+                continue;
+            try {
+                const data = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+                souls.push({
+                    name: data.name || entry.name,
+                    displayName: data.displayName || data.name || entry.name,
+                    version: data.version || '0.0.0',
+                    description: data.description || '',
+                    category: data.category || 'general',
+                    path: join(this.soulsDir, entry.name),
+                });
+            }
+            catch {
+                // Skip invalid manifests
+            }
+        }
+        return souls;
+    }
+    /** Check if a soul is installed */
+    isInstalled(name) {
+        return existsSync(join(this.soulsDir, name, 'clawsoul.json'));
+    }
+    /** Get soul install directory */
+    getSoulDir(name) {
+        return join(this.soulsDir, name);
+    }
+    /** Save downloaded soul files to souls dir */
+    saveSoul(name, files) {
+        const dir = join(this.soulsDir, name);
+        ensureDir(dir);
+        for (const [filename, content] of files) {
+            const filePath = join(dir, filename);
+            const parentDir = join(filePath, '..');
+            ensureDir(parentDir);
+            writeFileSync(filePath, content, 'utf-8');
+        }
+    }
+    /** Backup current workspace files before applying a new soul */
+    backupWorkspace() {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+        const backupPath = join(this.backupDir, timestamp);
+        ensureDir(backupPath);
+        for (const file of SOUL_FILES) {
+            const src = join(this.workspace, file);
+            if (existsSync(src)) {
+                copyFileSync(src, join(backupPath, file));
+            }
+        }
+        return backupPath;
+    }
+    /** Apply a soul to the workspace (copy soul files) */
+    applySoul(name) {
+        const soulDir = join(this.soulsDir, name);
+        if (!existsSync(soulDir)) {
+            throw new Error(`Soul "${name}" is not installed`);
+        }
+        const manifestPath = join(soulDir, 'clawsoul.json');
+        const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+        const fileMap = manifest.files || {};
+        // Copy each mapped file to workspace
+        for (const [key, filename] of Object.entries(fileMap)) {
+            if (typeof filename !== 'string')
+                continue;
+            const src = join(soulDir, filename);
+            if (!existsSync(src))
+                continue;
+            // Map soul file keys to workspace filenames
+            const targetName = this.mapFileKey(key, filename);
+            if (!targetName)
+                continue;
+            if (PROTECTED_FILES.includes(targetName))
+                continue;
+            copyFileSync(src, join(this.workspace, targetName));
+        }
+    }
+    /** Restore workspace from latest backup */
+    restore() {
+        if (!existsSync(this.backupDir))
+            return null;
+        const backups = readdirSync(this.backupDir, { withFileTypes: true })
+            .filter(e => e.isDirectory() && !e.name.startsWith('.'))
+            .map(e => e.name)
+            .sort()
+            .reverse();
+        if (backups.length === 0)
+            return null;
+        const latest = join(this.backupDir, backups[0]);
+        const files = readdirSync(latest);
+        for (const file of files) {
+            copyFileSync(join(latest, file), join(this.workspace, file));
+        }
+        return backups[0];
+    }
+    /** List available backups */
+    listBackups() {
+        if (!existsSync(this.backupDir))
+            return [];
+        return readdirSync(this.backupDir, { withFileTypes: true })
+            .filter(e => e.isDirectory())
+            .map(e => e.name)
+            .sort()
+            .reverse();
+    }
+    mapFileKey(key, filename) {
+        const map = {
+            soul: 'SOUL.md',
+            identity: 'IDENTITY.md',
+            agents: 'AGENTS.md',
+            heartbeat: 'HEARTBEAT.md',
+        };
+        return map[key] || null;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/storage/manager.js.map

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

package/dist/utils/config.d.ts

@@ -0,0 +1,12 @@
+export interface ClawSoulsConfig {
+    registry: string;
+    cdn: string;
+    workspace: string;
+    soulsDir: string;
+    auth?: {
+        token?: string;
+    };
+}
+export declare function getConfig(): ClawSoulsConfig;
+export declare function saveConfig(config: Partial<ClawSoulsConfig>): void;
+export declare function ensureDir(dir: string): void;

package/dist/utils/config.js

@@ -0,0 +1,37 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const CONFIG_DIR = join(homedir(), '.clawsouls');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+const DEFAULT_CONFIG = {
+    registry: 'https://api.clawsouls.ai',
+    cdn: process.env.CLAWSOULS_CDN || 'https://raw.githubusercontent.com/clawsouls/souls/main',
+    workspace: join(homedir(), '.openclaw', 'workspace'),
+    soulsDir: join(homedir(), '.openclaw', 'souls'),
+};
+export function getConfig() {
+    if (existsSync(CONFIG_FILE)) {
+        try {
+            const raw = readFileSync(CONFIG_FILE, 'utf-8');
+            return { ...DEFAULT_CONFIG, ...JSON.parse(raw) };
+        }
+        catch {
+            return DEFAULT_CONFIG;
+        }
+    }
+    return DEFAULT_CONFIG;
+}
+export function saveConfig(config) {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    const current = getConfig();
+    const merged = { ...current, ...config };
+    writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2));
+}
+export function ensureDir(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAY7B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AACjD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEpD,MAAM,cAAc,GAAoB;IACtC,QAAQ,EAAE,0BAA0B;IACpC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,wDAAwD;IAC1F,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,WAAW,CAAC;IACpD,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC;CAChD,CAAC;AAEF,MAAM,UAAU,SAAS;IACvB,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAC/C,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,cAAc,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAgC;IACzD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;IACzC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/utils/validate.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+export declare const ClawSoulSchema: z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodString;
+    author: z.ZodObject<{
+        name: z.ZodString;
+        github: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    license: z.ZodString;
+    tags: z.ZodArray<z.ZodString>;
+    category: z.ZodString;
+    compatibility: z.ZodOptional<z.ZodObject<{
+        openclaw: z.ZodOptional<z.ZodString>;
+        models: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    files: z.ZodObject<{
+        soul: z.ZodString;
+        identity: z.ZodOptional<z.ZodString>;
+        agents: z.ZodOptional<z.ZodString>;
+        heartbeat: z.ZodOptional<z.ZodString>;
+        userTemplate: z.ZodOptional<z.ZodString>;
+        avatar: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    repository: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ClawSoul = z.infer<typeof ClawSoulSchema>;
+export declare function validateClawSoul(data: unknown): ClawSoul;

package/dist/utils/validate.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export const ClawSoulSchema = z.object({
+    name: z.string().regex(/^[a-z0-9-]+$/, 'Must be kebab-case'),
+    displayName: z.string().min(1),
+    version: z.string().regex(/^\d+\.\d+\.\d+$/, 'Must be semver'),
+    description: z.string().max(160),
+    author: z.object({
+        name: z.string(),
+        github: z.string().optional(),
+    }),
+    license: z.string(),
+    tags: z.array(z.string()).max(10),
+    category: z.string(),
+    compatibility: z.object({
+        openclaw: z.string().optional(),
+        models: z.array(z.string()).optional(),
+    }).optional(),
+    files: z.object({
+        soul: z.string(),
+        identity: z.string().optional(),
+        agents: z.string().optional(),
+        heartbeat: z.string().optional(),
+        userTemplate: z.string().optional(),
+        avatar: z.string().optional(),
+    }),
+    skills: z.array(z.string()).optional(),
+    repository: z.string().url().optional(),
+});
+export function validateClawSoul(data) {
+    return ClawSoulSchema.parse(data);
+}
+//# sourceMappingURL=validate.js.map

package/dist/utils/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/utils/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC5D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IAC9D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC9B,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC;QACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACvC,CAAC,CAAC,QAAQ,EAAE;IACb,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC9B,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAIH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -1,10 +1,48 @@
 {
   "name": "clawsouls",
-  "version": "0.0.1",
-  "description": "AI agent persona sharing platform — coming soon. https://clawsouls.ai",
-  "keywords": ["ai", "persona", "agent", "openclaw", "soul"],
-  "license": "Apache-2.0",
-  "repository": "https://github.com/clawsouls/clawsouls-cli",
+  "version": "0.1.1",
+  "description": "CLI for ClawSouls — AI agent persona sharing platform",
+  "main": "dist/index.js",
+  "bin": {
+    "clawsouls": "dist/bin/clawsouls.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/bin/clawsouls.js",
+    "lint": "tsc --noEmit"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/clawsouls/clawsouls-cli.git"
+  },
+  "keywords": [
+    "ai",
+    "persona",
+    "agent",
+    "openclaw",
+    "soul",
+    "cli"
+  ],
   "author": "TomLeeLive",
-  "main": "index.js"
+  "license": "Apache-2.0",
+  "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "ora": "^9.3.0",
+    "tar": "^7.5.7",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "@types/tar": "^6.1.13",
+    "typescript": "^5.9.3"
+  }
 }

package/index.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-console.log("ClawSouls — coming soon. https://clawsouls.ai");