@autumnai/cli 0.1.0 → 0.1.2

package/bin/autumn.mjs

@@ -7,7 +7,7 @@ import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
-const VERSION = "0.1.0";
+const VERSION = "0.1.2";
 const DEFAULT_API_URL = "https://api.autumn.ai";
 const USER_AGENT = `autumn-cli/${VERSION}`;
 const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
@@ -214,8 +214,8 @@ async function request(config, route, options) {
 function parseArgs(tokens) {
   const flags = {};
   const positionals = [];
-  const booleanFlags = new Set(["detach", "force", "json", "no-browser", "wait", "help", "h"]);
-  const valueFlags = new Set(["out", "timeout", "limit", "format"]);
+  const booleanFlags = new Set(["detach", "force", "json", "no-browser", "wait", "help", "h", "yes"]);
+  const valueFlags = new Set(["out", "timeout", "limit", "format", "days", "name", "website", "share-by-default", "owners-can-demote"]);
   for (let index = 0; index < tokens.length; index += 1) {
     const token = tokens[index];
     if (token === "--") {
@@ -264,7 +264,9 @@ Commands:
   status <id> [--json]                Show current task status once
   rows <id> [--out FILE] [--format csv|json]
   stop <id>                            Stop a running task
-  list [--limit N] (default 20)        List recent tasks
+  list [query] [--limit N] [--json]    List or search recent tasks (default limit: 20)
+  team [invite|revoke|role|remove|set] Manage your team (writes are owner-only)
+  usage [--days N] [--json]            Read usage for the last N days (1–90, default: 30)
   setup [claude|codex|all]             Install the Autumn Skill
   mcp-config [claude|codex|cursor]     Print MCP connection configuration
 
@@ -289,7 +291,9 @@ function commandHelp(command) {
     status: "autumn status <id> [--json]",
     rows: "autumn rows <id> [--out FILE] [--format csv|json]",
     stop: "autumn stop <id>",
-    list: "autumn list [--limit N] [--json] (default limit: 20)",
+    list: "autumn list [query] [--limit N] [--json] (default limit: 20)",
+    team: "autumn team [invite <email>|revoke <invitation_id>|role <user_id> owner|member|remove <user_id> --yes|set [--name N] [--website W] [--share-by-default true|false] [--owners-can-demote true|false]]",
+    usage: "autumn usage [--days N] [--json] (1–90, default: 30)",
     setup: "autumn setup [claude|codex|all]",
     "mcp-config": "autumn mcp-config [claude|codex|cursor]",
   };
@@ -300,6 +304,88 @@ function requirePositionals(positionals, count, usage) {
   if (positionals.length < count) throw new CliError(`Usage: ${usage}`);
 }
 
+function teamBoolean(value, option) {
+  if (value !== "true" && value !== "false") {
+    throw new CliError(`--${option} must be true or false.`);
+  }
+  return value === "true";
+}
+
+async function teamCommand(config, positionals, options) {
+  const action = positionals[0] || "";
+  if (!action) {
+    const result = await request(config, "/team");
+    if (jsonMode) emit(result);
+    else {
+      const account = result.account || {};
+      writeOut(`account\t${account.type || ""}\t${account.name || ""}\t${account.role || ""}`);
+      writeOut("user_id\tname\temail\trole");
+      for (const member of result.members || []) {
+        writeOut([member.user_id, member.name, member.email, member.role].map((value) => String(value || "").replace(/[\t\r\n]/g, " ")).join("\t"));
+      }
+      if (account.type === "team" && account.role === "owner") {
+        writeOut("\nPending invitations");
+        writeOut("id\temail\tcreated_at");
+        for (const invitation of result.invitations || []) {
+          writeOut([invitation.id, invitation.email, invitation.created_at].map((value) => String(value || "").replace(/[\t\r\n]/g, " ")).join("\t"));
+        }
+      }
+    }
+    return 0;
+  }
+
+  let result;
+  if (action === "invite") {
+    requirePositionals(positionals, 2, commandHelp("team"));
+    result = await request(config, "/team/invitations", { method: "POST", body: { email: positionals[1] } });
+  } else if (action === "revoke") {
+    requirePositionals(positionals, 2, commandHelp("team"));
+    result = await request(config, `/team/invitations/${encodeURIComponent(positionals[1])}`, { method: "DELETE" });
+  } else if (action === "role") {
+    requirePositionals(positionals, 3, commandHelp("team"));
+    if (!["owner", "member"].includes(positionals[2])) throw new CliError("Role must be owner or member.");
+    result = await request(config, `/team/members/${encodeURIComponent(positionals[1])}`, { method: "PATCH", body: { role: positionals[2] } });
+  } else if (action === "remove") {
+    requirePositionals(positionals, 2, commandHelp("team"));
+    if (!options.yes) throw new CliError(`Rerun with --yes to remove ${positionals[1]}`);
+    result = await request(config, `/team/members/${encodeURIComponent(positionals[1])}`, { method: "DELETE" });
+  } else if (action === "set") {
+    if (positionals.length !== 1) throw new CliError(`Usage: ${commandHelp("team")}`);
+    const body = {};
+    if (options.name !== undefined || options.website !== undefined) {
+      if (options.name !== undefined) body.name = options.name;
+      if (options.website !== undefined) body.website = options.website;
+    }
+    const settings = {};
+    if (options["share-by-default"] !== undefined) settings.share_chats_by_default = teamBoolean(options["share-by-default"], "share-by-default");
+    if (options["owners-can-demote"] !== undefined) settings.owners_can_demote_owners = teamBoolean(options["owners-can-demote"], "owners-can-demote");
+    if (Object.keys(settings).length) {
+      const current = await request(config, "/team");
+      body.settings = settings;
+      body.version = current.settings?.version;
+    }
+    if (!Object.keys(body).length) throw new CliError(`Usage: ${commandHelp("team")}`);
+    result = await request(config, "/team", { method: "PATCH", body });
+  } else {
+    throw new CliError(`Unknown team command: ${action}\n${commandHelp("team")}`);
+  }
+  if (jsonMode) emit(result);
+  else writeOut(action === "invite" ? `Invitation sent to ${positionals[1]}.` : action === "revoke" ? "Invitation revoked." : action === "remove" ? `Removed ${positionals[1]} from the team.` : action === "role" ? `Set ${positionals[1]} to ${positionals[2]}.` : "Team updated.");
+  return 0;
+}
+
+async function usageCommand(config, options) {
+  const days = Number(options.days || 30);
+  if (!Number.isInteger(days) || days < 1 || days > 90) throw new CliError("--days must be an integer from 1 to 90.");
+  const result = await request(config, `/team/usage?days=${days}`);
+  if (jsonMode) emit(result);
+  else {
+    writeOut(`${result.credits_used || 0} credits used across ${result.tasks || 0} tasks in the last ${result.days || days} days.`);
+    for (const member of result.members || []) writeOut(`${member.name || member.user_id}: ${member.credits_used || 0} credits, ${member.tasks || 0} tasks`);
+  }
+  return 0;
+}
+
 function taskRoute(taskId) {
   return `/task/${encodeURIComponent(taskId)}`;
 }
@@ -863,7 +949,10 @@ async function commandMain(command, options, positionals, config) {
     if (!Number.isInteger(limit) || limit < 1 || limit > 200) {
       throw new CliError("--limit must be an integer from 1 to 200.");
     }
-    const result = await request(config, `/task?limit=${limit}`);
+    const query = positionals.join(" ").trim();
+    const params = new URLSearchParams({ limit: String(limit) });
+    if (query) params.set("q", query);
+    const result = await request(config, `/task?${params}`);
     if (jsonMode) emit(result);
     else {
       const tasks = Array.isArray(result) ? result : result.tasks || [];
@@ -872,6 +961,8 @@ async function commandMain(command, options, positionals, config) {
     }
     return 0;
   }
+  if (command === "team") return teamCommand(config, positionals, options);
+  if (command === "usage") return usageCommand(config, options);
   throw new CliError(`Unknown command: ${command}\n\n${globalHelp()}`);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autumnai/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Autumn research agent from your terminal or coding agent",
   "homepage": "https://www.autumn.ai/docs",
   "type": "module",

package/skill.md

@@ -10,6 +10,8 @@ verifies and saves rows with sources, and you read the rows. A task takes minute
 seconds, and a task is a conversation: you can answer its questions and refine it on the
 same `task_id`.
 
+No task_id? Find it with `list_tasks` (MCP), `autumn list "<words>"` (CLI) or `GET /task?q=<words>`.
+
 Don't use Autumn for a quick fact you can answer yourself.
 
 ## Fastest path: the CLI
@@ -46,6 +48,16 @@ working or approval pending, and `4` authentication required.
 - Check it works: `curl -sS https://api.autumn.ai/credits -H "X-API-Key: $AUTUMN_API_KEY"`.
 - To buy credits, use MCP `buy_credits` or `autumn buy 10000` to get a payment link for the user.
 
+## Team and usage
+
+- MCP: `get_team`, `get_usage`, `invite_member`, `revoke_invitation`,
+  `set_member_role`, `update_team`, `remove_member`.
+- CLI: `autumn team`, `autumn team invite|revoke|role|remove|set`, `autumn usage`.
+- REST: `GET /team`, `PATCH /team`, `POST /team/invitations`,
+  `DELETE /team/invitations/{invitation_id}`, `PATCH` / `DELETE /team/members/{user_id}`,
+  and `GET /team/usage?days=30`.
+- Team writes are owner-only. Creating or leaving a team is done in the app.
+
 ## The loop
 
 ```bash