@orth/cli 0.2.0

package/dist/config.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = void 0;
+exports.getApiKey = getApiKey;
+exports.setApiKey = setApiKey;
+exports.clearApiKey = clearApiKey;
+exports.requireApiKey = requireApiKey;
+const conf_1 = __importDefault(require("conf"));
+exports.config = new conf_1.default({
+    projectName: "orthogonal-cli",
+    schema: {
+        apiKey: {
+            type: "string",
+        },
+    },
+});
+function getApiKey() {
+    return process.env.ORTHOGONAL_API_KEY || exports.config.get("apiKey");
+}
+function setApiKey(key) {
+    exports.config.set("apiKey", key);
+}
+function clearApiKey() {
+    exports.config.delete("apiKey");
+}
+function requireApiKey() {
+    const key = getApiKey();
+    if (!key) {
+        console.error("Error: Not authenticated. Run 'orth login' first or set ORTHOGONAL_API_KEY.");
+        process.exit(1);
+    }
+    return key;
+}

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,249 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const search_js_1 = require("./commands/search.js");
+const run_js_1 = require("./commands/run.js");
+const api_js_1 = require("./commands/api.js");
+const auth_js_1 = require("./commands/auth.js");
+const account_js_1 = require("./commands/account.js");
+const code_js_1 = require("./commands/code.js");
+const skills_js_1 = require("./commands/skills.js");
+const apiRequest_js_1 = require("./commands/apiRequest.js");
+const analytics_js_1 = require("./analytics.js");
+/**
+ * Wraps an async action callback so that rejected promises are caught,
+ * logged, and cause the process to exit with code 1.  Without this,
+ * Commander.js silently swallows unhandled rejections from async actions.
+ */
+function asyncAction(fn) {
+    return (...args) => {
+        fn(...args).catch((err) => {
+            console.error(err instanceof Error ? err.message : "Unknown error");
+            process.exit(1);
+        });
+    };
+}
+const program = new commander_1.Command();
+program
+    .name("orth")
+    .description("CLI to access all APIs and skills on the Orthogonal platform")
+    .version("0.2.0");
+// ─────────────────────────────────────────────────────────────────────────────
+// Auth commands (top-level)
+// ─────────────────────────────────────────────────────────────────────────────
+program
+    .command("login")
+    .description("Authenticate with your Orthogonal API key")
+    .option("-k, --key <key>", "API key (or set ORTHOGONAL_API_KEY env var)")
+    .action(asyncAction(async (options) => {
+    (0, analytics_js_1.trackEvent)("login");
+    await (0, auth_js_1.loginCommand)(options);
+}));
+program
+    .command("logout")
+    .description("Remove stored API key")
+    .action(asyncAction(async () => {
+    (0, analytics_js_1.trackEvent)("logout");
+    await (0, auth_js_1.logoutCommand)();
+}));
+program
+    .command("whoami")
+    .description("Show current authentication status")
+    .action(asyncAction(async () => {
+    (0, analytics_js_1.trackEvent)("whoami");
+    await (0, auth_js_1.whoamiCommand)();
+}));
+// ─────────────────────────────────────────────────────────────────────────────
+// Account commands (top-level)
+// ─────────────────────────────────────────────────────────────────────────────
+program
+    .command("balance")
+    .description("Check your credit balance")
+    .action(asyncAction(async () => {
+    (0, analytics_js_1.trackEvent)("balance");
+    await (0, account_js_1.balanceCommand)();
+}));
+program
+    .command("usage")
+    .description("Show recent API usage")
+    .option("-l, --limit <number>", "Number of recent calls", "10")
+    .action(asyncAction(async (options) => {
+    (0, analytics_js_1.trackEvent)("usage");
+    await (0, account_js_1.usageCommand)(options);
+}));
+// ─────────────────────────────────────────────────────────────────────────────
+// orth api <subcommand> — API commands group
+// ─────────────────────────────────────────────────────────────────────────────
+const apiGroup = program.command("api").description("API marketplace commands");
+apiGroup
+    .command("list")
+    .description("List available APIs")
+    .action(asyncAction(async () => {
+    (0, analytics_js_1.trackEvent)("api.list");
+    await (0, api_js_1.apiCommand)(undefined, undefined, {});
+}));
+apiGroup
+    .command("show <slug> [path]")
+    .description("Show API endpoints or endpoint details")
+    .option("--x402", "Output x402 payment URL only")
+    .option("--x402-full", "Output full x402 payment details")
+    .action(asyncAction(async (slug, path, options) => {
+    (0, analytics_js_1.trackEvent)("api.show", { slug, path });
+    await (0, api_js_1.apiCommand)(slug, path, options);
+}));
+apiGroup
+    .command("search <query>")
+    .description("Search for APIs using natural language")
+    .option("-l, --limit <number>", "Max results", "10")
+    .action(asyncAction(async (query, options) => {
+    (0, analytics_js_1.trackEvent)("api.search", { query });
+    await (0, search_js_1.searchCommand)(query, options);
+}));
+apiGroup
+    .command("run <slug> <path>")
+    .description("Call an API endpoint")
+    .option("-X, --method <method>", "HTTP method", "GET")
+    .option("-q, --query <params...>", "Query params (key=value)")
+    .option("-b, --body <json>", "Request body JSON")
+    .option("-d, --data <json>", "Alias for --body")
+    .option("--raw", "Output raw JSON without formatting")
+    .action(asyncAction(async (slug, path, options) => {
+    (0, analytics_js_1.trackEvent)("api.run", { slug, path });
+    await (0, run_js_1.runCommand)(slug, path, options);
+}));
+apiGroup
+    .command("code <slug> <path>")
+    .description("Generate integration code for an endpoint")
+    .option("-l, --lang <language>", "Language: typescript, python, curl", "typescript")
+    .action(asyncAction(async (slug, path, options) => {
+    (0, analytics_js_1.trackEvent)("api.code", { slug, path });
+    await (0, code_js_1.codeCommand)(slug, path, options);
+}));
+apiGroup
+    .command("request <docsUrl>")
+    .description("Request an API to be added to the platform")
+    .option("-d, --description <text>", "Additional notes about the API")
+    .action(asyncAction(async (docsUrl, options) => {
+    (0, analytics_js_1.trackEvent)("api.request", { docsUrl });
+    await (0, apiRequest_js_1.apiRequestCommand)(docsUrl, options);
+}));
+// ─────────────────────────────────────────────────────────────────────────────
+// orth skills <subcommand> — Skills commands group
+// ─────────────────────────────────────────────────────────────────────────────
+const skillsGroup = program
+    .command("skills")
+    .description("Agent skills library commands");
+skillsGroup
+    .command("list")
+    .description("List discoverable skills")
+    .option("-l, --limit <number>", "Max results", "20")
+    .action(asyncAction(async (options) => {
+    (0, analytics_js_1.trackEvent)("skills.list");
+    await (0, skills_js_1.skillsListCommand)(options);
+}));
+skillsGroup
+    .command("search <query>")
+    .description("Search for agent skills")
+    .option("-l, --limit <number>", "Max results", "20")
+    .action(asyncAction(async (query, options) => {
+    (0, analytics_js_1.trackEvent)("skills.search", { query });
+    await (0, skills_js_1.skillsSearchCommand)(query, options);
+}));
+skillsGroup
+    .command("show <slug>")
+    .description("Show skill details and files")
+    .action(asyncAction(async (slug) => {
+    (0, analytics_js_1.trackEvent)("skills.show", { slug });
+    await (0, skills_js_1.skillsShowCommand)(slug);
+}));
+skillsGroup
+    .command("init [name]")
+    .description("Initialize a new skill directory with SKILL.md template")
+    .option("--bare", "Only create SKILL.md, skip subdirectories")
+    .option("--path <dir>", "Output directory")
+    .action(asyncAction(async (name, options) => {
+    (0, analytics_js_1.trackEvent)("skills.init", { name });
+    await (0, skills_js_1.skillsInitCommand)(name, options);
+}));
+skillsGroup
+    .command("submit [path]")
+    .description("Submit a local skill to the Orthogonal platform")
+    .option("-n, --name <name>", "Override skill name from frontmatter")
+    .option("-t, --tags <tags>", "Comma-separated tags")
+    .action(asyncAction(async (inputPath, options) => {
+    (0, analytics_js_1.trackEvent)("skills.submit", { path: inputPath });
+    await (0, skills_js_1.skillsSubmitCommand)(inputPath, options);
+}));
+skillsGroup
+    .command("request-verification <slug>")
+    .description("Request verification for your skill (required before discoverability)")
+    .action(asyncAction(async (slug) => {
+    (0, analytics_js_1.trackEvent)("skills.request-verification", { slug });
+    await (0, skills_js_1.skillsRequestVerificationCommand)(slug);
+}));
+skillsGroup
+    .command("create <githubRepo>")
+    .description("Create a skill from a GitHub URL or owner/repo")
+    .option("-p, --path <path>", "Path to skill within repo")
+    .option("-r, --ref <ref>", "Git ref (branch/tag)", "main")
+    .option("-n, --name <name>", "Skill name (auto-detected from SKILL.md)")
+    .action(asyncAction(async (githubRepo, options) => {
+    (0, analytics_js_1.trackEvent)("skills.create", { githubRepo });
+    await (0, skills_js_1.skillsCreateCommand)(githubRepo, options);
+}));
+skillsGroup
+    .command("add <slug>")
+    .description("Add a skill to your local agent skills directories")
+    .option("--agent <agent>", "Install for specific agent only (cursor, claude, copilot)")
+    .action(asyncAction(async (slug, options) => {
+    (0, analytics_js_1.trackEvent)("skills.add", { slug });
+    await (0, skills_js_1.skillsInstallCommand)(slug, options);
+}));
+skillsGroup
+    .command("publish <slug>")
+    .description("Toggle skill discoverability")
+    .option("--unpublish", "Make skill private")
+    .action(asyncAction(async (slug, options) => {
+    (0, analytics_js_1.trackEvent)("skills.publish", { slug });
+    await (0, skills_js_1.skillsPublishCommand)(slug, options);
+}));
+skillsGroup
+    .command("request <input>")
+    .description("Request a skill to be added (GitHub URL or description)")
+    .action(asyncAction(async (input) => {
+    (0, analytics_js_1.trackEvent)("skills.request", { input });
+    await (0, skills_js_1.skillsRequestCommand)(input);
+}));
+// ─────────────────────────────────────────────────────────────────────────────
+// Backward-compatible aliases (flat commands)
+// ─────────────────────────────────────────────────────────────────────────────
+program
+    .command("search <query>")
+    .description("Search for APIs (alias for 'orth api search')")
+    .option("-l, --limit <number>", "Max results", "10")
+    .action(asyncAction(async (query, options) => {
+    (0, analytics_js_1.trackEvent)("search", { query });
+    await (0, search_js_1.searchCommand)(query, options);
+}));
+program
+    .command("run <api> <path>")
+    .description("Call an API endpoint (alias for 'orth api run')")
+    .option("-X, --method <method>", "HTTP method", "GET")
+    .option("-q, --query <params...>", "Query params (key=value)")
+    .option("-b, --body <json>", "Request body JSON")
+    .option("-d, --data <json>", "Alias for --body")
+    .option("--raw", "Output raw JSON without formatting")
+    .action(asyncAction(async (api, path, options) => {
+    (0, analytics_js_1.trackEvent)("run", { api, path });
+    await (0, run_js_1.runCommand)(api, path, options);
+}));
+program
+    .command("code <api> <path>")
+    .description("Generate integration code (alias for 'orth api code')")
+    .option("-l, --lang <language>", "Language: typescript, python, curl", "typescript")
+    .action(asyncAction(async (api, path, options) => {
+    (0, analytics_js_1.trackEvent)("code", { api, path });
+    await (0, code_js_1.codeCommand)(api, path, options);
+}));
+program.parse();

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@orth/cli",
+  "version": "0.2.0",
+  "description": "CLI to access all APIs and skills on the Orthogonal platform",
+  "main": "dist/index.js",
+  "bin": {
+    "orth": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc -w",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "orthogonal",
+    "api",
+    "cli",
+    "ai-agents",
+    "skills",
+    "mcp"
+  ],
+  "author": "Orthogonal <founders@orthogonal.sh> (https://orthogonal.sh)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/orthogonal-sh/cli.git"
+  },
+  "homepage": "https://orthogonal.sh",
+  "bugs": {
+    "url": "https://github.com/orthogonal-sh/cli/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "conf": "^12.0.0",
+    "node-fetch": "^3.3.2",
+    "ora": "^8.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}