@andrestobelem/clone 0.1.1 → 0.1.3

package/README.md

@@ -2,7 +2,7 @@
 
 Run a local issue and project workspace without installing Python.
 
-Website: <https://clone-andrestobelem-prod.web.app>
+Website: <https://clone.andrestobelem.dev>
 
 ```sh
 npx @andrestobelem/clone
@@ -22,7 +22,33 @@ npx @andrestobelem/clone --help
 
 Use `--no-open` with `start` to keep the browser closed. Set `CLONE_DATA_DIR` to select another data directory.
 
-`--local` stores the workspace in `.clone/` in the current directory. Add `.clone/` to the repository's `.gitignore` unless you have a specific backup workflow. `--data-dir PATH` selects an explicit directory.
+## Use one workspace per repository
+
+Open a terminal in the repository that the workspace belongs to. Then run:
+
+```sh
+npx @andrestobelem/clone --local
+```
+
+With `--local`, the current directory determines where Clone stores data. Clone creates `.clone/` there and stores `workspace.sqlite3`, snapshots, attachments, and backups inside it. Running the same command from another repository creates a separate workspace.
+
+Add the directory to that repository's `.gitignore` unless you have a specific backup workflow:
+
+```gitignore
+.clone/
+```
+
+Always run the command from the same repository to reopen that workspace. `--local` does not copy or move records from the operating system's user data directory. `--data-dir PATH` selects an explicit directory.
+
+## Agent skill
+
+Install the shared Clone skill for Codex and Claude Code:
+
+```sh
+npx skills add andrestobelem/clone --skill clone-workspace --agent codex claude-code -y
+```
+
+The skill gives each agent a stable actor identity and a verified workflow for reads, writes, and synchronization recovery.
 
 ## Data locations
 

package/bin/clone.js

@@ -145,9 +145,13 @@ function parseStartArguments(arguments_) {
 function initialize(binary, database, storage) {
   if (fs.existsSync(database) || fs.existsSync(path.join(storage, "snapshot"))) return;
   fs.mkdirSync(storage, { recursive: true });
-  const result = spawnSync(binary, ["--db", database, "init"], { encoding: "utf8", stdio: "inherit" });
+  const result = spawnSync(binary, ["--db", database, "init"], { encoding: "utf8" });
   if (result.error) throw result.error;
-  if (result.status !== 0) throw new Error(`Clone initialization failed with exit code ${result.status}.`);
+  if (result.status !== 0) {
+    if (result.stdout) process.stdout.write(result.stdout);
+    if (result.stderr) process.stderr.write(result.stderr);
+    throw new Error(`Clone initialization failed with exit code ${result.status}.`);
+  }
 }
 
 async function start(binary, arguments_, environment = process.env) {

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@andrestobelem/clone",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Run the Clone issue and project workspace locally.",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/andrestobelem/clone.git"
   },
-  "homepage": "https://clone-andrestobelem-prod.web.app",
+  "homepage": "https://clone.andrestobelem.dev",
   "bugs": "https://github.com/andrestobelem/clone/issues",
   "type": "commonjs",
   "bin": {