Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
feat(cli): add --no-browser flag to link command
Sarah Simionescub003baaf1f48
diff --git a/ts/packages/cli/src/commands/connected-accounts/commands/connected-accounts.link.cmd.ts b/ts/packages/cli/src/commands/connected-accounts/commands/connected-accounts.link.cmd.tsindex 2d7a0d004..361403285 100644--- a/ts/packages/cli/src/commands/connected-accounts/commands/connected-accounts.link.cmd.ts+++ b/ts/packages/cli/src/commands/connected-accounts/commands/connected-accounts.link.cmd.ts@@ -51,6 +51,13 @@ const noWait = Options.boolean('no-wait').pipe(Options.withDescription('Do not wait for authorization; only print link info'));+const noBrowser = Options.boolean('no-browser').pipe(+ Options.withDefault(false),+ Options.withDescription(+ 'Do not open the browser automatically; print the URL to open manually'+ )+);+const alias = Options.text('alias').pipe(Options.withDescription('Alias to assign to the connected account. Required when creating an additional account for the same toolkit/auth config.'@@ -82,7 +89,8 @@ const waitForActiveConnection = (ui: TerminalUI,client: RawComposioClient,connectedAccountId: string,- redirectUrl: string+ redirectUrl: string,+ noBrowser: boolean) =>Effect.gen(function* () {yield* showRedirectUrl(ui, redirectUrl);@@ -98,6 +106,8 @@ const waitForActiveConnection = (if (!urlSchemeValid) {yield* ui.log.warn(`Redirect URL has an unexpected scheme: ${redirectUrl}`);yield* ui.log.info('Open the URL manually if you trust the source.');+ } else if (noBrowser) {+ yield* ui.log.info('Open the URL above in your browser to authorize.');} else {yield* Effect.tryPromise(() => open(redirectUrl, { wait: false })).pipe(Effect.catchAll(error =>@@ -178,7 +188,7 @@ const validateLinkResponse = (});});-const handleNoManagedAuth = (ui: TerminalUI, toolkitSlug: string) =>+const handleNoManagedAuth = (ui: TerminalUI, toolkitSlug: string, noBrowser: boolean) =>Effect.gen(function* () {const userContext = yield* ComposioUserContext;const webURL = userContext.data.webURL.replace(/\/+$/, '');@@ -202,12 +212,14 @@ const handleNoManagedAuth = (ui: TerminalUI, toolkitSlug: string) =>const dashboardUrl = `${webURL}/${encodeURIComponent(orgName)}/~/connect/apps/${encodeURIComponent(toolkitSlug)}?open=true`;yield* ui.log.warn(- `Composio does not manage auth for "${toolkitSlug}" — opening the dashboard to connect manually.`+ `Composio does not manage auth for "${toolkitSlug}" — ${noBrowser ? 'open the dashboard' : 'opening the dashboard'} to connect manually.`);- yield* Effect.tryPromise(() => open(dashboardUrl, { wait: false })).pipe(- Effect.catchAll(() => ui.log.warn('Could not open the browser automatically.'))- );+ if (!noBrowser) {+ yield* Effect.tryPromise(() => open(dashboardUrl, { wait: false })).pipe(+ Effect.catchAll(() => ui.log.warn('Could not open the browser automatically.'))+ );+ }yield* ui.note(dashboardUrl, 'Dashboard URL');yield* ui.output(dashboardUrl);@@ -468,6 +480,7 @@ const handleLegacyAuthConfigLink = (params: {readonly requestedUserId: Option.Option<string>;readonly projectName: Option.Option<string>;readonly noWait: boolean;+ readonly noBrowser: boolean;readonly alias: Option.Option<string>;readonly ui: TerminalUI;readonly clientSingleton: {@@ -593,7 +606,13 @@ const handleLegacyAuthConfigLink = (params: {return;}- yield* waitForActiveConnection(params.ui, client, connectedAccountId, redirectUrl);+ yield* waitForActiveConnection(+ params.ui,+ client,+ connectedAccountId,+ redirectUrl,+ params.noBrowser+ );});const runConnectedAccountsLink = (params: {@@ -602,6 +621,7 @@ const runConnectedAccountsLink = (params: {userId: Option.Option<string>;projectName: Option.Option<string>;noWait: boolean;+ noBrowser: boolean;alias: Option.Option<string>;list: boolean;rootOnly: boolean;@@ -673,6 +693,7 @@ const runConnectedAccountsLink = (params: {requestedUserId: params.userId,projectName: params.projectName,noWait: params.noWait,+ noBrowser: params.noBrowser,alias: aliasOption,ui,clientSingleton,@@ -740,7 +761,7 @@ const runConnectedAccountsLink = (params: {const slug = extractSlug(error);if (slug === 'ToolRouterV2_NoManagedAuth') {- yield* handleNoManagedAuth(ui, toolkitSlug);+ yield* handleNoManagedAuth(ui, toolkitSlug, params.noBrowser);return Option.none();}@@ -802,7 +823,7 @@ const runConnectedAccountsLink = (params: {},}).pipe(Effect.catchAll(() => Effect.void));} else {- yield* waitForActiveConnection(ui, client, connAccountId, redirectUrl);+ yield* waitForActiveConnection(ui, client, connAccountId, redirectUrl, params.noBrowser);yield* appendCliSessionHistory({orgId: resolvedProject.projectType === 'CONSUMER' ? resolvedProject.orgId : undefined,consumerUserId:@@ -820,14 +841,15 @@ const runConnectedAccountsLink = (params: {export const connectedAccountsCmd$Link = Command.make('link',- { toolkit, authConfig, userId, projectName, noWait, alias, list },- ({ toolkit, authConfig, userId, projectName, noWait, alias, list }) =>+ { toolkit, authConfig, userId, projectName, noWait, noBrowser, alias, list },+ ({ toolkit, authConfig, userId, projectName, noWait, noBrowser, alias, list }) =>runConnectedAccountsLink({toolkit,authConfig,userId,projectName,noWait,+ noBrowser,alias,list,rootOnly: false,@@ -852,14 +874,15 @@ export const connectedAccountsCmd$Link = Command.make(export const rootConnectedAccountsCmd$Link = Command.make('link',- { toolkit, noWait, alias, list },- ({ toolkit, noWait, alias, list }) =>+ { toolkit, noWait, noBrowser, alias, list },+ ({ toolkit, noWait, noBrowser, alias, list }) =>runConnectedAccountsLink({toolkit,authConfig: Option.none(),userId: Option.none(),projectName: Option.none(),noWait,+ noBrowser,alias,list,rootOnly: true,diff --git a/ts/packages/cli/src/commands/root-help.ts b/ts/packages/cli/src/commands/root-help.tsindex cbe096477..1adaef915 100644--- a/ts/packages/cli/src/commands/root-help.ts+++ b/ts/packages/cli/src/commands/root-help.ts@@ -528,7 +528,7 @@ const SUBCOMMAND_HELP: Record<string, SubcommandHelp | TaggedValue<SubcommandHel],}),link: {- usage: 'composio link [<toolkit>] [--no-wait] [--alias text] [--list]',+ usage: 'composio link [<toolkit>] [--no-wait] [--no-browser] [--alias text] [--list]',description:'Connect an external account (GitHub, Gmail, Slack, etc.) so tools can act on your behalf. Opens a browser for OAuth authorization and waits for confirmation.',args: [{ name: '<toolkit>', description: 'Toolkit slug to link (e.g. "github", "gmail")' }],@@ -544,6 +544,10 @@ const SUBCOMMAND_HELP: Record<string, SubcommandHelp | TaggedValue<SubcommandHelname: '--no-wait',description: 'Print link info and exit without waiting for authorization',},+ {+ name: '--no-browser',+ description: 'Do not open the browser automatically; print the URL to open manually',+ },{name: '--list',description:diff --git a/ts/packages/cli/test/src/commands/connected-accounts/connected-accounts.link.cmd.test.ts b/ts/packages/cli/test/src/commands/connected-accounts/connected-accounts.link.cmd.test.tsindex 2f95289e1..6f87544d7 100644--- a/ts/packages/cli/test/src/commands/connected-accounts/connected-accounts.link.cmd.test.ts+++ b/ts/packages/cli/test/src/commands/connected-accounts/connected-accounts.link.cmd.test.ts@@ -125,6 +125,29 @@ describe('CLI: composio dev connected-accounts link', () => {);});+ layer(+ TestLive({+ baseConfigProvider: testConfigProvider,+ connectedAccountsData: makeConnectedAccountsData(),+ fixture: 'global-test-user-id',+ })+ )('[Given] --no-browser [Then] waits for ACTIVE without opening the browser', it => {+ it.scoped('prints the URL and waits without calling open', () =>+ Effect.gen(function* () {+ yield* cli(['link', 'gmail', '--no-browser']);+ const lines = yield* MockConsole.getLines({ stripAnsi: true });+ const output = lines.join('\n');+ const parsed = extractJsonObject(output);++ expect(parsed).not.toBeNull();+ expect(parsed?.status).toBe('success');+ expect(parsed?.connected_account_id).toBe('con_test_link');+ expect(output).toContain('https://app.composio.dev/link?token=lt_test_token');+ expect(vi.mocked(open)).not.toHaveBeenCalled();+ })+ );+ });+layer(TestLive({baseConfigProvider: testConfigProvider,