@clawcard/cli 2.1.3 → 2.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawcard/cli",
-  "version": "2.1.3",
+  "version": "2.1.6",
   "description": "The ClawCard CLI — manage your agent keys, billing, and setup from the terminal",
   "bin": {
     "clawcard": "./bin/clawcard.mjs"

package/skill/SKILL.md

@@ -107,11 +107,22 @@ View activity log:
 clawcard agent activity --json [--limit 50]
 ```
 
+## Billing Address
+
+Get the user's billing address for checkout forms:
+```
+clawcard agent billing-address --json
+```
+
+Returns: name, line1, line2, city, state, zip, country.
+Use these values to fill billing/address fields on checkout pages.
+
 ## Paying on Checkout Pages
 
 When you reach a payment form:
-1. Fill all non-payment fields yourself (name, email, address)
-2. Create a card if needed:
+1. Get billing info: `clawcard agent billing-address --json`
+2. Fill all non-payment fields yourself (name, email, address, zip) using the billing address
+3. Create a card if needed:
    ```
    clawcard agent cards create --amount <cents> --type single_use --memo "desc" --json
    ```

package/src/commands/agent.js

@@ -237,6 +237,31 @@ export async function agentActivityCmd(options) {
   console.log();
 }
 
+// ── Billing Address ──
+export async function agentBillingAddressCmd(options) {
+  const { getBillingAddress } = await import("../config.js");
+  const address = getBillingAddress();
+
+  if (!address) {
+    const err = "No billing address set. Run: clawcard settings";
+    if (options.json) return output({ success: false, error: err }, true);
+    console.log(`  ${err}`);
+    return;
+  }
+
+  if (options.json) return output(address, true);
+
+  console.log();
+  console.log(`  Name:     ${address.name}`);
+  console.log(`  Address:  ${address.line1}`);
+  if (address.line2) console.log(`            ${address.line2}`);
+  console.log(`  City:     ${address.city}`);
+  console.log(`  State:    ${address.state}`);
+  console.log(`  ZIP:      ${address.zip}`);
+  console.log(`  Country:  ${address.country}`);
+  console.log();
+}
+
 // ── Pay (fill payment form via browser extension) ──
 export async function agentPayCmd(options) {
   const http = await import("http");

package/src/commands/billing.js

@@ -73,9 +73,7 @@ export async function billingTopupCommand() {
     options: [
       { value: 500, label: "$5.00", hint: "you pay $5.50" },
       { value: 1000, label: "$10.00", hint: "you pay $11.00" },
-      { value: 2500, label: "$25.00", hint: "you pay $27.50" },
-      { value: 5000, label: "$50.00", hint: "you pay $55.00" },
-      { value: 10000, label: "$100.00", hint: "you pay $110.00" },
+      { value: 2000, label: "$20.00", hint: "you pay $22.00" },
     ],
   });
 

package/src/commands/settings.js

@@ -0,0 +1,110 @@
+import * as p from "@clack/prompts";
+import chalk from "chalk";
+import { requireAuth } from "../auth-guard.js";
+import { getBillingAddress, saveBillingAddress } from "../config.js";
+
+const orange = chalk.hex("#FF6B35");
+
+export async function settingsCommand() {
+  requireAuth();
+
+  const existing = getBillingAddress();
+
+  if (existing) {
+    p.note(
+      [
+        `Name:     ${existing.name}`,
+        `Address:  ${existing.line1}`,
+        existing.line2 && `          ${existing.line2}`,
+        `City:     ${existing.city}`,
+        `State:    ${existing.state}`,
+        `ZIP:      ${existing.zip}`,
+        `Country:  ${existing.country}`,
+      ]
+        .filter(Boolean)
+        .join("\n"),
+      "Billing Address"
+    );
+
+    const update = await p.confirm({
+      message: "Update billing address?",
+    });
+    if (p.isCancel(update) || !update) return;
+  }
+
+  const name = await p.text({
+    message: "Cardholder name",
+    placeholder: "Jane Smith",
+    initialValue: existing?.name || "",
+    validate: (v) => {
+      if (!v?.trim()) return "Name is required";
+    },
+  });
+  if (p.isCancel(name)) return;
+
+  const line1 = await p.text({
+    message: "Address line 1",
+    placeholder: "123 Main St",
+    initialValue: existing?.line1 || "",
+    validate: (v) => {
+      if (!v?.trim()) return "Address is required";
+    },
+  });
+  if (p.isCancel(line1)) return;
+
+  const line2 = await p.text({
+    message: "Address line 2 (optional)",
+    placeholder: "Apt 4B",
+    initialValue: existing?.line2 || "",
+  });
+  if (p.isCancel(line2)) return;
+
+  const city = await p.text({
+    message: "City",
+    placeholder: "San Francisco",
+    initialValue: existing?.city || "",
+    validate: (v) => {
+      if (!v?.trim()) return "City is required";
+    },
+  });
+  if (p.isCancel(city)) return;
+
+  const state = await p.text({
+    message: "State",
+    placeholder: "CA",
+    initialValue: existing?.state || "",
+    validate: (v) => {
+      if (!v?.trim()) return "State is required";
+    },
+  });
+  if (p.isCancel(state)) return;
+
+  const zip = await p.text({
+    message: "ZIP code",
+    placeholder: "94105",
+    initialValue: existing?.zip || "",
+    validate: (v) => {
+      if (!v?.trim()) return "ZIP is required";
+    },
+  });
+  if (p.isCancel(zip)) return;
+
+  const country = await p.text({
+    message: "Country",
+    placeholder: "US",
+    initialValue: existing?.country || "US",
+  });
+  if (p.isCancel(country)) return;
+
+  saveBillingAddress({
+    name,
+    line1,
+    line2: line2 || "",
+    city,
+    state,
+    zip,
+    country: country || "US",
+  });
+
+  p.log.success("Billing address saved");
+}

package/src/config.js

@@ -66,3 +66,15 @@ export function getSavedKey(agentId) {
   const keys = getSavedKeys();
   return keys[agentId]?.apiKey ?? null;
 }
+
+// ── Billing address ──
+export function getBillingAddress() {
+  const config = getConfig();
+  return config?.billingAddress ?? null;
+}
+
+export function saveBillingAddress(address) {
+  const config = getConfig() || {};
+  config.billingAddress = address;
+  saveConfig(config);
+}

package/src/index.js

@@ -268,6 +268,25 @@ agent
     await agentPayCmd(options);
   });
 
+// Agent billing address
+agent
+  .command("billing-address")
+  .description("Get billing address for checkout forms")
+  .option("--json", "Output as JSON")
+  .action(async (options) => {
+    const { agentBillingAddressCmd } = await import("./commands/agent.js");
+    await agentBillingAddressCmd(options);
+  });
+
+// Settings
+program
+  .command("settings")
+  .description("Manage billing address and preferences")
+  .action(async () => {
+    const { settingsCommand } = await import("./commands/settings.js");
+    await settingsCommand();
+  });
+
 // Setup
 program
   .command("setup")
@@ -407,6 +426,7 @@ if (process.argv.length <= 2) {
           : []),
       { value: "topup", label: "Top up my account", hint: "add balance (10% fee)" },
       { value: "referral", label: "Referral", hint: "share & earn $5" },
+      { value: "settings", label: "Settings", hint: "billing address & preferences" },
       { value: "whoami", label: "Who am I?", hint: "show current account" },
       { value: "dashboard", label: "Open dashboard", hint: "open in browser" },
       { value: "logout", label: "Logout", hint: "clear session" },
@@ -433,6 +453,7 @@ if (process.argv.length <= 2) {
     "agent-fund": () => import("./commands/keys.js").then((m) => m.agentFundCommand()),
     "keys-create": () => import("./commands/keys.js").then((m) => m.keysCreateCommand()),
     "topup": () => import("./commands/billing.js").then((m) => m.billingTopupCommand()),
+    "settings": () => import("./commands/settings.js").then((m) => m.settingsCommand()),
     "dashboard": async () => { const { default: open } = await import("open"); await open("https://www.clawcard.sh/dashboard"); },
     keys: () => import("./commands/keys.js").then((m) => m.keysCommand()),
     setup: () => import("./commands/setup.js").then((m) => m.setupCommand()),