@fragment-dev/cli 2026.6.29 → 2026.6.30-1

package/oclif.manifest.json

@@ -79,9 +79,33 @@
       "description": "Authentication is scoped to one FRAGMENT Workspace.\n  If you want to authenticate with another Workspace, you must create another API Client and follow the authentication flow again.\n  Credentials will be written to ~/.fragment/auth.json.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --browser --workspace <workspace-id>",
         "<%= config.bin %> <%= command.id %> --client-id <client-id> --client-secret <client-secret> --api-url <api-url> --oauth-url <oauth-url>"
       ],
       "flags": {
+        "browser": {
+          "description": "Authenticate in the browser and provision an API client automatically.",
+          "name": "browser",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "workspace": {
+          "description": "The Workspace id to authenticate against (required with --browser).",
+          "name": "workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "mcp-url": {
+          "description": "The Workspace MCP server origin (ex: https://mcp.us-west-2.fragment.dev). Used with --browser.",
+          "name": "mcp-url",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "client-id": {
           "description": "The API Client ID for your FRAGMENT Workspace.",
           "name": "client-id",
@@ -164,6 +188,82 @@
       "summary": "Get a FRAGMENT Authentication Token.",
       "help": "Create an API client at dashboard.fragment.dev/api-clients"
     },
+    "api-client:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Authenticates in the browser and provisions a new API client for the\n  given Workspace, then writes the credentials to a file or stdout. The\n  authorizing user must have permission to create API clients.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --workspace <workspace-id> --name \"Billing service\" --role reader",
+        "<%= config.bin %> <%= command.id %> --workspace <workspace-id> --name CI --output ./fragment-client.json"
+      ],
+      "flags": {
+        "workspace": {
+          "description": "The Workspace id to create the API client in.",
+          "name": "workspace",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "A display name for the API client.",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "role": {
+          "description": "Role to assign the API client (defaults to your own role, capped at it).",
+          "name": "role",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "admin",
+            "reader"
+          ],
+          "type": "option"
+        },
+        "mcp-url": {
+          "description": "The Workspace MCP server origin (ex: https://mcp.us-west-2.fragment.dev). Falls back to FRAGMENT_MCP_URL.",
+          "name": "mcp-url",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output": {
+          "description": "Write the credentials to this file instead of stdout.",
+          "name": "output",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format (applies to both stdout and --output).",
+          "name": "format",
+          "required": false,
+          "default": "json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "env"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "api-client:create",
+      "pluginAlias": "@fragment-dev/cli",
+      "pluginName": "@fragment-dev/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Create an API client for an integration."
+    },
     "workspace": {
       "aliases": [],
       "args": {},
@@ -980,5 +1080,5 @@
       "help": "Generate GraphQL queries from your Schema for your SDK."
     }
   },
-  "version": "2026.6.29"
+  "version": "2026.6.30-1"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragment-dev/cli",
-  "version": "2026.6.29",
+  "version": "2026.6.30-1",
   "description": "FRAGMENT CLI",
   "author": "hello@fragment.dev",
   "bin": {
@@ -66,6 +66,9 @@
     "topics": {
       "query": {
         "description": "Query for entities (Ledgers, Schemas, etc) in your Workspace."
+      },
+      "api-client": {
+        "description": "Manage API clients for your Workspace."
       }
     },
     "plugins": [