feat(cli): make integrations and connections public

Merged
KI
2d ago
+60-2

What

Makes the integrations and connections CLI groups public, and documents them in the CLI reference.

superset:environment step 0 tells an agent to run superset integrations github status|connect and superset connections github status|connect. Both groups were audience: "internal", so for a customer, with SUPERSET_CLI_AUDIENCE unset and outside a sandbox, they failed with Unknown command. environments is already public, and these are its setup steps.

Now public:

  • integrations github status|connect|disconnect: the organization's GitHub App
  • connections github status|connect|disconnect: your GitHub account for cloud workspaces
  • connections agents list|set|remove: agent sign-ins for cloud workspaces

Verified

  • Without SUPERSET_CLI_AUDIENCE, superset --help lists both groups and every subcommand's help resolves.
  • Against production: integrations github status (installed on superset-sh, 33 repositories), connections github status (connected), connections agents list (claude subscription). integrations github connect and connections github connect return "Already installed/connected" without changes.
  • The install URL route exists (apps/api/src/app/api/github/install/route.ts); without a browser session it returns 401, as the command's instructions expect.
  • --no-wait parses as noWait (the parser only negates when a --wait flag exists).
  • bun test (packages/cli): 474 pass, 0 fail. bun run typecheck, bun run lint:fix: clean.

Not run: the full browser install/authorize flows, disconnect, and connections agents set/remove, since they would change the organization's GitHub App or my credentials.

Summary by cubic

Makes the integrations and connections CLI groups public so customers can run the superset:environment setup steps, and documents them in the CLI reference.

Both groups were audience: "internal", so outside a sandbox they failed with Unknown command; environments was already public. Now public:

  • integrations github status|connect|disconnect: the organization's GitHub App
  • connections github status|connect|disconnect: your GitHub account for cloud workspaces
  • connections agents list|set|remove: agent sign-ins for cloud workspaces

connections agents set now requires --kind; set codex --kind subscription reads nothing and starts a ChatGPT device-code sign-in.

Summary by CodeRabbit

  • Documentation
    • Expanded the CLI reference with instructions for organization-wide GitHub integrations, personal GitHub connections, and agent credential setup.
    • Documented how to check GitHub connection status, disconnect, and manage agent connections.
    • Clarified connection setup options, including waiting behavior, subscription or API-key credentials, optional gateway or base URL settings, and Codex device-code sign-in.