@orth/cli 0.2.2 → 0.2.4

package/README.md

@@ -53,13 +53,17 @@ orth api show hunter /v2/domain-search
 
 ```bash
 # GET request with query params
-orth api run hunter /v2/domain-search -q domain=stripe.com
+orth run hunter /v2/domain-search -q domain=stripe.com
+
+# Multiple query params (two ways)
+orth run searchapi /api/v1/search -q 'engine=amazon_search&q=wireless earbuds'
+orth run searchapi /api/v1/search -q engine=amazon_search -q q=wireless earbuds
 
 # POST request with body
-orth api run olostep /v1/scrapes --body '{"url": "https://stripe.com"}'
+orth run olostep /v1/scrapes -d '{"url": "https://stripe.com"}'
 
 # Raw output for piping
-orth api run hunter /v2/domain-search -q domain=stripe.com --raw | jq '.emails'
+orth run hunter /v2/domain-search -q domain=stripe.com --raw | jq '.emails'
 ```
 
 ### Generate Code
@@ -134,6 +138,14 @@ orth skills create owner/repo --path skills/my-skill --ref main
 orth skills submit ./my-skill
 orth skills submit --name "My Skill" --tags "react,testing"
 
+# Update local skill from platform (pull)
+orth skills update owner/my-skill
+orth skills update owner/my-skill ./local-dir --force
+
+# Push local changes to platform
+orth skills push owner/my-skill
+orth skills push owner/my-skill ./local-dir
+
 # Request verification (required before discoverability)
 orth skills request-verification owner/my-skill
 

package/dist/commands/api.js

@@ -36,7 +36,7 @@ async function apiCommand(slug, path, options) {
                     chalk_1.default.white(api.name || "") +
                     chalk_1.default.gray(` (${api.endpoints?.length || 0} endpoints)`));
             }
