@myapihq/cli 1.0.40 → 1.0.47

package/dist/commands/auth.d.ts

@@ -1,3 +1,3 @@
-export declare function signup(): Promise<void>;
-export declare function whoami(): Promise<void>;
-export declare function switchCmd(): Promise<void>;
+export declare function signup(flags?: Record<string, string | boolean>): Promise<void>;
+export declare function whoami(flags?: Record<string, string | boolean>): Promise<void>;
+export declare function switchCmd(flags?: Record<string, string | boolean>, indexArg?: string): Promise<void>;

package/dist/commands/auth.js

@@ -39,7 +39,11 @@ async function patch(path, body, apiKey) {
     return json.data ?? json;
 }
 // myapi auth signup — upgrade anonymous session to registered account.
-export async function signup() {
+export async function signup(flags = {}) {
+    if (flags.help) {
+        info('Usage: myapi auth signup\n\nUpgrades an anonymous account to a registered account by linking an email.\nA verification code will be sent — you must enter it interactively.\nIf the email is already in use, adds it as a second account instead.');
+        return;
+    }
     const config = loadConfig();
     if (!config?.api_key)
         error('Not configured. Run: myapi auth setup');
@@ -66,10 +70,9 @@ export async function signup() {
         info(`› Sent a code to ${email} · paste it below`);
         const code = (await ask(rl, '› Code? ')).trim();
         const data = await post('/hq/account/verify-code', { email, code });
-        const skillsAns = (await ask(rl, '› Install the MyAPI skills pack? (Y/n) ')).trim();
-        const wantsSkills = yn(skillsAns);
+        const skillsFromFlag = flags['install-skills'] ? true : flags['no-skills'] ? false : null;
+        const wantsSkills = skillsFromFlag !== null ? skillsFromFlag : yn((await ask(rl, '› Install the MyAPI skills pack? (Y/n) ')).trim());
         if (upgradeOk) {
-            // Upgrade: update current account in place.
             saveConfig({
                 ...config,
                 api_key: data.api_key,
@@ -83,12 +86,10 @@ export async function signup() {
             success(`› Welcome! Account upgraded · ${email}`);
         }
         else {
-            // Add as new account and switch to it.
             const idx = addAccount({
                 api_key: data.api_key,
                 account_id: data.account_id,
                 email,
-                pin: '',
                 default_org: data.default_org,
                 default_funnel: data.default_funnel,
                 is_anonymous: false,
@@ -105,7 +106,11 @@ export async function signup() {
     }
 }
 // myapi auth whoami — show current session info.
-export async function whoami() {
+export async function whoami(flags = {}) {
+    if (flags.help) {
+        info('Usage: myapi auth whoami\n\nDisplays the active account details: email, account ID, default org, default funnel, account type, and current balance.');
+        return;
+    }
     const config = loadConfig();
     if (!config?.api_key)
         error('Not configured. Run: myapi auth setup');
@@ -120,11 +125,15 @@ export async function whoami() {
         info(`Balance:  ${bal.balance_display}  |  Credits: ${bal.credits_display}`);
     }
     catch {
-        // Balance fetch is best-effort; don't fail whoami if it errors.
+        info(`Balance:  (unavailable)`);
     }
 }
-// myapi auth switch — switch between saved accounts.
-export async function switchCmd() {
+// myapi auth switch [index] — switch between saved accounts.
+export async function switchCmd(flags = {}, indexArg) {
+    if (flags.help) {
+        info('Usage: myapi auth switch [index]\n\nSwitches the active account. Pass an account index to skip the prompt.\n\nExample:\n  myapi auth switch 2');
+        return;
+    }
     const accounts = listAccounts();
     if (accounts.length === 0)
         error('No accounts configured. Run: myapi auth setup');
@@ -138,19 +147,22 @@ export async function switchCmd() {
         const marker = a.active ? ' ◀ active' : '';
         info(`  ${a.index + 1}. ${label}${marker}`);
     }
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    try {
-        const ans = (await ask(rl, `› Switch to account (1-${accounts.length})? `)).trim();
-        const idx = parseInt(ans, 10) - 1;
-        if (isNaN(idx) || idx < 0 || idx >= accounts.length) {
-            error('Invalid selection.');
+    let idxStr = indexArg ?? '';
+    if (!idxStr) {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        try {
+            idxStr = (await ask(rl, `› Switch to account (1-${accounts.length})? `)).trim();
         }
-        if (switchAccount(idx)) {
-            const a = accounts[idx];
-            success(`› Switched to ${a.email ?? a.account_id}`);
+        finally {
+            rl.close();
         }
     }
-    finally {
-        rl.close();
+    const idx = parseInt(idxStr, 10) - 1;
+    if (isNaN(idx) || idx < 0 || idx >= accounts.length) {
+        error('Invalid selection.');
+    }
+    if (switchAccount(idx)) {
+        const a = accounts[idx];
+        success(`› Switched to ${a.email ?? a.account_id}`);
     }
 }

package/dist/commands/billing.js

@@ -17,7 +17,7 @@ export async function balance(flags) {
 }
 export async function history(flags) {
     if (flags.help) {
-        info('Usage: myapi billing history [--json]\n\nShows your recent billing transactions and top-ups.');
+        info('Usage: myapi billing history [--json]\n\nShows your recent billing transactions and top-ups.\n\nFlags:\n  --json   Output raw JSON');
         return;
     }
     const config = requireConfig();
@@ -40,7 +40,7 @@ export async function history(flags) {
 }
 export async function topup(amountStr, flags) {
     if (flags.help) {
-        info('Usage: myapi billing topup <amount>\n\nAmount is in whole dollars (e.g. "10" charges $10).\nUse --yes to skip confirmation.\nExample: myapi billing topup 10');
+        info('Usage: myapi billing topup <amount>\n\nAmount is in whole dollars (e.g. "10" charges $10).\nUse --yes to skip confirmation.\nExample: myapi billing topup 10\n\nFlags:\n  --yes   Skip confirmation prompt');
         return;
     }
     const amount = Math.round(parseFloat(amountStr));

package/dist/commands/domain.js

@@ -6,7 +6,7 @@ export async function check(domainArg, flags) {
     const orgId = flags.org || config.default_org;
     const domain = domainArg || config.default_domain;
     if (!orgId || !domain)
-        error("Missing required arguments.\nUsage: myapi domain check <domain> --org <id>\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+        error("Missing required arguments.\nUsage: myapi domain check <domain> --org <id>\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
     const res = await sdkDomain.checkDomain(config.api_key, orgId, domain);
     if (res.available) {
         const price = res.price_display || `$${(res.price_cents / 100).toFixed(2)}`;
@@ -21,7 +21,7 @@ export async function register(domainArg, flags) {
     const orgId = flags.org || config.default_org;
     const domain = domainArg || config.default_domain;
     if (!orgId || !domain)
-        error("Missing required arguments.\nUsage: myapi domain register <domain> --org <id> [--years <num>]\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+        error("Missing required arguments.\nUsage: myapi domain register <domain> --org <id> [--years <num>]\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
     const years = parseInt(flags.years) || 1;
     const res = await sdkDomain.registerDomain(config.api_key, orgId, domain, years);
     success(`Registered ${domain}!\n${JSON.stringify(res, null, 2)}`);
@@ -31,7 +31,7 @@ export async function importDomain(domainArg, flags) {
     const orgId = flags.org || config.default_org;
     const domain = domainArg || config.default_domain;
     if (!orgId || !domain)
-        error("Missing required arguments.\nUsage: myapi domain import <domain> --org <id> [--namecheap-user <user> --namecheap-key <key>]\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+        error("Missing required arguments.\nUsage: myapi domain import <domain> --org <id> [--namecheap-user <user> --namecheap-key <key>]\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
     const payload = { domain };
     if (flags['namecheap-user'])
         payload.namecheap_api_user = flags['namecheap-user'];
@@ -44,7 +44,7 @@ export async function list(flags) {
     const config = requireConfig();
     const orgId = flags.org || config.default_org;
     if (!orgId)
-        error("Missing required arguments.\nUsage: myapi domain list --org <id> [--filter=all|unassigned|org]\n(Or set a default org via: myapi auth config set-org <id>)");
+        error("Missing required arguments.\nUsage: myapi domain list --org <id> [--filter=all|unassigned|org]\n(Set default: myapi auth config set-org <id>)");
     const filter = flags.filter;
     const domains = await sdkDomain.listDomains(config.api_key, orgId, filter);
     printTable(domains);
@@ -55,7 +55,7 @@ export async function assign(domainArg, flags) {
     const domain = domainArg || config.default_domain;
     const targetOrgId = flags.target;
     if (!orgId || !domain || !targetOrgId)
-        error("Missing required arguments.\nUsage: myapi domain assign <domain> --org <id> --target <target_org_id>\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+        error("Missing required arguments.\nUsage: myapi domain assign <domain> --org <id> --target <target_org_id>\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
     await sdkDomain.assignDomain(config.api_key, orgId, domain, targetOrgId);
     success(`Assigned ${domain} to org ${targetOrgId}`);
 }
@@ -64,7 +64,7 @@ export async function unassign(domainArg, flags) {
     const orgId = flags.org || config.default_org;
     const domain = domainArg || config.default_domain;
     if (!orgId || !domain)
-        error("Missing required arguments.\nUsage: myapi domain unassign <domain> --org <id>\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+        error("Missing required arguments.\nUsage: myapi domain unassign <domain> --org <id>\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
     await sdkDomain.unassignDomain(config.api_key, orgId, domain);
     success(`Unassigned ${domain} from org ${orgId}`);
 }
@@ -73,7 +73,7 @@ export async function status(domainArg, flags) {
     const orgId = flags.org || config.default_org;
     const domain = domainArg || config.default_domain;
     if (!orgId || !domain)
-        error("Missing required arguments.\nUsage: myapi domain status <domain> --org <id>\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+        error("Missing required arguments.\nUsage: myapi domain status <domain> --org <id>\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
     const res = await sdkDomain.getDomainStatus(config.api_key, orgId, domain);
     const display = {
         domain: res.domain,
@@ -88,7 +88,7 @@ export async function settings(domainArg, flags) {
     const orgId = flags.org || config.default_org;
     const domain = domainArg || config.default_domain;
     if (!orgId || !domain)
-        error("Missing required arguments.\nUsage: myapi domain settings <domain> --org <id>\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+        error("Missing required arguments.\nUsage: myapi domain settings <domain> --org <id>\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
     const res = await sdkDomain.getDomainSettings(config.api_key, orgId, domain);
     printJson(res);
 }
@@ -97,7 +97,7 @@ export async function updateSettings(domainArg, flags) {
     const orgId = flags.org || config.default_org;
     const domain = domainArg || config.default_domain;
     if (!orgId || !domain)
-        error("Missing required arguments.\nUsage: myapi domain update-settings <domain> --org <id> [--security=...] [--browser-check=...] [--purge-cache]\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+        error("Missing required arguments.\nUsage: myapi domain update-settings <domain> --org <id> [--security=...] [--browser-check=...] [--purge-cache]\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
     const payload = {};
     if (flags.security)
         payload.security_level = flags.security;
@@ -110,7 +110,7 @@ export async function updateSettings(domainArg, flags) {
 }
 export async function run(subcommand, args, flags) {
     if (!subcommand || (flags.help && !subcommand)) {
-        info('Usage: myapi domain <subcommand>\n\nSubcommands:\n  list             List domains\n  check            Check domain availability\n  register         Register a domain\n  import           Import an existing domain\n  assign           Assign domain to org\n  unassign         Unassign domain from its current org\n  status           Get domain status\n  settings         Get domain settings\n  update-settings  Update domain settings\n\nNote: All domain commands require the --org <id> flag.');
+        info('Usage: myapi domain <subcommand>\n\nSubcommands:\n  list             List domains\n  check            Check domain availability\n  register         Register a domain\n  import           Import an existing domain\n  assign           Assign domain to org\n  unassign         Unassign domain from its current org\n  status           Get domain status\n  settings         Get domain settings\n  update-settings  Update domain settings\n\nTip: Set defaults with "myapi auth config set-org <id>" to skip --org on every command.');
         return;
     }
     if (flags.help) {

package/dist/commands/funnel.js

@@ -80,22 +80,22 @@ export async function verify(id, flags) {
 }
 export async function run(subcommand, args, flags) {
     if (!subcommand || (flags.help && !subcommand)) {
-        info('Usage: myapi funnel <subcommand>\n\nSubcommands:\n  list       List funnels\n  create     Create a funnel\n  get        Get funnel details\n  delete     Delete a funnel\n  push       Push a raw HTML page to a slug\n  verify     Verify links and webhooks\n\nNote: All funnel commands require the --org <id> flag.');
+        info('Usage: myapi funnel <subcommand>\n\nSubcommands:\n  list       List funnels\n  create     Create a funnel\n  get        Get funnel details\n  delete     Delete a funnel\n  push       Push a raw HTML page to a slug\n\nNote: Most funnel commands require the --org <id> flag (or set a default via myapi auth config set-org <id>).');
         return;
     }
     if (flags.help) {
         if (subcommand === 'list')
-            info('Usage: myapi funnel list --org <id>');
+            info('Usage: myapi funnel list --org <id>\n\nLists all funnels in the organization.\n\nFlags:\n  --org <id>   Organization ID (or set default via myapi auth config set-org)');
         else if (subcommand === 'create')
-            info('Usage: myapi funnel create --org <id>');
+            info('Usage: myapi funnel create --org <id>\n\nCreates a new funnel in the organization.\n\nFlags:\n  --org <id>   Organization ID (or set default via myapi auth config set-org)');
         else if (subcommand === 'get')
-            info('Usage: myapi funnel get <id> --org <id>');
+            info('Usage: myapi funnel get <id> --org <id>\n\nFetches details of a specific funnel.\n\nFlags:\n  --org <id>   Organization ID (or set default via myapi auth config set-org)');
         else if (subcommand === 'delete')
-            info('Usage: myapi funnel delete <id> --org <id>');
+            info('Usage: myapi funnel delete <id> --org <id>\n\nDeletes a funnel permanently.\n\nFlags:\n  --org <id>   Organization ID (or set default via myapi auth config set-org)');
         else if (subcommand === 'push')
-            info('Usage: myapi funnel push [funnel_id] [slug] < index.html\n\nPushes HTML from stdin. Uses your default funnel and slug "/" when omitted.');
-        else if (subcommand === 'verify')
-            info('Usage: myapi funnel verify <id> --org <id> [--slug <slug>]\n\nVerifies syntax and structure before pushing.');
+            info('Usage: myapi funnel push [funnel_id] [slug] < index.html\n\nPushes an HTML page from stdin to a slug path within a funnel.\nUses your configured default funnel and slug "/" when arguments are omitted.\n\nFlags:\n  --org <id>     Organization ID\n  --slug <path>  Target slug path (default: /)');
+        else if (subcommand === 'pull')
+            info('Usage: myapi funnel pull [funnel_id] [slug]\n\nFetches the HTML content of a funnel page.');
         return;
     }
     if (subcommand === 'list')

package/dist/commands/keys.js

@@ -4,15 +4,18 @@ import { success, error, printTable, info, printJson } from '../output.js';
 import * as readline from 'readline';
 export async function createNew(flags) {
     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.');
+        info('Usage: myapi auth api-keys create [--name <name>]\n\nCreates a new API key.\n\nFlags:\n  --name <name>   Key name (skips prompt)');
         return;
     }
     const config = 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();
+    let name = flags.name || '';
+    if (!name) {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        name = await new Promise(resolve => rl.question('Enter a name for the new key: ', resolve));
+        rl.close();
+    }
     if (!name.trim()) {
-        error('Key name cannot be empty.');
+        error('Key name cannot be empty. Use --name <name>');
         return;
     }
     const keyInfo = await hq.createApiKey(config.api_key, name.trim());

package/dist/commands/setup.js

@@ -137,14 +137,14 @@ export async function importKey(apiKey, flags) {
     }
     catch { /* non-fatal */ }
     const wantsSkills = flags['install-skills'] ? true : flags['no-skills'] ? false : true;
-    addAccount({ api_key: apiKey, account_id: accountId, pin: '', email, default_org: defaultOrg, default_funnel: defaultFunnel, skills_installed: wantsSkills });
+    addAccount({ api_key: apiKey, account_id: accountId, email, default_org: defaultOrg, default_funnel: defaultFunnel, skills_installed: wantsSkills });
     success(`› ✓ Key imported${email ? ` · ${email}` : ''}`);
     if (wantsSkills)
         await installSkills();
 }
 export async function setup(flags = {}) {
     if (flags.help) {
-        info('Usage: myapi auth setup [--anonymous] [--yes] [--install-skills|--no-skills]\n\nFlags:\n  --anonymous       Skip registration, create anonymous account\n  --yes             Skip confirmation prompts\n  --install-skills  Auto-install skills pack\n  --no-skills       Skip skills installation');
+        info('Usage: myapi auth setup [--anonymous] [--yes] [--install-skills|--no-skills]\n\nConfigures your account and stores your default org and funnel so you don\'t need to pass --org or --funnel on every command.\n\nFlags:\n  --anonymous       Skip registration, create anonymous account\n  --yes             Skip confirmation prompts\n  --install-skills  Auto-install skills pack\n  --no-skills       Skip skills installation');
         return;
     }
     info('› Configuring MyAPI…');
@@ -189,7 +189,7 @@ export async function setup(flags = {}) {
     const skillsFromFlag = flags['install-skills'] ? true : flags['no-skills'] ? false : null;
     try {
         const useAnon = flags.anonymous || flags.anon;
-        const createAns = useAnon ? 'n' : await ask(rl, '› Create an account? (Y/n) ');
+        const createAns = useAnon ? 'n' : await ask(rl, '› Register with email? (Y/n, or N to continue anonymously) ');
         if (yn(createAns)) {
             const data = await registeredFlow(rl);
             apiKey = data.api_key;
@@ -213,7 +213,6 @@ export async function setup(flags = {}) {
         addAccount({
             api_key: apiKey,
             account_id: accountId,
-            pin: '',
             email: email || undefined,
             default_org: defaultOrg,
             default_funnel: defaultFunnel,

package/dist/commands/update.d.ts

@@ -1,4 +1,4 @@
 export declare function checkForUpdate(currentVersion: string): Promise<void>;
-export declare function update(): Promise<void>;
+export declare function update(flags?: Record<string, string | boolean>): Promise<void>;
 export declare function latestVersion(): Promise<string | null>;
 export declare function isNewer(latest: string, current: string): boolean;

package/dist/commands/update.js

@@ -14,21 +14,34 @@ export async function checkForUpdate(currentVersion) {
         const latest = data.version;
         if (latest && isNewer(latest, currentVersion)) {
             info(`\n› New version available (${currentVersion} → ${latest}) — installing…`);
-            execSync('npm install -g @myapihq/cli', { stdio: 'pipe' });
-            const config = loadConfig();
-            if (config?.skills_installed) {
-                await installSkills();
+            try {
+                // Use the npm binary next to the active node so nvm users update the right install.
+                const npmBin = process.execPath.replace(/[/\\]node$/, '/npm');
+                execSync(`"${npmBin}" install -g @myapihq/cli`, { stdio: 'pipe' });
+                const config = loadConfig();
+                if (config?.skills_installed) {
+                    await installSkills();
+                }
+                success(`› MyAPI CLI updated to ${latest}. Re-run your command.\n`);
+                process.exit(0);
+            }
+            catch (installErr) {
+                const msg = installErr?.stderr?.toString?.() || installErr?.message || String(installErr);
+                info(`› Auto-update failed: ${msg.trim()}`);
+                info(`› Run manually: npm install -g @myapihq/cli`);
             }
-            success(`› MyAPI CLI updated to ${latest}. Re-run your command.\n`);
-            process.exit(0);
         }
     }
     catch {
-        // Network or install errors are silently ignored.
+        // Network errors are silently ignored.
     }
 }
 // myapi update — explicit update, same logic as auto-update.
-export async function update() {
+export async function update(flags = {}) {
+    if (flags.help) {
+        info('Usage: myapi update\n\nUpdates the MyAPI CLI and skills pack to the latest published version.\nEquivalent to: npm install -g @myapihq/cli');
+        return;
+    }
     info('› Checking for updates…');
     try {
         const res = await fetch(REGISTRY_URL, { signal: AbortSignal.timeout(5000) });
@@ -39,7 +52,8 @@ export async function update() {
     }
     catch { /* proceed anyway */ }
     try {
-        execSync('npm install -g @myapihq/cli', { stdio: 'inherit' });
+        const npmBin = process.execPath.replace(/[/\\]node$/, '/npm');
+        execSync(`"${npmBin}" install -g @myapihq/cli`, { stdio: 'inherit' });
     }
     catch {
         process.exit(1);

package/dist/config.d.ts

@@ -1,7 +1,6 @@
 export interface AccountEntry {
     api_key: string;
     account_id: string;
-    pin: string;
     email?: string;
     default_org?: string;
     default_funnel?: string;

package/dist/config.js

@@ -34,7 +34,7 @@ export function loadConfig() {
     const envKey = process.env.MYAPI_API_KEY || process.env.MYAPI_KEY;
     const full = loadFullConfig();
     if (!full && envKey)
-        return { api_key: envKey, account_id: '', pin: '' };
+        return { api_key: envKey, account_id: '' };
     if (!full)
         return null;
     const active = full.accounts[full.active] ?? full.accounts[0];

package/dist/index.js

@@ -41,25 +41,35 @@ async function main() {
     try {
         switch (command) {
             case 'auth':
-                if (!subcommand || flags.help) {
-                    info('Usage: myapi auth <subcommand>\n\nSubcommands:\n  setup           Configure your account\n  whoami          Show current account\n  signup          Upgrade anonymous account to registered\n  switch          Switch between accounts\n  config          Manage CLI defaults (org_id, domain…)\n  install-skills  Install the MyAPI skills pack\n  api-keys        Manage API keys');
+                if (!subcommand || (flags.help && !subcommand)) {
+                    info('Usage: myapi auth <subcommand>\n\nSubcommands:\n  setup           Configure your account\n  import-key      Import an existing API key non-interactively\n  whoami          Show current account\n  signup          Upgrade anonymous account to registered\n  switch [index]  Switch between accounts\n  config          Manage CLI defaults (org_id, domain…)\n  install-skills  Install the MyAPI skills pack\n  api-keys        Manage API keys');
                     break;
                 }
                 if (subcommand === 'setup')
-                    await setupCmd.setup();
+                    await setupCmd.setup(flags);
+                else if (subcommand === 'import-key')
+                    await setupCmd.importKey(restArgs[0], flags);
                 else if (subcommand === 'whoami')
-                    await authCmd.whoami();
+                    await authCmd.whoami(flags);
                 else if (subcommand === 'signup')
-                    await authCmd.signup();
+                    await authCmd.signup(flags);
                 else if (subcommand === 'switch')
-                    await authCmd.switchCmd();
+                    await authCmd.switchCmd(flags, restArgs[0]);
                 else if (subcommand === 'install-skills') {
+                    if (flags.help) {
+                        info('Usage: myapi auth install-skills\n\nInstalls the MyAPI skills pack for Claude, Gemini, and Cursor agents.');
+                        break;
+                    }
                     await setupCmd.installSkills();
                     success('› Skills installed.');
                 }
                 else if (subcommand === 'config')
                     await configCmd.run(restArgs[0], restArgs.slice(1), flags);
                 else if (subcommand === 'api-keys') {
+                    if (flags.help && !restArgs[0]) {
+                        info('Usage: myapi auth api-keys <subcommand>\n\nSubcommands:\n  list             List all API keys\n  create           Create a new API key\n  revoke <id>      Revoke an API key by ID');
+                        break;
+                    }
                     if (!restArgs[0]) {
                         info('Usage: myapi auth api-keys <list|create|revoke>');
                         break;
@@ -75,7 +85,7 @@ async function main() {
                     info('Unknown subcommand. Run: myapi auth --help');
                 break;
             case 'update':
-                await updateCmd.update();
+                await updateCmd.update(flags);
                 break;
             case 'org':
                 if (!subcommand || (flags.help && !subcommand)) {
@@ -117,6 +127,13 @@ async function main() {
             case 'funnel':
                 await funnelCmd.run(subcommand, restArgs, flags);
                 break;
+            // Convenience aliases
+            case 'setup':
+                await setupCmd.setup(flags);
+                break;
+            case 'config':
+                await configCmd.run(subcommand, restArgs, flags);
+                break;
             default:
                 error(`Unknown command: ${command}. Run "myapi" for available commands.`);
         }
@@ -138,7 +155,7 @@ function printHelp() {
   myapi funnel create
   echo '<h1>Hello!</h1>' | myapi funnel push <funnel_id> /`
         : `Quick start:
-  myapi auth setup`;
+  myapi auth setup --help`;
     info(`myapi - MyAPI command-line interface
 
 Usage: myapi <command> [subcommand] [args]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myapihq/cli",
-  "version": "1.0.40",
+  "version": "1.0.47",
   "description": "MyAPI command-line interface",
   "type": "module",
   "main": "dist/index.js",

package/src/commands/auth.ts

@@ -42,7 +42,11 @@ async function patch(path: string, body: unknown, apiKey: string): Promise<unkno
 }
 
 // myapi auth signup — upgrade anonymous session to registered account.
-export async function signup() {
+export async function signup(flags: Record<string, string | boolean> = {}) {
+  if (flags.help) {
+    info('Usage: myapi auth signup\n\nUpgrades an anonymous account to a registered account by linking an email.\nA verification code will be sent — you must enter it interactively.\nIf the email is already in use, adds it as a second account instead.');
+    return;
+  }
   const config = loadConfig();
   if (!config?.api_key) error('Not configured. Run: myapi auth setup');
   if (!config!.is_anonymous) error('Already registered. Use your existing account.');
@@ -74,11 +78,10 @@ export async function signup() {
       default_funnel: string;
     };
 
-    const skillsAns = (await ask(rl, '› Install the MyAPI skills pack? (Y/n) ')).trim();
-    const wantsSkills = yn(skillsAns);
+    const skillsFromFlag = flags['install-skills'] ? true : flags['no-skills'] ? false : null;
+    const wantsSkills = skillsFromFlag !== null ? skillsFromFlag : yn((await ask(rl, '› Install the MyAPI skills pack? (Y/n) ')).trim());
 
     if (upgradeOk) {
-      // Upgrade: update current account in place.
       saveConfig({
         ...config!,
         api_key: data.api_key,
@@ -91,12 +94,10 @@ export async function signup() {
       });
       success(`› Welcome! Account upgraded · ${email}`);
     } else {
-      // Add as new account and switch to it.
       const idx = addAccount({
         api_key: data.api_key,
         account_id: data.account_id,
         email,
-        pin: '',
         default_org: data.default_org,
         default_funnel: data.default_funnel,
         is_anonymous: false,
@@ -113,7 +114,11 @@ export async function signup() {
 }
 
 // myapi auth whoami — show current session info.
-export async function whoami() {
+export async function whoami(flags: Record<string, string | boolean> = {}) {
+  if (flags.help) {
+    info('Usage: myapi auth whoami\n\nDisplays the active account details: email, account ID, default org, default funnel, account type, and current balance.');
+    return;
+  }
   const config = loadConfig();
   if (!config?.api_key) error('Not configured. Run: myapi auth setup');
 
@@ -127,12 +132,16 @@ export async function whoami() {
     const bal = await hq.getBalance(config!.api_key);
     info(`Balance:  ${bal.balance_display}  |  Credits: ${bal.credits_display}`);
   } catch {
-    // Balance fetch is best-effort; don't fail whoami if it errors.
+    info(`Balance:  (unavailable)`);
   }
 }
 
-// myapi auth switch — switch between saved accounts.
-export async function switchCmd() {
+// myapi auth switch [index] — switch between saved accounts.
+export async function switchCmd(flags: Record<string, string | boolean> = {}, indexArg?: string) {
+  if (flags.help) {
+    info('Usage: myapi auth switch [index]\n\nSwitches the active account. Pass an account index to skip the prompt.\n\nExample:\n  myapi auth switch 2');
+    return;
+  }
   const accounts = listAccounts();
   if (accounts.length === 0) error('No accounts configured. Run: myapi auth setup');
   if (accounts.length === 1) {
@@ -147,18 +156,21 @@ export async function switchCmd() {
     info(`  ${a.index + 1}. ${label}${marker}`);
   }
 
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  try {
-    const ans = (await ask(rl, `› Switch to account (1-${accounts.length})? `)).trim();
-    const idx = parseInt(ans, 10) - 1;
-    if (isNaN(idx) || idx < 0 || idx >= accounts.length) {
-      error('Invalid selection.');
-    }
-    if (switchAccount(idx)) {
-      const a = accounts[idx];
-      success(`› Switched to ${a.email ?? a.account_id}`);
+  let idxStr = indexArg ?? '';
+  if (!idxStr) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    try {
+      idxStr = (await ask(rl, `› Switch to account (1-${accounts.length})? `)).trim();
+    } finally {
+      rl.close();
     }
-  } finally {
-    rl.close();
+  }
+  const idx = parseInt(idxStr, 10) - 1;
+  if (isNaN(idx) || idx < 0 || idx >= accounts.length) {
+    error('Invalid selection.');
+  }
+  if (switchAccount(idx)) {
+    const a = accounts[idx];
+    success(`› Switched to ${a.email ?? a.account_id}`);
   }
 }

package/src/commands/billing.ts

@@ -20,7 +20,7 @@ export async function balance(flags: Record<string, string | boolean>) {
 
 export async function history(flags: Record<string, string | boolean>) {
   if (flags.help) {
-    info('Usage: myapi billing history [--json]\n\nShows your recent billing transactions and top-ups.');
+    info('Usage: myapi billing history [--json]\n\nShows your recent billing transactions and top-ups.\n\nFlags:\n  --json   Output raw JSON');
     return;
   }
   const config = requireConfig();
@@ -48,7 +48,7 @@ export async function history(flags: Record<string, string | boolean>) {
 
 export async function topup(amountStr: string, flags: Record<string, string | boolean>) {
   if (flags.help) {
-    info('Usage: myapi billing topup <amount>\n\nAmount is in whole dollars (e.g. "10" charges $10).\nUse --yes to skip confirmation.\nExample: myapi billing topup 10');
+    info('Usage: myapi billing topup <amount>\n\nAmount is in whole dollars (e.g. "10" charges $10).\nUse --yes to skip confirmation.\nExample: myapi billing topup 10\n\nFlags:\n  --yes   Skip confirmation prompt');
     return;
   }
   const amount = Math.round(parseFloat(amountStr));

package/src/commands/domain.ts

@@ -6,7 +6,7 @@ export async function check(domainArg: string, flags: Record<string, string | bo
   const config = requireConfig();
   const orgId = (flags.org as string) || config.default_org;
   const domain = domainArg || (config.default_domain as string);
-  if (!orgId || !domain) error("Missing required arguments.\nUsage: myapi domain check <domain> --org <id>\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+  if (!orgId || !domain) error("Missing required arguments.\nUsage: myapi domain check <domain> --org <id>\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
   const res = await sdkDomain.checkDomain(config.api_key, orgId, domain) as { available: boolean; price_cents: number; price_display?: string; message?: string };
   if (res.available) {
     const price = res.price_display || `$${(res.price_cents / 100).toFixed(2)}`;
@@ -20,7 +20,7 @@ export async function register(domainArg: string, flags: Record<string, string |
   const config = requireConfig();
   const orgId = (flags.org as string) || config.default_org;
   const domain = domainArg || (config.default_domain as string);
-  if (!orgId || !domain) error("Missing required arguments.\nUsage: myapi domain register <domain> --org <id> [--years <num>]\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+  if (!orgId || !domain) error("Missing required arguments.\nUsage: myapi domain register <domain> --org <id> [--years <num>]\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
   const years = parseInt(flags.years as string) || 1;
   const res = await sdkDomain.registerDomain(config.api_key, orgId, domain, years);
   success(`Registered ${domain}!\n${JSON.stringify(res, null, 2)}`);
@@ -30,7 +30,7 @@ export async function importDomain(domainArg: string, flags: Record<string, stri
   const config = requireConfig();
   const orgId = (flags.org as string) || config.default_org;
   const domain = domainArg || (config.default_domain as string);
-  if (!orgId || !domain) error("Missing required arguments.\nUsage: myapi domain import <domain> --org <id> [--namecheap-user <user> --namecheap-key <key>]\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+  if (!orgId || !domain) error("Missing required arguments.\nUsage: myapi domain import <domain> --org <id> [--namecheap-user <user> --namecheap-key <key>]\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
   const payload: { domain: string; namecheap_api_user?: string; namecheap_api_key?: string } = { domain };
   if (flags['namecheap-user']) payload.namecheap_api_user = flags['namecheap-user'] as string;
   if (flags['namecheap-key']) payload.namecheap_api_key = flags['namecheap-key'] as string;
@@ -41,7 +41,7 @@ export async function importDomain(domainArg: string, flags: Record<string, stri
 export async function list(flags: Record<string, string | boolean>) {
   const config = requireConfig();
   const orgId = (flags.org as string) || config.default_org;
-  if (!orgId) error("Missing required arguments.\nUsage: myapi domain list --org <id> [--filter=all|unassigned|org]\n(Or set a default org via: myapi auth config set-org <id>)");
+  if (!orgId) error("Missing required arguments.\nUsage: myapi domain list --org <id> [--filter=all|unassigned|org]\n(Set default: myapi auth config set-org <id>)");
   const filter = flags.filter as 'all' | 'unassigned' | 'org' | undefined;
   const domains = await sdkDomain.listDomains(config.api_key, orgId, filter);
   printTable(domains as unknown as Record<string, unknown>[]);
@@ -52,7 +52,7 @@ export async function assign(domainArg: string, flags: Record<string, string | b
   const orgId = (flags.org as string) || config.default_org;
   const domain = domainArg || (config.default_domain as string);
   const targetOrgId = flags.target as string;
-  if (!orgId || !domain || !targetOrgId) error("Missing required arguments.\nUsage: myapi domain assign <domain> --org <id> --target <target_org_id>\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+  if (!orgId || !domain || !targetOrgId) error("Missing required arguments.\nUsage: myapi domain assign <domain> --org <id> --target <target_org_id>\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
   await sdkDomain.assignDomain(config.api_key, orgId, domain, targetOrgId);
   success(`Assigned ${domain} to org ${targetOrgId}`);
 }
@@ -61,7 +61,7 @@ export async function unassign(domainArg: string, flags: Record<string, string |
   const config = requireConfig();
   const orgId = (flags.org as string) || config.default_org;
   const domain = domainArg || (config.default_domain as string);
-  if (!orgId || !domain) error("Missing required arguments.\nUsage: myapi domain unassign <domain> --org <id>\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+  if (!orgId || !domain) error("Missing required arguments.\nUsage: myapi domain unassign <domain> --org <id>\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
   await sdkDomain.unassignDomain(config.api_key, orgId, domain);
   success(`Unassigned ${domain} from org ${orgId}`);
 }
@@ -70,7 +70,7 @@ export async function status(domainArg: string, flags: Record<string, string | b
   const config = requireConfig();
   const orgId = (flags.org as string) || config.default_org;
   const domain = domainArg || (config.default_domain as string);
-  if (!orgId || !domain) error("Missing required arguments.\nUsage: myapi domain status <domain> --org <id>\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+  if (!orgId || !domain) error("Missing required arguments.\nUsage: myapi domain status <domain> --org <id>\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
   const res = await sdkDomain.getDomainStatus(config.api_key, orgId, domain);
   const display: Record<string, unknown> = {
     domain: res.domain,
@@ -84,7 +84,7 @@ export async function settings(domainArg: string, flags: Record<string, string |
   const config = requireConfig();
   const orgId = (flags.org as string) || config.default_org;
   const domain = domainArg || (config.default_domain as string);
-  if (!orgId || !domain) error("Missing required arguments.\nUsage: myapi domain settings <domain> --org <id>\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+  if (!orgId || !domain) error("Missing required arguments.\nUsage: myapi domain settings <domain> --org <id>\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
   const res = await sdkDomain.getDomainSettings(config.api_key, orgId, domain);
   printJson(res);
 }
@@ -93,7 +93,7 @@ export async function updateSettings(domainArg: string, flags: Record<string, st
   const config = requireConfig();
   const orgId = (flags.org as string) || config.default_org;
   const domain = domainArg || (config.default_domain as string);
-  if (!orgId || !domain) error("Missing required arguments.\nUsage: myapi domain update-settings <domain> --org <id> [--security=...] [--browser-check=...] [--purge-cache]\n(Or set defaults via: myapi auth config set-org <id> / set-domain <domain>)");
+  if (!orgId || !domain) error("Missing required arguments.\nUsage: myapi domain update-settings <domain> --org <id> [--security=...] [--browser-check=...] [--purge-cache]\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
   const payload: any = {};
   if (flags.security) payload.security_level = flags.security as string;
   if (flags['browser-check']) payload.browser_check = flags['browser-check'] as string;
@@ -105,7 +105,7 @@ export async function updateSettings(domainArg: string, flags: Record<string, st
 
 export async function run(subcommand: string | undefined, args: string[], flags: Record<string, string | boolean>) {
   if (!subcommand || (flags.help && !subcommand)) {
-    info('Usage: myapi domain <subcommand>\n\nSubcommands:\n  list             List domains\n  check            Check domain availability\n  register         Register a domain\n  import           Import an existing domain\n  assign           Assign domain to org\n  unassign         Unassign domain from its current org\n  status           Get domain status\n  settings         Get domain settings\n  update-settings  Update domain settings\n\nNote: All domain commands require the --org <id> flag.');
+    info('Usage: myapi domain <subcommand>\n\nSubcommands:\n  list             List domains\n  check            Check domain availability\n  register         Register a domain\n  import           Import an existing domain\n  assign           Assign domain to org\n  unassign         Unassign domain from its current org\n  status           Get domain status\n  settings         Get domain settings\n  update-settings  Update domain settings\n\nTip: Set defaults with "myapi auth config set-org <id>" to skip --org on every command.');
     return;
   }
 

package/src/commands/funnel.ts

@@ -50,7 +50,7 @@ export async function push(id: string, slug: string, flags: Record<string, strin
   if (!orgId || !funnelId) {
     error("Missing required arguments.\nUsage: myapi funnel push [funnel_id] [slug] < index.html\n(Defaults to your configured funnel and slug '/' when omitted)");
   }
-  
+
   const html = await new Promise<string>((resolve, reject) => {
     let data = '';
     process.stdin.setEncoding('utf-8');
@@ -85,17 +85,17 @@ export async function verify(id: string, flags: Record<string, string | boolean>
 
 export async function run(subcommand: string | undefined, args: string[], flags: Record<string, string | boolean>) {
   if (!subcommand || (flags.help && !subcommand)) {
-    info('Usage: myapi funnel <subcommand>\n\nSubcommands:\n  list       List funnels\n  create     Create a funnel\n  get        Get funnel details\n  delete     Delete a funnel\n  push       Push a raw HTML page to a slug\n  verify     Verify links and webhooks\n\nNote: All funnel commands require the --org <id> flag.');
+    info('Usage: myapi funnel <subcommand>\n\nSubcommands:\n  list       List funnels\n  create     Create a funnel\n  get        Get funnel details\n  delete     Delete a funnel\n  push       Push a raw HTML page to a slug\n\nNote: Most funnel commands require the --org <id> flag (or set a default via myapi auth config set-org <id>).');
     return;
   }
-  
+
   if (flags.help) {
-    if (subcommand === 'list') info('Usage: myapi funnel list --org <id>');
-    else if (subcommand === 'create') info('Usage: myapi funnel create --org <id>');
-    else if (subcommand === 'get') info('Usage: myapi funnel get <id> --org <id>');
-    else if (subcommand === 'delete') info('Usage: myapi funnel delete <id> --org <id>');
-    else if (subcommand === 'push') info('Usage: myapi funnel push [funnel_id] [slug] < index.html\n\nPushes HTML from stdin. Uses your default funnel and slug "/" when omitted.');
-    else if (subcommand === 'verify') info('Usage: myapi funnel verify <id> --org <id> [--slug <slug>]\n\nVerifies syntax and structure before pushing.');
+    if (subcommand === 'list') info('Usage: myapi funnel list --org <id>\n\nLists all funnels in the organization.\n\nFlags:\n  --org <id>   Organization ID (or set default via myapi auth config set-org)');
+    else if (subcommand === 'create') info('Usage: myapi funnel create --org <id>\n\nCreates a new funnel in the organization.\n\nFlags:\n  --org <id>   Organization ID (or set default via myapi auth config set-org)');
+    else if (subcommand === 'get') info('Usage: myapi funnel get <id> --org <id>\n\nFetches details of a specific funnel.\n\nFlags:\n  --org <id>   Organization ID (or set default via myapi auth config set-org)');
+    else if (subcommand === 'delete') info('Usage: myapi funnel delete <id> --org <id>\n\nDeletes a funnel permanently.\n\nFlags:\n  --org <id>   Organization ID (or set default via myapi auth config set-org)');
+    else if (subcommand === 'push') info('Usage: myapi funnel push [funnel_id] [slug] < index.html\n\nPushes an HTML page from stdin to a slug path within a funnel.\nUses your configured default funnel and slug "/" when arguments are omitted.\n\nFlags:\n  --org <id>     Organization ID\n  --slug <path>  Target slug path (default: /)');
+    else if (subcommand === 'pull') info('Usage: myapi funnel pull [funnel_id] [slug]\n\nFetches the HTML content of a funnel page.');
     return;
   }
 

package/src/commands/keys.ts

@@ -5,19 +5,20 @@ 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.');
+    info('Usage: myapi auth api-keys create [--name <name>]\n\nCreates a new API key.\n\nFlags:\n  --name <name>   Key name (skips prompt)');
     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();
-  
+  let name = (flags.name as string) || '';
+  if (!name) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    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.');
+    error('Key name cannot be empty. Use --name <name>');
     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!`);
 }

package/src/commands/setup.ts

@@ -179,14 +179,14 @@ export async function importKey(apiKey: string, flags: Record<string, string | b
 
   const wantsSkills = flags['install-skills'] ? true : flags['no-skills'] ? false : true;
 
-  addAccount({ api_key: apiKey, account_id: accountId, pin: '', email, default_org: defaultOrg, default_funnel: defaultFunnel, skills_installed: wantsSkills });
+  addAccount({ api_key: apiKey, account_id: accountId, email, default_org: defaultOrg, default_funnel: defaultFunnel, skills_installed: wantsSkills });
   success(`› ✓ Key imported${email ? ` · ${email}` : ''}`);
   if (wantsSkills) await installSkills();
 }
 
 export async function setup(flags: Record<string, string | boolean> = {}) {
   if (flags.help) {
-    info('Usage: myapi auth setup [--anonymous] [--yes] [--install-skills|--no-skills]\n\nFlags:\n  --anonymous       Skip registration, create anonymous account\n  --yes             Skip confirmation prompts\n  --install-skills  Auto-install skills pack\n  --no-skills       Skip skills installation');
+    info('Usage: myapi auth setup [--anonymous] [--yes] [--install-skills|--no-skills]\n\nConfigures your account and stores your default org and funnel so you don\'t need to pass --org or --funnel on every command.\n\nFlags:\n  --anonymous       Skip registration, create anonymous account\n  --yes             Skip confirmation prompts\n  --install-skills  Auto-install skills pack\n  --no-skills       Skip skills installation');
     return;
   }
 
@@ -238,7 +238,7 @@ export async function setup(flags: Record<string, string | boolean> = {}) {
 
   try {
     const useAnon = flags.anonymous || flags.anon;
-    const createAns = useAnon ? 'n' : await ask(rl, '› Create an account? (Y/n) ');
+    const createAns = useAnon ? 'n' : await ask(rl, '› Register with email? (Y/n, or N to continue anonymously) ');
 
     if (yn(createAns)) {
       const data = await registeredFlow(rl);
@@ -264,7 +264,6 @@ export async function setup(flags: Record<string, string | boolean> = {}) {
     addAccount({
       api_key: apiKey,
       account_id: accountId,
-      pin: '',
       email: email || undefined,
       default_org: defaultOrg,
       default_funnel: defaultFunnel,

package/src/commands/update.ts

@@ -16,21 +16,33 @@ export async function checkForUpdate(currentVersion: string): Promise<void> {
 
     if (latest && isNewer(latest, currentVersion)) {
       info(`\n› New version available (${currentVersion} → ${latest}) — installing…`);
-      execSync('npm install -g @myapihq/cli', { stdio: 'pipe' });
-      const config = loadConfig();
-      if (config?.skills_installed) {
-        await installSkills();
+      try {
+        // Use the npm binary next to the active node so nvm users update the right install.
+        const npmBin = process.execPath.replace(/[/\\]node$/, '/npm');
+        execSync(`"${npmBin}" install -g @myapihq/cli`, { stdio: 'pipe' });
+        const config = loadConfig();
+        if (config?.skills_installed) {
+          await installSkills();
+        }
+        success(`› MyAPI CLI updated to ${latest}. Re-run your command.\n`);
+        process.exit(0);
+      } catch (installErr: any) {
+        const msg = installErr?.stderr?.toString?.() || installErr?.message || String(installErr);
+        info(`› Auto-update failed: ${msg.trim()}`);
+        info(`› Run manually: npm install -g @myapihq/cli`);
       }
-      success(`› MyAPI CLI updated to ${latest}. Re-run your command.\n`);
-      process.exit(0);
     }
   } catch {
-    // Network or install errors are silently ignored.
+    // Network errors are silently ignored.
   }
 }
 
 // myapi update — explicit update, same logic as auto-update.
-export async function update(): Promise<void> {
+export async function update(flags: Record<string, string | boolean> = {}): Promise<void> {
+  if (flags.help) {
+    info('Usage: myapi update\n\nUpdates the MyAPI CLI and skills pack to the latest published version.\nEquivalent to: npm install -g @myapihq/cli');
+    return;
+  }
   info('› Checking for updates…');
   try {
     const res = await fetch(REGISTRY_URL, { signal: AbortSignal.timeout(5000) });
@@ -40,7 +52,8 @@ export async function update(): Promise<void> {
   } catch { /* proceed anyway */ }
 
   try {
-    execSync('npm install -g @myapihq/cli', { stdio: 'inherit' });
+    const npmBin = process.execPath.replace(/[/\\]node$/, '/npm');
+    execSync(`"${npmBin}" install -g @myapihq/cli`, { stdio: 'inherit' });
   } catch {
     process.exit(1);
   }

package/src/config.ts

@@ -5,7 +5,6 @@ import * as os from 'os';
 export interface AccountEntry {
   api_key: string;
   account_id: string;
-  pin: string;
   email?: string;
   default_org?: string;
   default_funnel?: string;
@@ -60,7 +59,7 @@ export function loadConfig(): Config | null {
   const envKey = process.env.MYAPI_API_KEY || process.env.MYAPI_KEY;
   const full = loadFullConfig();
 
-  if (!full && envKey) return { api_key: envKey, account_id: '', pin: '' };
+  if (!full && envKey) return { api_key: envKey, account_id: '' };
   if (!full) return null;
 
   const active = full.accounts[full.active] ?? full.accounts[0];

package/src/index.ts

@@ -47,19 +47,28 @@ async function main() {
   try {
     switch (command) {
       case 'auth':
-        if (!subcommand || flags.help) {
-          info('Usage: myapi auth <subcommand>\n\nSubcommands:\n  setup           Configure your account\n  whoami          Show current account\n  signup          Upgrade anonymous account to registered\n  switch          Switch between accounts\n  config          Manage CLI defaults (org_id, domain…)\n  install-skills  Install the MyAPI skills pack\n  api-keys        Manage API keys');
+        if (!subcommand || (flags.help && !subcommand)) {
+          info('Usage: myapi auth <subcommand>\n\nSubcommands:\n  setup           Configure your account\n  import-key      Import an existing API key non-interactively\n  whoami          Show current account\n  signup          Upgrade anonymous account to registered\n  switch [index]  Switch between accounts\n  config          Manage CLI defaults (org_id, domain…)\n  install-skills  Install the MyAPI skills pack\n  api-keys        Manage API keys');
           break;
         }
-        if (subcommand === 'setup') await setupCmd.setup();
-        else if (subcommand === 'whoami') await authCmd.whoami();
-        else if (subcommand === 'signup') await authCmd.signup();
-        else if (subcommand === 'switch') await authCmd.switchCmd();
+        if (subcommand === 'setup') await setupCmd.setup(flags);
+        else if (subcommand === 'import-key') await setupCmd.importKey(restArgs[0], flags);
+        else if (subcommand === 'whoami') await authCmd.whoami(flags);
+        else if (subcommand === 'signup') await authCmd.signup(flags);
+        else if (subcommand === 'switch') await authCmd.switchCmd(flags, restArgs[0]);
         else if (subcommand === 'install-skills') {
+          if (flags.help) {
+            info('Usage: myapi auth install-skills\n\nInstalls the MyAPI skills pack for Claude, Gemini, and Cursor agents.');
+            break;
+          }
           await setupCmd.installSkills();
           success('› Skills installed.');
         } else if (subcommand === 'config') await configCmd.run(restArgs[0], restArgs.slice(1), flags);
         else if (subcommand === 'api-keys') {
+          if (flags.help && !restArgs[0]) {
+            info('Usage: myapi auth api-keys <subcommand>\n\nSubcommands:\n  list             List all API keys\n  create           Create a new API key\n  revoke <id>      Revoke an API key by ID');
+            break;
+          }
           if (!restArgs[0]) { info('Usage: myapi auth api-keys <list|create|revoke>'); break; }
           if (restArgs[0] === 'create') await keysCmd.createNew(flags);
           else if (restArgs[0] === 'list') await keysCmd.list(flags);
@@ -67,7 +76,7 @@ async function main() {
         } else info('Unknown subcommand. Run: myapi auth --help');
         break;
       case 'update':
-        await updateCmd.update();
+        await updateCmd.update(flags);
         break;
       case 'org':
         if (!subcommand || (flags.help && !subcommand)) {
@@ -98,6 +107,13 @@ async function main() {
       case 'funnel':
         await funnelCmd.run(subcommand, restArgs, flags);
         break;
+      // Convenience aliases
+      case 'setup':
+        await setupCmd.setup(flags);
+        break;
+      case 'config':
+        await configCmd.run(subcommand, restArgs, flags);
+        break;
       default:
         error(`Unknown command: ${command}. Run "myapi" for available commands.`);
     }
@@ -117,7 +133,7 @@ function printHelp() {
   myapi funnel create
   echo '<h1>Hello!</h1>' | myapi funnel push <funnel_id> /`
     : `Quick start:
-  myapi auth setup`;
+  myapi auth setup --help`;
   info(`myapi - MyAPI command-line interface
 
 Usage: myapi <command> [subcommand] [args]

package/thank-you.html

@@ -0,0 +1,56 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Thank You</title>
+    <style>
+        body {
+            font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+            background-color: #f3f4f6;
+            color: #1f2937;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            height: 100vh;
+            margin: 0;
+            text-align: center;
+        }
+        .container {
+            background: white;
+            padding: 3rem;
+            border-radius: 1rem;
+            box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
+            max-width: 400px;
+            width: 90%;
+        }
+        h1 {
+            margin-top: 0;
+            color: #4f46e5;
+            font-size: 2.25rem;
+            margin-bottom: 0.5rem;
+        }
+        p {
+            color: #6b7280;
+            line-height: 1.6;
+            margin-bottom: 0;
+            font-size: 1.125rem;
+        }
+        .icon {
+            width: 64px;
+            height: 64px;
+            color: #10b981;
+            margin-bottom: 1.5rem;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <svg class="icon" fill="none" stroke="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"></path>
+        </svg>
+        <h1>Thank You!</h1>
+        <p>We've received your request and will be in touch shortly.</p>
+    </div>
+</body>
+</html>