@myapihq/cli 1.0.5 → 1.0.7

package/dist/commands/account.js

@@ -43,25 +43,14 @@ const output_js_1 = require("../output.js");
 const readline = __importStar(require("readline"));
 async function create() {
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    const ask = (q) => new Promise(resolve => rl.question(q, resolve));
-    const choice = await ask('Do you want to (1) auto-create a new account or (2) paste an existing API key? [1/2]: ');
+    const key = await new Promise(resolve => rl.question('Paste your API key (get it from https://myapihq.com): ', resolve));
     rl.close();
-    if (choice.trim() === '2') {
-        const rl2 = readline.createInterface({ input: process.stdin, output: process.stdout });
-        const key = await new Promise(resolve => rl2.question('Paste your API key: ', resolve));
-        rl2.close();
-        (0, config_js_1.saveConfig)({ api_key: key.trim(), account_id: '', pin: '' });
-        (0, output_js_1.success)(`API key saved to ~/.myapi/config.json`);
+    if (!key.trim()) {
+        (0, output_js_1.error)('API key cannot be empty.');
         return;
     }
-    const agent = await sdk_1.hq.createAgentAccount();
-    const keyInfo = await sdk_1.hq.createApiKey(agent.token, 'default');
-    (0, config_js_1.saveConfig)({
-        api_key: keyInfo.api_key,
-        account_id: agent.account_id,
-        pin: agent.pin
-    });
-    (0, output_js_1.success)(`Account created!\n\nAPI Key:    ${keyInfo.api_key}\nAccount ID: ${agent.account_id}\nPIN:        ${agent.pin}\n\nCredentials saved to ~/.myapi/config.json\nKeep your PIN safe — it's the only way to recover your account.`);
+    (0, config_js_1.saveConfig)({ api_key: key.trim(), account_id: '', pin: '' });
+    (0, output_js_1.success)(`API key saved to ~/.myapi/config.json`);
 }
 async function token(flags) {
     let pin = flags.pin;

package/dist/commands/billing.js

@@ -8,26 +8,49 @@ const sdk_1 = require("@myapihq/sdk");
 const config_js_1 = require("../config.js");
 const output_js_1 = require("../output.js");
 async function balance(flags) {
+    if (flags.help) {
+        (0, output_js_1.info)('Usage: myapi billing balance\n\nShows your current account balance, credits, and payment method status.');
+        return;
+    }
     const config = (0, config_js_1.requireConfig)();
     const result = await sdk_1.hq.getBalance(config.api_key);
-    (0, output_js_1.info)(`Balance: $${(result.balance_cents / 100).toFixed(2)}  |  Payment method: ${result.has_payment_method ? 'yes' : 'no'}`);
+    const bal = result.balance_display || `$${(result.balance_cents / 100).toFixed(2)}`;
+    const cred = result.credits_display || `$${((result.credits_cents || 0) / 100).toFixed(2)}`;
+    const pm = result.has_payment_method ? 'yes' : 'no';
+    (0, output_js_1.info)(`Balance: ${bal}  |  Credits: ${cred}  |  Payment method: ${pm}`);
 }
 async function history(flags) {
+    if (flags.help) {
+        (0, output_js_1.info)('Usage: myapi billing history\n\nShows your recent billing transactions and top-ups.');
+        return;
+    }
     const config = (0, config_js_1.requireConfig)();
     const items = await sdk_1.hq.getBillingHistory(config.api_key);
     (0, output_js_1.printTable)(items);
 }
 async function topup(amountStr, flags) {
-    if (!amountStr)
-        (0, output_js_1.error)("Missing amount");
+    if (flags.help) {
+        (0, output_js_1.info)('Usage: myapi billing topup <amount>\n\nAdds funds to your account balance using your saved payment method.\nExample: myapi billing topup 10.00');
+        return;
+    }
+    if (!amountStr) {
+        (0, output_js_1.error)("Missing amount. Usage: myapi billing topup <amount>");
+        return;
+    }
     const amount = parseFloat(amountStr);
-    if (isNaN(amount))
-        (0, output_js_1.error)("Invalid amount");
+    if (isNaN(amount)) {
+        (0, output_js_1.error)("Invalid amount. Must be a number (e.g., 10.00)");
+        return;
+    }
     const config = (0, config_js_1.requireConfig)();
     const result = await sdk_1.hq.topUp(config.api_key, Math.round(amount * 100));
     (0, output_js_1.success)(`Top up successful! New balance: $${(result.new_balance_cents / 100).toFixed(2)}`);
 }
 async function setup(flags) {
+    if (flags.help) {
+        (0, output_js_1.info)('Usage: myapi billing setup\n\nGenerates a secure Stripe Checkout link to add or update your payment method.');
+        return;
+    }
     const config = (0, config_js_1.requireConfig)();
     const result = await sdk_1.hq.setupPayment(config.api_key);
     (0, output_js_1.success)(`Open this URL in your browser to set up payment:\n${result.url}`);

package/dist/commands/keys.d.ts

@@ -0,0 +1,3 @@
+export declare function createNew(flags: Record<string, string | boolean>): Promise<void>;
+export declare function list(flags: Record<string, string | boolean>): Promise<void>;
+export declare function revoke(id: string, flags: Record<string, string | boolean>): Promise<void>;

package/dist/commands/keys.js

@@ -0,0 +1,80 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNew = createNew;
+exports.list = list;
+exports.revoke = revoke;
+const sdk_1 = require("@myapihq/sdk");
+const config_js_1 = require("../config.js");
+const output_js_1 = require("../output.js");
+const readline = __importStar(require("readline"));
+async function createNew(flags) {
+    if (flags.help) {
+        (0, output_js_1.info)('Usage: myapi keys create\n\nCreates a new API key. You will be prompted to enter a name for the key.');
+        return;
+    }
+    const config = (0, config_js_1.requireConfig)();
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const name = await new Promise(resolve => rl.question('Enter a name for the new key: ', resolve));
+    rl.close();
+    if (!name.trim()) {
+        (0, output_js_1.error)('Key name cannot be empty.');
+        return;
+    }
+    const keyInfo = await sdk_1.hq.createApiKey(config.api_key, name.trim());
+    (0, output_js_1.success)(`New API key created!\n\nName: ${keyInfo.prefix}...\nKey:  ${keyInfo.api_key}\n\nMake sure to copy your new API key now. You won't be able to see it again!`);
+}
+async function list(flags) {
+    if (flags.help) {
+        (0, output_js_1.info)('Usage: myapi keys list\n\nLists all API keys associated with your account.');
+        return;
+    }
+    const config = (0, config_js_1.requireConfig)();
+    const keysList = await sdk_1.hq.listApiKeys(config.api_key);
+    (0, output_js_1.printTable)(keysList);
+}
+async function revoke(id, flags) {
+    if (flags.help) {
+        (0, output_js_1.info)('Usage: myapi keys revoke <id>\n\nRevokes an API key permanently.');
+        return;
+    }
+    if (!id) {
+        (0, output_js_1.error)("Missing key ID. Usage: myapi keys revoke <id>");
+        return;
+    }
+    const config = (0, config_js_1.requireConfig)();
+    await sdk_1.hq.revokeApiKey(config.api_key, id);
+    (0, output_js_1.success)(`Key ${id} revoked successfully.`);
+}

package/dist/commands/org.js

@@ -10,39 +10,71 @@ const config_js_1 = require("../config.js");
 const output_js_1 = require("../output.js");
 const utils_js_1 = require("../utils.js");
 async function create(flags) {
-    if (!flags.name)
-        (0, output_js_1.error)("Missing --name flag");
+    if (flags.help) {
+        (0, output_js_1.info)('Usage: myapi org create --name="My Org" [options]\n\nOptions:\n  --name              Organization name (required)\n  --tagline           Short tagline\n  --description       Detailed description\n  --business-sector   Sector (e.g. Technology)\n  --logo-url          URL to logo image');
+        return;
+    }
+    if (!flags.name) {
+        (0, output_js_1.error)("Missing --name flag. Run 'myapi org create --help' for details.");
+        return;
+    }
     const config = (0, config_js_1.requireConfig)();
     const payload = { name: flags.name };
     if (flags.tagline)
         payload.tagline = flags.tagline;
     if (flags.description)
         payload.description = flags.description;
+    if (flags['business-sector'])
+        payload.business_sector = flags['business-sector'];
+    if (flags['logo-url'])
+        payload.logo_url = flags['logo-url'];
     const org = await sdk_1.hq.createOrg(config.api_key, payload);
     (0, output_js_1.success)(`Org created! ID: ${org.id}, Name: ${org.name}`);
 }
 async function list(flags) {
+    if (flags.help) {
+        (0, output_js_1.info)('Usage: myapi org list\n\nLists all organizations in your account.');
+        return;
+    }
     const config = (0, config_js_1.requireConfig)();
     const orgs = await sdk_1.hq.listOrgs(config.api_key);
     (0, output_js_1.printTable)(orgs);
 }
 async function get(id, flags) {
-    if (!id)
-        (0, output_js_1.error)("Missing org id");
+    if (flags.help) {
+        (0, output_js_1.info)('Usage: myapi org get <id>\n\nFetches details of a specific organization.');
+        return;
+    }
+    if (!id) {
+        (0, output_js_1.error)("Missing org id. Usage: myapi org get <id>");
+        return;
+    }
     const config = (0, config_js_1.requireConfig)();
     const org = await sdk_1.hq.getOrg(config.api_key, id);
     (0, output_js_1.printJson)(org);
 }
 async function del(id, flags) {
-    if (!id)
-        (0, output_js_1.error)("Missing org id");
+    if (flags.help) {
+        (0, output_js_1.info)('Usage: myapi org delete <id>\n\nDeletes an organization.');
+        return;
+    }
+    if (!id) {
+        (0, output_js_1.error)("Missing org id. Usage: myapi org delete <id>");
+        return;
+    }
     const config = (0, config_js_1.requireConfig)();
     await sdk_1.hq.deleteOrg(config.api_key, id);
     (0, output_js_1.success)(`Org ${id} deleted`);
 }
 async function importOrg(domain, flags) {
-    if (!domain)
-        (0, output_js_1.error)("Missing domain");
+    if (flags.help) {
+        (0, output_js_1.info)('Usage: myapi org import <domain>\n\nAutomatically extracts brand info from an existing website and creates an organization.');
+        return;
+    }
+    if (!domain) {
+        (0, output_js_1.error)("Missing domain. Usage: myapi org import <domain>");
+        return;
+    }
     const config = (0, config_js_1.requireConfig)();
     const result = await sdk_1.hq.importOrg(config.api_key, domain);
     const importId = result.job_id;

package/dist/commands/setup.js

@@ -34,14 +34,9 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setup = setup;
-const sdk_1 = require("@myapihq/sdk");
 const config_js_1 = require("../config.js");
 const output_js_1 = require("../output.js");
 const readline = __importStar(require("readline"));
-const child_process_1 = require("child_process");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const os = __importStar(require("os"));
 function ask(rl, q) {
     return new Promise(resolve => rl.question(q, resolve));
 }
@@ -51,115 +46,31 @@ function yn(answer, defaultYes = true) {
         return defaultYes;
     return t === 'y' || t === 'yes';
 }
-async function getOrCreateKey(rl) {
-    const choice = await ask(rl, '\n(1) Auto-create a new account  (2) Paste an existing API key [1/2]: ');
-    if (choice.trim() === '2') {
-        const key = await ask(rl, 'Paste your API key: ');
-        (0, config_js_1.saveConfig)({ api_key: key.trim(), account_id: '', pin: '' });
-        (0, output_js_1.success)('API key saved to ~/.myapi/config.json');
-        return key.trim();
-    }
-    (0, output_js_1.info)('Creating account...');
-    const agent = await sdk_1.hq.createAgentAccount();
-    const keyInfo = await sdk_1.hq.createApiKey(agent.token, 'default');
-    (0, config_js_1.saveConfig)({ api_key: keyInfo.api_key, account_id: agent.account_id, pin: agent.pin });
-    (0, output_js_1.success)(`Account created!\n\nAPI Key: ${keyInfo.api_key}\nPIN:     ${agent.pin}\n\nSave your PIN — it's the only way to recover your account.`);
-    return keyInfo.api_key;
-}
-function registerClaudeMcp() {
-    try {
-        (0, child_process_1.execSync)('claude mcp add myapi -- npx -y @myapihq/mcp', { stdio: 'inherit' });
-        (0, output_js_1.success)('Claude Code MCP registered');
-    }
-    catch {
-        (0, output_js_1.info)('Could not auto-register. Run manually:\n  claude mcp add myapi -- npx -y @myapihq/mcp');
-    }
-}
-function registerGeminiMcp() {
-    const configPath = path.join(os.homedir(), '.gemini', 'settings.json');
-    try {
-        let settings = {};
-        if (fs.existsSync(configPath)) {
-            settings = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-        }
-        settings.mcpServers = settings.mcpServers ?? {};
-        settings.mcpServers.myapi = { command: 'npx', args: ['-y', '@myapihq/mcp'] };
-        fs.mkdirSync(path.dirname(configPath), { recursive: true });
-        fs.writeFileSync(configPath, JSON.stringify(settings, null, 2));
-        (0, output_js_1.success)('Gemini CLI MCP registered (~/.gemini/settings.json)');
-    }
-    catch {
-        (0, output_js_1.info)('Could not auto-configure Gemini CLI. Add manually to ~/.gemini/settings.json:');
-        (0, output_js_1.info)('  { "mcpServers": { "myapi": { "command": "npx", "args": ["-y", "@myapihq/mcp"] } } }');
-    }
+async function getKey(rl) {
+    const key = await ask(rl, 'Paste your API key (get it from https://myapihq.com): ');
+    (0, config_js_1.saveConfig)({ api_key: key.trim(), account_id: '', pin: '' });
+    (0, output_js_1.success)('API key saved to ~/.myapi/config.json');
+    return key.trim();
 }
 async function setup() {
     (0, output_js_1.info)('MyAPI Setup\n');
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    // Step 1: credentials
     const existing = (0, config_js_1.loadConfig)();
     if (existing?.api_key) {
         const reuse = await ask(rl, `Found existing account (${existing.account_id || existing.api_key.slice(0, 20) + '...'}). Use it? [Y/n]: `);
         if (!yn(reuse, true)) {
-            await getOrCreateKey(rl);
+            await getKey(rl);
         }
         else {
             (0, output_js_1.info)('Using existing credentials.');
         }
     }
     else {
-        await getOrCreateKey(rl);
-    }
-    // Step 2: which agents
-    (0, output_js_1.info)('\nWhich AI agents do you use?');
-    const useClaude = yn(await ask(rl, '  Claude Code?        [Y/n]: '), true);
-    const useGemini = yn(await ask(rl, '  Gemini CLI?         [Y/n]: '), true);
-    const useCursor = yn(await ask(rl, '  Cursor?             [y/N]: '), false);
-    const useWindsurf = yn(await ask(rl, '  Windsurf?           [y/N]: '), false);
-    const useKiro = yn(await ask(rl, '  Kiro?               [y/N]: '), false);
-    const useCopilot = yn(await ask(rl, '  GitHub Copilot?     [y/N]: '), false);
-    const useOther = yn(await ask(rl, '  Other / Codex?      [y/N]: '), false);
-    // Step 3: Claude — MCP or Skills or both
-    let claudeMcp = false;
-    let claudeSkills = false;
-    if (useClaude) {
-        (0, output_js_1.info)('\nFor Claude Code, how do you want to connect?');
-        claudeMcp = yn(await ask(rl, '  MCP server — live API calls via tool use? [Y/n]: '), true);
-        claudeSkills = yn(await ask(rl, '  Skills plugin — inline docs + prompts?   [y/N]: '), false);
+        await getKey(rl);
     }
     rl.close();
-    // Step 4: apply
-    (0, output_js_1.info)('\nApplying configuration...\n');
-    if (claudeMcp)
-        registerClaudeMcp();
-    if (useGemini)
-        registerGeminiMcp();
-    if (claudeSkills) {
-        (0, output_js_1.info)('To install the MyAPI skill inside Claude Code, run:');
-        (0, output_js_1.info)('  /plugin marketplace add myapihq/claude-skills');
-        (0, output_js_1.info)('  /plugin install my-api-hq@myapi-skills');
-    }
-    const skillsUrl = 'https://github.com/myapihq/agent-skills/blob/main/skills/my-api-hq/SKILL.md';
-    if (useCursor) {
-        (0, output_js_1.info)('\nCursor — copy the skill into .cursor/rules/:');
-        (0, output_js_1.info)(`  ${skillsUrl}`);
-    }
-    if (useWindsurf) {
-        (0, output_js_1.info)('\nWindsurf — add the skill to your rules configuration:');
-        (0, output_js_1.info)(`  ${skillsUrl}`);
-    }
-    if (useKiro) {
-        (0, output_js_1.info)('\nKiro — copy the skill into .kiro/skills/:');
-        (0, output_js_1.info)(`  ${skillsUrl}`);
-    }
-    if (useCopilot) {
-        (0, output_js_1.info)('\nGitHub Copilot — paste the skill into .github/copilot-instructions.md:');
-        (0, output_js_1.info)(`  ${skillsUrl}`);
-    }
-    if (useOther) {
-        (0, output_js_1.info)('\nOther agents — copy the skill markdown as a system prompt or instruction file:');
-        (0, output_js_1.info)(`  ${skillsUrl}`);
-    }
-    (0, output_js_1.info)('');
+    (0, output_js_1.info)('\nTo integrate MyAPI with AI agents (Claude, Cursor, Copilot, etc.),');
+    (0, output_js_1.info)('please follow the instructions in our skills repository:');
+    (0, output_js_1.info)('https://github.com/myapihq/agent-skills\n');
     (0, output_js_1.success)('Setup complete! Try: myapi billing balance');
 }

package/dist/index.js

@@ -38,7 +38,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const utils_js_1 = require("./utils.js");
 const output_js_1 = require("./output.js");
 const sdk_1 = require("@myapihq/sdk");
-const accountCmd = __importStar(require("./commands/account.js"));
+const keysCmd = __importStar(require("./commands/keys.js"));
 const billingCmd = __importStar(require("./commands/billing.js"));
 const orgCmd = __importStar(require("./commands/org.js"));
 const setupCmd = __importStar(require("./commands/setup.js"));
@@ -52,29 +52,49 @@ async function main() {
     try {
         switch (command) {
             case 'setup':
+                if (flags.help) {
+                    (0, output_js_1.info)('Usage: myapi setup\n\nSetup CLI credentials and view integration instructions');
+                    break;
+                }
                 await setupCmd.setup();
                 break;
-            case 'account':
+            case 'keys':
+                if (!subcommand || (flags.help && !subcommand)) {
+                    (0, output_js_1.info)('Usage: myapi keys <subcommand>\n\nSubcommands:\n  list       List your API keys\n  create     Create a new API key\n  revoke     Revoke an API key (e.g. myapi keys revoke <id>)');
+                    break;
+                }
                 if (subcommand === 'create')
-                    await accountCmd.create();
-                else if (subcommand === 'token')
-                    await accountCmd.token(flags);
-                else if (subcommand === 'keys')
-                    await accountCmd.listKeys(flags);
+                    await keysCmd.createNew(flags);
+                else if (subcommand === 'list')
+                    await keysCmd.list(flags);
                 else if (subcommand === 'revoke')
-                    await accountCmd.revokeKey(restArgs[0], flags);
+                    await keysCmd.revoke(restArgs[0], flags);
                 else
                     printHelp();
                 break;
             case 'org':
+                if (!subcommand || (flags.help && !subcommand)) {
+                    (0, output_js_1.info)('Usage: myapi org <subcommand>\n\nSubcommands:\n  list       List organizations\n  create     Create an organization\n  get        Get details of an organization\n  delete     Delete an organization\n  import     Extract org from domain');
+                    break;
+                }
                 if (subcommand === 'list')
                     await orgCmd.list(flags);
                 else if (subcommand === 'create')
                     await orgCmd.create(flags);
+                else if (subcommand === 'get')
+                    await orgCmd.get(restArgs[0], flags);
+                else if (subcommand === 'delete')
+                    await orgCmd.del(restArgs[0], flags);
+                else if (subcommand === 'import')
+                    await orgCmd.importOrg(restArgs[0], flags);
                 else
                     printHelp();
                 break;
             case 'billing':
+                if (!subcommand || (flags.help && !subcommand)) {
+                    (0, output_js_1.info)('Usage: myapi billing <subcommand>\n\nSubcommands:\n  balance    Check balance\n  history    View billing history\n  topup      Top up your balance\n  setup      Setup a payment method');
+                    break;
+                }
                 if (subcommand === 'balance')
                     await billingCmd.balance(flags);
                 else if (subcommand === 'history')
@@ -107,11 +127,11 @@ function printHelp() {
 Usage: myapi <command> [subcommand] [args]
 
 Commands:
-  account
-  billing
-  org
-  setup
+  keys         Manage API keys
+  billing      Check balance and manage billing
+  org          Manage organizations
+  setup        Setup CLI credentials and view integration instructions
 
-Run "myapi <command>" for subcommand help.`);
+Run "myapi <command> --help" for subcommand help.`);
 }
 main().catch(err => { (0, output_js_1.error)(err.message || String(err)); });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myapihq/cli",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "MyAPI command-line interface",
   "main": "dist/index.js",
   "bin": {

package/src/commands/billing.ts

@@ -3,21 +3,44 @@ import { requireConfig } from '../config.js';
 import { success, error, printTable, info } from '../output.js';
 
 export async function balance(flags: Record<string, string | boolean>) {
+  if (flags.help) {
+    info('Usage: myapi billing balance\n\nShows your current account balance, credits, and payment method status.');
+    return;
+  }
   const config = requireConfig();
   const result = await hq.getBalance(config.api_key);
-  info(`Balance: $${(result.balance_cents / 100).toFixed(2)}  |  Payment method: ${result.has_payment_method ? 'yes' : 'no'}`);
+  
+  const bal = result.balance_display || `$${(result.balance_cents / 100).toFixed(2)}`;
+  const cred = result.credits_display || `$${((result.credits_cents || 0) / 100).toFixed(2)}`;
+  const pm = result.has_payment_method ? 'yes' : 'no';
+  
+  info(`Balance: ${bal}  |  Credits: ${cred}  |  Payment method: ${pm}`);
 }
 
 export async function history(flags: Record<string, string | boolean>) {
+  if (flags.help) {
+    info('Usage: myapi billing history\n\nShows your recent billing transactions and top-ups.');
+    return;
+  }
   const config = requireConfig();
   const items = await hq.getBillingHistory(config.api_key);
   printTable(items as unknown as Record<string, unknown>[]);
 }
 
 export async function topup(amountStr: string, flags: Record<string, string | boolean>) {
-  if (!amountStr) error("Missing amount");
+  if (flags.help) {
+    info('Usage: myapi billing topup <amount>\n\nAdds funds to your account balance using your saved payment method.\nExample: myapi billing topup 10.00');
+    return;
+  }
+  if (!amountStr) {
+    error("Missing amount. Usage: myapi billing topup <amount>");
+    return;
+  }
   const amount = parseFloat(amountStr);
-  if (isNaN(amount)) error("Invalid amount");
+  if (isNaN(amount)) {
+    error("Invalid amount. Must be a number (e.g., 10.00)");
+    return;
+  }
   
   const config = requireConfig();
   const result = await hq.topUp(config.api_key, Math.round(amount * 100));
@@ -25,6 +48,10 @@ export async function topup(amountStr: string, flags: Record<string, string | bo
 }
 
 export async function setup(flags: Record<string, string | boolean>) {
+  if (flags.help) {
+    info('Usage: myapi billing setup\n\nGenerates a secure Stripe Checkout link to add or update your payment method.');
+    return;
+  }
   const config = requireConfig();
   const result = await hq.setupPayment(config.api_key);
   success(`Open this URL in your browser to set up payment:\n${result.url}`);

package/src/commands/keys.ts

@@ -0,0 +1,47 @@
+import { hq } from '@myapihq/sdk';
+import { requireConfig } from '../config.js';
+import { success, error, printTable, info } from '../output.js';
+import * as readline from 'readline';
+
+export async function createNew(flags: Record<string, string | boolean>) {
+  if (flags.help) {
+    info('Usage: myapi keys create\n\nCreates a new API key. You will be prompted to enter a name for the key.');
+    return;
+  }
+  const config = requireConfig();
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const name = await new Promise<string>(resolve => rl.question('Enter a name for the new key: ', resolve));
+  rl.close();
+  
+  if (!name.trim()) {
+    error('Key name cannot be empty.');
+    return;
+  }
+
+  const keyInfo = await hq.createApiKey(config.api_key, name.trim());
+  success(`New API key created!\n\nName: ${keyInfo.prefix}...\nKey:  ${keyInfo.api_key}\n\nMake sure to copy your new API key now. You won't be able to see it again!`);
+}
+
+export async function list(flags: Record<string, string | boolean>) {
+  if (flags.help) {
+    info('Usage: myapi keys list\n\nLists all API keys associated with your account.');
+    return;
+  }
+  const config = requireConfig();
+  const keysList = await hq.listApiKeys(config.api_key);
+  printTable(keysList as unknown as Record<string, unknown>[]);
+}
+
+export async function revoke(id: string, flags: Record<string, string | boolean>) {
+  if (flags.help) {
+    info('Usage: myapi keys revoke <id>\n\nRevokes an API key permanently.');
+    return;
+  }
+  if (!id) {
+    error("Missing key ID. Usage: myapi keys revoke <id>");
+    return;
+  }
+  const config = requireConfig();
+  await hq.revokeApiKey(config.api_key, id);
+  success(`Key ${id} revoked successfully.`);
+}