@figs-so/cli 0.1.15 → 0.1.16

package/README.md

@@ -34,9 +34,8 @@ better. Figs is the human-facing layer on top: the one place a whole team can se
 Run these from your agent's repo (or have the agent run them):
 
 ```bash
-npx @figs-so/cli@latest login                    # opens your browser to approve (the agent never sees a token)
-npx @figs-so/cli@latest workspaces               # find your workspace slug
-npx @figs-so/cli@latest init --workspace <slug>  # scaffolds .figs/ (identity + a charter template)
+npx @figs-so/cli@latest login                    # opens your browser — sign up & approve (the agent never sees a token)
+npx @figs-so/cli@latest init                     # scaffolds .figs/ — uses your only workspace (--workspace <slug> to pick)
 # fill in .figs/agent.json — its name, mandate, what it owns (figs doctor flags any placeholders)
 npx @figs-so/cli@latest push                     # publish → it appears in your org chart
 ```
@@ -72,7 +71,7 @@ are shorthand for exactly that (always current, no version drift). Prefer a real
 |---|---|
 | `figs login` / `logout` | device-flow browser approve / remove local token |
 | `figs workspaces [--json]` | list your workspaces (create one in the web app) |
-| `figs init --workspace <slug>` | generate identity + write `.figs/` |
+| `figs init [--workspace <slug>]` | generate identity + write `.figs/` (omit the flag: uses your only workspace, else lists them) |
 | `figs doctor` | validate `.figs/` against the contract before pushing |
 | `figs push` | one-way publish of `.figs/` |
 | `figs status [--json]` | login / workspace / agent state |

package/figs.mjs

@@ -91,7 +91,7 @@ const COMMANDS = {
     desc: "scaffold .figs/ here (identity + charter/contract/guide templates)",
     more: [
       "--workspace takes a slug (resolved to its UUID) or a raw UUID — get it from `figs workspaces`.",
-      "Omit --workspace and (logged in) it lists your workspaces so you can re-run with the right one.",
+      "Omit --workspace and (logged in) it uses your only workspace, or lists them so you can re-run with one.",
       "Never clobbers: an existing agent.json / CONTRACT.md / GUIDE.md / outbox is left exactly as-is.",
     ],
     eg: "figs init --workspace acme-corp",
@@ -361,6 +361,7 @@ async function login(token) {
     if (status === "approved" && r.data.token) {
       saveToken(r.data.token)
       console.log("figs: ✓ authorized — token saved to ~/.figs/credentials.json")
+      console.log("figs: next — run `figs init` to scaffold .figs/ here")
       return
     }
     if (status === "denied") die("authorization denied")
@@ -614,9 +615,10 @@ function findPlaceholders(obj) {
  * Resolve which workspace this `.figs/` belongs to. `--workspace` is optional:
  *  - given a UUID  → use it as-is (no network).
  *  - given a slug  → resolve to its UUID via the API (needs auth).
- *  - omitted       → reuse the one already in config.json (idempotent re-init),
- *                    else list the user's workspaces and have them re-run with one
- *                    (the agent drives the choice — we never silently pick).
+ *  - omitted       → reuse the one already in config.json (idempotent re-init);
+ *                    else use the user's only workspace (logged, so it's visible);
+ *                    else list them and have the agent re-run with one (when
+ *                    there's a real choice, the agent drives it — we never guess).
  * Returns the workspace UUID, or exits with an actionable message.
  */
 async function resolveWorkspaceId(workspaceArg, endpoint) {
@@ -639,7 +641,7 @@ async function resolveWorkspaceId(workspaceArg, endpoint) {
   const existing = readJson(join(repoDir, "config.json"), null)
   if (existing?.workspaceId) return existing.workspaceId
 
-  // First-time init with no workspace named — list them so the agent can re-run.
+  // First-time init with no workspace named — use the only one, else list them.
   if (!getToken()) {
     die("which workspace? run `figs login` first so I can list them, then `figs init --workspace <slug>` (or pass a workspace UUID directly)")
   }
@@ -649,6 +651,10 @@ async function resolveWorkspaceId(workspaceArg, endpoint) {
   if (list.length === 0) {
     die(`no workspaces yet — create one at ${endpoint}, then re-run \`figs init --workspace <slug>\``)
   }
+  if (list.length === 1) {
+    console.log(`figs: using workspace ${list[0].slug} (${list[0].name})`)
+    return list[0].id
+  }
   console.log("figs: which workspace? re-run init with one of these:")
   for (const w of list) console.log(`        figs init --workspace ${w.slug}   (${w.name})`)
   process.exit(1)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@figs-so/cli",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "Figs CLI — publish your AI agent's state to Figs (figs.so). Run by the agent.",
   "type": "module",
   "bin": {