@orth/cli 0.2.3 → 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 'orth 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 || [];
@@ -133,13 +128,12 @@ async function apiCommand(slug, path, options) {
         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 'orth api " + slug + " <path>' for endpoint details"));
+        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) {

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,10 +21,13 @@ export declare function skillsSubmitCommand(inputPath: string | undefined, optio
     name?: string;
     tags?: string;
 }): Promise<void>;
-export declare function skillsUpdateCommand(slug: string, inputPath: string | undefined, options: {
+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,7 @@ exports.skillsCreateCommand = skillsCreateCommand;
 exports.skillsInstallCommand = skillsInstallCommand;
 exports.skillsInitCommand = skillsInitCommand;
 exports.skillsSubmitCommand = skillsSubmitCommand;
+exports.skillsPushCommand = skillsPushCommand;
 exports.skillsUpdateCommand = skillsUpdateCommand;
 exports.skillsRequestVerificationCommand = skillsRequestVerificationCommand;
 exports.skillsPublishCommand = skillsPublishCommand;
@@ -577,9 +578,10 @@ async function skillsSubmitCommand(inputPath, options) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// orth skills update <slug> [path]
+// orth skills push <slug> [path]
+// Push local skill files to remote (replaces remote with local)
 // ─────────────────────────────────────────────────────────────────────────────
-async function skillsUpdateCommand(slug, inputPath, options) {
+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 {
@@ -621,7 +623,7 @@ async function skillsUpdateCommand(slug, inputPath, options) {
             console.error(chalk_1.default.red("Error: Total content too large (max 1MB)"));
             process.exit(1);
         }
-        spinner.text = "Updating skill...";
+        spinner.text = "Pushing skill to Orthogonal...";
         const tags = options.tags
             ? options.tags.split(",").map((t) => t.trim())
             : undefined;
@@ -643,7 +645,7 @@ async function skillsUpdateCommand(slug, inputPath, options) {
             body: updatePayload,
         });
         spinner.stop();
-        console.log(chalk_1.default.green(`\n✓ Skill updated successfully`));
+        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}`));
@@ -658,6 +660,71 @@ async function skillsUpdateCommand(slug, inputPath, options) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
+// 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) {

package/dist/index.js

@@ -177,13 +177,21 @@ skillsGroup
 }));
 skillsGroup
     .command("update <slug> [path]")
-    .description("Update an existing skill with local files")
-    .option("-n, --name <name>", "Override skill name from frontmatter")
-    .option("-t, --tags <tags>", "Comma-separated tags")
+    .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.3",
+  "version": "0.2.4",
   "description": "CLI to access all APIs and skills on the Orthogonal platform",
   "main": "dist/index.js",
   "bin": {