-            console.log(chalk_1.default.gray("\nRun 'ortho api <slug>' to see endpoints for an API"));
+            console.log(chalk_1.default.gray("\nRun 'orth api show <slug>' to see endpoints for an API"));
             return;
         }
         if (path) {
@@ -47,11 +47,6 @@ async function apiCommand(slug, path, options) {
             // Get description from endpoint object if available
             const desc = data.description || data.endpoint?.description;
             console.log(chalk_1.default.gray(desc || "No description"));
-            // Get price
-            const price = data.price || data.endpoint?.price;
-            if (price) {
-                console.log(chalk_1.default.green(`\nPrice: ${typeof price === 'number' ? '$' + price : price}`));
-            }
             // Get params from nested endpoint object if needed
             const queryParams = data.parameters?.query || data.endpoint?.queryParams || [];
             const bodyParams = data.parameters?.body || data.endpoint?.bodyParams || [];
@@ -127,20 +122,19 @@ async function apiCommand(slug, path, options) {
         const api = data.results.find((a) => a.slug === slug);
         if (!api) {
             console.log(chalk_1.default.yellow(`API '${slug}' not found.`));
-            console.log(chalk_1.default.gray("Run 'ortho api' to see available APIs"));
+            console.log(chalk_1.default.gray("Run 'orth api' to see available APIs"));
             return;
         }
         console.log(chalk_1.default.bold(`\n${chalk_1.default.cyan(api.name)} (${api.slug})\n`));
         for (const endpoint of api.endpoints) {
             const method = chalk_1.default.yellow(endpoint.method.padEnd(6));
-            const price = endpoint.price ? chalk_1.default.green(`$${endpoint.price.toFixed(2)}`) : chalk_1.default.gray("free");
-            console.log(`${method} ${chalk_1.default.white(endpoint.path)} ${price}`);
+            console.log(`${method} ${chalk_1.default.white(endpoint.path)}`);
             if (endpoint.description) {
                 console.log(chalk_1.default.gray(`       ${endpoint.description.slice(0, 80)}${endpoint.description.length > 80 ? "..." : ""}`));
             }
         }
-        console.log(chalk_1.default.gray("\nRun 'ortho api " + slug + " <path>' for endpoint details"));
-        console.log(chalk_1.default.gray("Run 'ortho run " + slug + " <path>' to call an endpoint"));
+        console.log(chalk_1.default.gray("\nRun 'orth api show " + slug + " <path>' for endpoint details"));
+        console.log(chalk_1.default.gray("Run 'orth run " + slug + " <path>' to call an endpoint"));
     }
     catch (error) {
         spinner.stop();

package/dist/commands/run.js

@@ -11,12 +11,19 @@ async function runCommand(api, path, options) {
     const spinner = (0, ora_1.default)(`Calling ${api}${path}...`).start();
     try {
         // Parse query params
+        // Supports both `-q key=value -q key2=value2` and `-q 'key=value&key2=value2'`
         const query = {};
         if (options.query) {
             for (const param of options.query) {
-                const [key, value] = param.split("=");
-                if (key && value !== undefined) {
-                    query[key] = value;
+                // Split on & to handle URL-style query strings
+                const parts = param.split("&");
+                for (const part of parts) {
+                    const eqIndex = part.indexOf("=");
+                    if (eqIndex > 0) {
+                        const key = part.slice(0, eqIndex);
+                        const value = part.slice(eqIndex + 1);
+                        query[key] = decodeURIComponent(value);
+                    }
                 }
             }
         }
@@ -61,10 +68,6 @@ async function runCommand(api, path, options) {
             console.log(JSON.stringify(result.data, null, 2));
         }
         else {
-            // Show cost
-            if (result.price) {
-                console.log(chalk_1.default.gray(`Cost: $${result.price}`));
-            }
             // Pretty print the response
             console.log(chalk_1.default.bold("\nResponse:\n"));
             console.log(JSON.stringify(result.data, null, 2));

package/dist/commands/search.js

@@ -21,12 +21,9 @@ async function searchCommand(query, options) {
             console.log(chalk_1.default.cyan.bold(`${api.name}`) + chalk_1.default.gray(` (${api.slug})`));
             for (const endpoint of api.endpoints.slice(0, 3)) {
                 const method = endpoint.method.padEnd(6);
-                const price = endpoint.price ? chalk_1.default.green(`$${endpoint.price.toFixed(2)}`) : chalk_1.default.gray("free");
                 console.log(chalk_1.default.gray("  ") +
                     chalk_1.default.yellow(method) +
-                    chalk_1.default.white(endpoint.path) +
-                    chalk_1.default.gray(" - ") +
-                    price);
+                    chalk_1.default.white(endpoint.path));
                 if (endpoint.description) {
                     console.log(chalk_1.default.gray(`       ${endpoint.description.slice(0, 80)}${endpoint.description.length > 80 ? "..." : ""}`));
                 }

package/dist/commands/skills.d.ts

@@ -21,6 +21,13 @@ export declare function skillsSubmitCommand(inputPath: string | undefined, optio
     name?: string;
     tags?: string;
 }): Promise<void>;
+export declare function skillsPushCommand(slug: string, inputPath: string | undefined, options: {
+    name?: string;
+    tags?: string;
+}): Promise<void>;
+export declare function skillsUpdateCommand(slug: string, inputPath: string | undefined, options: {
+    force?: boolean;
+}): Promise<void>;
 export declare function skillsRequestVerificationCommand(slug: string): Promise<void>;
 export declare function skillsPublishCommand(slug: string, options: {
     unpublish?: boolean;

package/dist/commands/skills.js

@@ -43,6 +43,8 @@ exports.skillsCreateCommand = skillsCreateCommand;
 exports.skillsInstallCommand = skillsInstallCommand;
 exports.skillsInitCommand = skillsInitCommand;
 exports.skillsSubmitCommand = skillsSubmitCommand;
+exports.skillsPushCommand = skillsPushCommand;
+exports.skillsUpdateCommand = skillsUpdateCommand;
 exports.skillsRequestVerificationCommand = skillsRequestVerificationCommand;
 exports.skillsPublishCommand = skillsPublishCommand;
 exports.skillsRequestCommand = skillsRequestCommand;
@@ -63,7 +65,7 @@ const AGENT_DIRS = {
     openclaw: path.join(os.homedir(), ".openclaw", "skills"),
 };
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills list
+// orth skills list
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsListCommand(options) {
     const spinner = (0, ora_1.default)("Loading skills...").start();
@@ -93,8 +95,8 @@ async function skillsListCommand(options) {
             console.log(chalk_1.default.gray(`  Slug: ${skill.slug}`));
             console.log();
         }
-        console.log(chalk_1.default.gray("Run 'ortho skills show <slug>' to see skill details"));
-        console.log(chalk_1.default.gray("Run 'ortho skills add <slug>' to add a skill locally"));
+        console.log(chalk_1.default.gray("Run 'orth skills show <slug>' to see skill details"));
+        console.log(chalk_1.default.gray("Run 'orth skills add <slug>' to add a skill locally"));
     }
     catch (error) {
         spinner.stop();
@@ -103,7 +105,7 @@ async function skillsListCommand(options) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills search <query>
+// orth skills search <query>
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsSearchCommand(query, options) {
     const spinner = (0, ora_1.default)("Searching skills...").start();
@@ -128,7 +130,7 @@ async function skillsSearchCommand(query, options) {
             console.log(chalk_1.default.gray(`  Slug: ${skill.slug}`));
             console.log();
         }
-        console.log(chalk_1.default.gray("Run 'ortho skills show <slug>' for full details"));
+        console.log(chalk_1.default.gray("Run 'orth skills show <slug>' for full details"));
     }
     catch (error) {
         spinner.stop();
@@ -137,7 +139,7 @@ async function skillsSearchCommand(query, options) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills show <slug>
+// orth skills show <slug>
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsShowCommand(slug) {
     const spinner = (0, ora_1.default)("Loading skill...").start();
@@ -191,7 +193,7 @@ async function skillsShowCommand(slug) {
             console.log(chalk_1.default.bold("Install:"));
             console.log(chalk_1.default.white(`  ${skill.installCommand}`));
         }
-        console.log(chalk_1.default.gray(`\nRun 'ortho skills add ${skill.slug}' to add locally`));
+        console.log(chalk_1.default.gray(`\nRun 'orth skills add ${skill.slug}' to add locally`));
     }
     catch (error) {
         spinner.stop();
@@ -200,7 +202,7 @@ async function skillsShowCommand(slug) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills create <githubRepo>
+// orth skills create <githubRepo>
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsCreateCommand(githubRepo, options) {
     const spinner = (0, ora_1.default)("Creating skill from GitHub...").start();
@@ -242,7 +244,7 @@ async function skillsCreateCommand(githubRepo, options) {
             console.log(chalk_1.default.gray(`  ${data.skill.description}`));
         }
         console.log(chalk_1.default.bold("\nYour skill is on the platform but not yet verified."));
-        console.log(chalk_1.default.white(`To request verification: ${chalk_1.default.cyan(`ortho skills request-verification ${data.skill.slug}`)}`));
+        console.log(chalk_1.default.white(`To request verification: ${chalk_1.default.cyan(`orth skills request-verification ${data.skill.slug}`)}`));
         console.log(chalk_1.default.gray("Once verified, you can toggle discoverability anytime."));
     }
     catch (error) {
@@ -252,7 +254,7 @@ async function skillsCreateCommand(githubRepo, options) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills add <slug>
+// orth skills add <slug>
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsInstallCommand(slug, options) {
     const spinner = (0, ora_1.default)("Fetching skill...").start();
@@ -333,7 +335,7 @@ async function skillsInstallCommand(slug, options) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills init [name]
+// orth skills init [name]
 // ─────────────────────────────────────────────────────────────────────────────
 // Known binary/large file extensions to skip when reading local files
 const SKIP_EXTENSIONS = new Set([
@@ -419,7 +421,7 @@ Describe the next step.
         console.log(chalk_1.default.bold("\nNext steps:"));
         console.log(chalk_1.default.white("  1. Edit SKILL.md with your skill's instructions"));
         console.log(chalk_1.default.white("  2. Add any supporting files to scripts/, references/, or assets/"));
-        console.log(chalk_1.default.white(`  3. Submit to Orthogonal: ${chalk_1.default.cyan(`ortho skills submit ${dirPath}`)}`));
+        console.log(chalk_1.default.white(`  3. Submit to Orthogonal: ${chalk_1.default.cyan(`orth skills submit ${dirPath}`)}`));
     }
     catch (error) {
         console.error(chalk_1.default.red(`Error: ${error instanceof Error ? error.message : "Unknown error"}`));
@@ -427,7 +429,7 @@ Describe the next step.
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills submit [path]
+// orth skills submit [path]
 // ─────────────────────────────────────────────────────────────────────────────
 function readFilesRecursive(dirPath, basePath = "") {
     const files = [];
@@ -508,7 +510,7 @@ async function skillsSubmitCommand(inputPath, options) {
         if (!primaryFile) {
             spinner.stop();
             console.error(chalk_1.default.red("Error: No SKILL.md found in the root of the directory"));
-            console.log(chalk_1.default.gray("Run 'ortho skills init' to create a skill template"));
+            console.log(chalk_1.default.gray("Run 'orth skills init' to create a skill template"));
             process.exit(1);
         }
         // Parse frontmatter
@@ -565,7 +567,7 @@ async function skillsSubmitCommand(inputPath, options) {
             console.log(chalk_1.default.gray(`  ${data.skill.description.slice(0, 100)}`));
         }
         console.log(chalk_1.default.bold("\nYour skill is on the platform but not yet verified."));
-        console.log(chalk_1.default.white(`To request verification: ${chalk_1.default.cyan(`ortho skills request-verification ${data.skill.slug}`)}`));
+        console.log(chalk_1.default.white(`To request verification: ${chalk_1.default.cyan(`orth skills request-verification ${data.skill.slug}`)}`));
         console.log(chalk_1.default.gray("Once verified, you can toggle discoverability anytime."));
         console.log(chalk_1.default.gray(`Dashboard: https://orthogonal.com/dashboard/skills`));
     }
@@ -576,7 +578,154 @@ async function skillsSubmitCommand(inputPath, options) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills request-verification <slug>
+// orth skills push <slug> [path]
+// Push local skill files to remote (replaces remote with local)
+// ─────────────────────────────────────────────────────────────────────────────
+async function skillsPushCommand(slug, inputPath, options) {
+    const dirPath = inputPath ? path.resolve(inputPath) : process.cwd();
+    const spinner = (0, ora_1.default)("Reading skill files...").start();
+    try {
+        // Validate directory exists
+        if (!fs.existsSync(dirPath) || !fs.statSync(dirPath).isDirectory()) {
+            spinner.stop();
+            console.error(chalk_1.default.red(`Error: ${dirPath} is not a directory`));
+            process.exit(1);
+        }
+        // Read all files
+        const files = readFilesRecursive(dirPath);
+        if (files.length === 0) {
+            spinner.stop();
+            console.error(chalk_1.default.red("Error: No files found in the directory"));
+            process.exit(1);
+        }
+        // Validate SKILL.md exists
+        const primaryFile = files.find((f) => f.isPrimary);
+        if (!primaryFile) {
+            spinner.stop();
+            console.error(chalk_1.default.red("Error: No SKILL.md found in the root of the directory"));
+            process.exit(1);
+        }
+        // Parse frontmatter
+        // Note: Unlike submit, name/description are optional for updates
+        // We only send them if provided (to allow partial updates)
+        const frontmatter = parseFrontmatter(primaryFile.content);
+        const skillName = options.name || frontmatter.name;
+        const skillDescription = frontmatter.description;
+        // Check size limits
+        const totalSize = files.reduce((acc, f) => acc + f.content.length, 0);
+        if (files.length > 50) {
+            spinner.stop();
+            console.error(chalk_1.default.red("Error: Too many files (max 50)"));
+            process.exit(1);
+        }
+        if (totalSize > 1024 * 1024) {
+            spinner.stop();
+            console.error(chalk_1.default.red("Error: Total content too large (max 1MB)"));
+            process.exit(1);
+        }
+        spinner.text = "Pushing skill to Orthogonal...";
+        const tags = options.tags
+            ? options.tags.split(",").map((t) => t.trim())
+            : undefined;
+        const updatePayload = {
+            files: files.map((f) => ({
+                filePath: f.filePath,
+                content: f.content,
+                isPrimary: f.isPrimary,
+            })),
+        };
+        if (skillName)
+            updatePayload.name = skillName;
+        if (skillDescription)
+            updatePayload.description = skillDescription;
+        if (tags)
+            updatePayload.tags = tags;
+        const data = await (0, api_js_1.apiRequest)(`/skills/${slug}`, {
+            method: "PUT",
+            body: updatePayload,
+        });
+        spinner.stop();
+        console.log(chalk_1.default.green(`\n✓ Skill pushed successfully`));
+        console.log(chalk_1.default.bold(`\n${data.skill.name}`));
+        console.log(chalk_1.default.gray(`  Slug: ${data.skill.slug}`));
+        console.log(chalk_1.default.gray(`  Files: ${files.length}`));
+        if (data.skill.description) {
+            console.log(chalk_1.default.gray(`  ${data.skill.description.slice(0, 100)}`));
+        }
+    }
+    catch (error) {
+        spinner.stop();
+        console.error(chalk_1.default.red(`Error: ${error instanceof Error ? error.message : "Unknown error"}`));
+        process.exit(1);
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// orth skills update <slug> [path]
+// Pull latest version from Orthogonal and update local files
+// ─────────────────────────────────────────────────────────────────────────────
+async function skillsUpdateCommand(slug, inputPath, options) {
+    const spinner = (0, ora_1.default)(`Fetching skill '${slug}' from Orthogonal...`).start();
+    try {
+        // Fetch skill from API
+        const data = await (0, api_js_1.apiRequest)(`/skills/${slug}`);
+        const skill = data.skill;
+        if (!skill.files || skill.files.length === 0) {
+            spinner.stop();
+            console.error(chalk_1.default.red("Error: Skill has no files to download"));
+            process.exit(1);
+        }
+        // Determine target directory
+        const skillDirName = slug.replace(/\//g, "-");
+        const dirPath = inputPath
+            ? path.resolve(inputPath)
+            : path.join(process.cwd(), skillDirName);
+        // Check if directory exists and has content
+        if (fs.existsSync(dirPath) && !options.force) {
+            const contents = fs.readdirSync(dirPath);
+            if (contents.length > 0) {
+                spinner.stop();
+                console.log(chalk_1.default.yellow(`Directory ${dirPath} already exists with content.`));
+                console.log(chalk_1.default.white(`Use ${chalk_1.default.cyan("--force")} to overwrite existing files.`));
+                process.exit(1);
+            }
+        }
+        spinner.text = "Writing files...";
+        // Create directory
+        fs.mkdirSync(dirPath, { recursive: true });
+        // Write all files
+        for (const file of skill.files) {
+            // Sanitize file path to prevent path traversal
+            const sanitized = file.filePath.replace(/\.\.\//g, "").replace(/\.\.\\/g, "");
+            const filePath = path.resolve(dirPath, sanitized);
+            // Ensure resolved path is within dirPath
+            if (!filePath.startsWith(path.resolve(dirPath))) {
+                console.log(chalk_1.default.yellow(`  Skipped unsafe file path: ${file.filePath}`));
+                continue;
+            }
+            const fileDir = path.dirname(filePath);
+            fs.mkdirSync(fileDir, { recursive: true });
+            fs.writeFileSync(filePath, file.content, "utf-8");
+        }
+        spinner.stop();
+        console.log(chalk_1.default.green(`\n✓ Skill updated from Orthogonal`));
+        console.log(chalk_1.default.bold(`\n${skill.name}`));
+        console.log(chalk_1.default.gray(`  Path: ${dirPath}`));
+        console.log(chalk_1.default.gray(`  Files: ${skill.files.length}`));
+        console.log(chalk_1.default.bold("\nFiles written:"));
+        for (const file of skill.files) {
+            const primary = file.isPrimary ? chalk_1.default.green(" (primary)") : "";
+            console.log(chalk_1.default.gray("  ") + chalk_1.default.white(file.filePath) + primary);
+        }
+        console.log(chalk_1.default.gray(`\nTo push changes back: ${chalk_1.default.cyan(`orth skills push ${slug} ${dirPath}`)}`));
+    }
+    catch (error) {
+        spinner.stop();
+        console.error(chalk_1.default.red(`Error: ${error instanceof Error ? error.message : "Unknown error"}`));
+        process.exit(1);
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// orth skills request-verification <slug>
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsRequestVerificationCommand(slug) {
     const spinner = (0, ora_1.default)("Submitting verification request...").start();
@@ -604,16 +753,16 @@ async function skillsRequestVerificationCommand(slug) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills publish <slug> (deprecated - redirects to request-verification)
+// orth skills publish <slug> (deprecated - redirects to request-verification)
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsPublishCommand(slug, options) {
     console.log(chalk_1.default.yellow("Note: Direct publishing has been replaced with a verification workflow."));
-    console.log(chalk_1.default.white(`\nTo request your skill to be verified, run:\n  ${chalk_1.default.cyan(`ortho skills request-verification ${slug}`)}`));
+    console.log(chalk_1.default.white(`\nTo request your skill to be verified, run:\n  ${chalk_1.default.cyan(`orth skills request-verification ${slug}`)}`));
     console.log(chalk_1.default.white("Once verified, you can toggle discoverability from your dashboard."));
     console.log(chalk_1.default.gray("\nOr manage from the dashboard: https://orthogonal.com/dashboard/skills"));
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills request <input>
+// orth skills request <input>
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsRequestCommand(input) {
     const spinner = (0, ora_1.default)("Submitting skill request...").start();

package/dist/index.js

@@ -175,6 +175,23 @@ skillsGroup
     (0, analytics_js_1.trackEvent)("skills.submit", { path: inputPath });
     await (0, skills_js_1.skillsSubmitCommand)(inputPath, options);
 }));
+skillsGroup
+    .command("update <slug> [path]")
+    .description("Pull latest skill version from Orthogonal to local directory")
+    .option("-f, --force", "Overwrite existing files")
+    .action(asyncAction(async (slug, inputPath, options) => {
+    (0, analytics_js_1.trackEvent)("skills.update", { slug, path: inputPath });
+    await (0, skills_js_1.skillsUpdateCommand)(slug, inputPath, options);
+}));
+skillsGroup
+    .command("push <slug> [path]")
+    .description("Push local skill files to Orthogonal (update remote)")
+    .option("-n, --name <name>", "Override skill name from frontmatter")
+    .option("-t, --tags <tags>", "Comma-separated tags")
+    .action(asyncAction(async (slug, inputPath, options) => {
+    (0, analytics_js_1.trackEvent)("skills.push", { slug, path: inputPath });
+    await (0, skills_js_1.skillsPushCommand)(slug, inputPath, options);
+}));
 skillsGroup
     .command("request-verification <slug>")
     .description("Request verification for your skill (required before discoverability)")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orth/cli",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "CLI to access all APIs and skills on the Orthogonal platform",
   "main": "dist/index.js",
   "bin": {