@stainlu/faam-cli 0.2.4 → 0.2.5

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.5 (2026-02-10)
+
+- `faam init` now works with zero arguments — name auto-generates, description optional
+- API no longer requires description for agent profile
+
 ## 0.2.4 (2026-02-10)
 
 - Fix CI workflow (pin pnpm version)

package/README.md

@@ -64,24 +64,27 @@ faam logout
 
 ### `faam init`
 
-Initialize your agent card with name, description, auto-discover skills, and sync to API.
+Initialize your agent card, auto-discover skills, and sync to API. Works with zero arguments — name auto-generates from your account ID and description is optional.
 
 ```bash
-# Interactive mode (prompts for values)
+# Zero-config (auto-generates name, no description)
 faam init
 
-# Non-interactive mode (for AI agents)
+# With custom name
+faam init --name "My AI Agent"
+
+# With name and description
 faam init --name "My AI Agent" --description "What my agent does"
 ```
 
 Options:
-- `-n, --name <name>` - Agent name
-- `-d, --description <desc>` - Agent description
+- `-n, --name <name>` - Agent name (default: `agent-<account_id>`)
+- `-d, --description <desc>` - Agent description (optional)
 - `-o, --organization <org>` - Provider organization (optional)
 - `-f, --force` - Overwrite existing config file
 
 **Features:**
-- **Interactive mode**: If name/description not provided, prompts for values
+- **Zero-config**: Run `faam init` with no arguments — name auto-generates, description is optional
 - **Auto-discovery**: Finds skills from `~/.claude/skills/`, `.claude/skills/`, etc.
 - **Auto-sync**: Immediately syncs to API when logged in
 

package/dist/index.cjs

@@ -22215,7 +22215,7 @@ var import_prompts = __toESM(require_prompts3(), 1);
 async function initCommand(options2) {
   const configPath = getAgentCardConfigPath();
   if (agentCardConfigExists() && !options2.force) {
-    if (!process.stdin.isTTY || options2.name && options2.description) {
+    if (!process.stdin.isTTY || options2.name) {
       console.log(source_default.yellow("agent-card.json already exists at:"));
       console.log(source_default.gray(configPath));
       console.log();
@@ -22233,23 +22233,23 @@ async function initCommand(options2) {
       return;
     }
   }
-  const isInteractive2 = !(options2.name && options2.description) && process.stdin.isTTY;
+  const clientConfig = isLoggedIn() ? readConfig() : null;
+  const defaultName = clientConfig?.account_id ? `agent-${clientConfig.account_id}` : "My AI Agent";
+  const isInteractive2 = process.stdin.isTTY && !options2.name;
   let config;
   if (isInteractive2) {
     const response = await (0, import_prompts.default)([
       {
         type: "text",
         name: "name",
-        message: "Agent name",
-        initial: options2.name || "",
-        validate: (v) => v.length > 0 || "Name is required"
+        message: "Agent name (press Enter for default)",
+        initial: options2.name || defaultName
       },
       {
         type: "text",
         name: "description",
-        message: "Description",
-        initial: options2.description || "",
-        validate: (v) => v.length > 0 || "Description is required"
+        message: "Description (optional)",
+        initial: options2.description || ""
       },
       {
         type: "text",
@@ -22263,12 +22263,9 @@ async function initCommand(options2) {
         process.exit(0);
       }
     });
-    if (!response.name || !response.description) {
-      return;
-    }
     config = {
-      name: response.name,
-      description: response.description,
+      name: response.name || defaultName,
+      description: response.description || "",
       version: "1.0.0",
       provider: {
         organization: response.organization || "",
@@ -22285,16 +22282,9 @@ async function initCommand(options2) {
       is_public: true
     };
   } else {
-    if (!options2.name || !options2.description) {
-      console.log(source_default.red("Error: --name and --description are required in non-interactive mode."));
-      console.log();
-      console.log("Usage:");
-      console.log(source_default.cyan('  faam init --name "My Agent" --description "What my agent does"'));
-      process.exit(1);
-    }
     config = {
-      name: options2.name,
-      description: options2.description,
+      name: options2.name || defaultName,
+      description: options2.description || "",
       version: "1.0.0",
       provider: {
         organization: options2.organization || "",
@@ -22347,8 +22337,8 @@ async function initCommand(options2) {
   console.log();
   const syncSpinner = ora("Syncing to Faam...").start();
   try {
-    const clientConfig = readConfig();
-    const client = new RlpApiClient(clientConfig);
+    const syncConfig = clientConfig || readConfig();
+    const client = new RlpApiClient(syncConfig);
     const result = await syncToApi(client, config, fileSkills);
     syncSpinner.succeed("Synced successfully");
     if (result.created.length > 0) {
@@ -22365,7 +22355,7 @@ async function initCommand(options2) {
     }
     console.log();
     console.log("Your agent card is live at:");
-    console.log(source_default.cyan(`https://agent-${clientConfig.account_id}.faam.io/.well-known/agent-card.json`));
+    console.log(source_default.cyan(`https://agent-${syncConfig.account_id}.faam.io/.well-known/agent-card.json`));
     console.log();
     console.log("Go back to the onboarding page and click", source_default.bold('"Verify Setup"'), "to continue.");
   } catch (err) {
@@ -22487,7 +22477,7 @@ function configListKeysCommand() {
 
 // src/index.ts
 var program2 = new Command();
-program2.name("faam").description("CLI tool to sync local skills to your FAAM Agent Card").version("0.2.4");
+program2.name("faam").description("CLI tool to sync local skills to your FAAM Agent Card").version("0.2.5");
 program2.command("login").description("Store your FAAM account key").requiredOption("-k, --key <account_key>", "Your FAAM account key").option("--api-url <url>", "API URL (default: https://api.faam.io)").action(async (options2) => {
   await loginCommand({
     key: options2.key,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stainlu/faam-cli",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "CLI tool to sync local skills to your FAAM Agent Card",
   "type": "module",
   "bin": {