49
description:
50
'Execute a tool. Validates inputs and connections automatically; use it aggressively.',
51
usage:
52
- 'execute <slug> [-d, --data text] [--file path] [--dry-run] [--get-schema] | execute -p <slug> -d <text> <slug> -d <text> ...',
52
+ 'execute <slug> [-d, --data text] [--account selector] [--file path] [--dry-run] [--get-schema] | execute -p <slug> -d <text> <slug> -d <text> ...',
53
options: [
54
{ name: '<slug>', description: 'Tool slug (e.g. "GITHUB_CREATE_ISSUE")' },
55
{
61
name: '-p, --parallel',
62
description: 'Execute repeated <slug> -d <text> pairs concurrently',
63
},
64
+ {
65
+ name: '--account',
66
+ description: 'Select a connected account by alias, word_id, or account ID',
67
+ },
68
{
69
name: '--file',
70
description: 'Inject a local file path into the single file_uploadable input',
76
simple({
77
name: 'link',
78
description: 'Connect your account for a toolkit/app.',
75
- usage: 'link [<toolkit>]',
76
- options: [{ name: '<toolkit>', description: 'Toolkit slug to link (e.g. "github", "gmail")' }],
79
+ usage: 'link [<toolkit>] [--alias text]',
80
+ options: [
81
+ { name: '<toolkit>', description: 'Toolkit slug to link (e.g. "github", "gmail")' },
82
+ { name: '--alias', description: 'Alias for this connected account' },
83
+ ],
84
}),
85
tagged({
86
name: 'run',
98
description:
99
'Create a temporary subscription for consumer-project events and persist each payload into the session artifact folder.',
100
usage:
94
- 'listen <slug> [-p, --params text] [--max-events integer] [--timeout text] [--stream [text]]',
101
+ 'listen <slug> [-p, --params text] [--account selector] [--max-events integer] [--timeout text] [--stream [text]]',
102
options: [
103
{ name: '<slug>', description: 'Trigger slug (e.g. "GMAIL_NEW_GMAIL_MESSAGE")' },
104
{
106
description:
107
"Trigger create params as JSON or JS-style object, e.g. -p '{ trigger_config: { ... } }'.",
108
},
109
+ {
110
+ name: '--account',
111
+ description: 'Select a connected account by alias, word_id, or account ID',
112
+ },
113
{
114
name: '--max-events',
115
description: 'Stop after receiving N events, then disable the temporary trigger',
130
name: 'proxy',
131
description:
132
'curl-like access to any toolkit API through Composio using your connected account.',
122
- usage: 'proxy <url> --toolkit text [-X method] [-H header]... [-d data]',
133
+ usage: 'proxy <url> --toolkit text [--account selector] [-X method] [-H header]... [-d data]',
134
options: [
135
{ name: '<url>', description: 'Full API endpoint URL' },
136
{ name: '--toolkit', description: 'Toolkit slug whose connected account should be used' },
137
+ { name: '--account', description: 'Connected account alias, word_id, or account ID' },
138
{ name: '-X, --method', description: 'HTTP method (GET, POST, PUT, DELETE, PATCH)' },
139
{ name: '-H, --header', description: 'Header in "Name: value" format. Repeat for multiple.' },
140
{ name: '-d, --data', description: 'Request body as raw text, JSON, @file, or - for stdin' },
433
},
434
execute: {
435
usage:
424
- 'composio execute <slug> [-d, --data text] [--file path] [--dry-run] [--get-schema] [--parallel]',
436
+ 'composio execute <slug> [-d, --data text] [--account selector] [--file path] [--dry-run] [--get-schema] [--parallel]',
437
description:
438
'Execute a tool by slug. Validates inputs against cached schemas and checks connections automatically — just try it and it will tell you what to fix.',
439
args: [
453
name: '-p, --parallel',
454
description: 'Execute repeated TOOL_SLUG -d <text> groups concurrently',
455
},
456
+ {
457
+ name: '--account <selector>',
458
+ description: 'Select a connected account by alias, word_id, or connected account ID',
459
+ },
460
{
461
name: '--file <path>',
462
description: 'Inject a local file path into the single file_uploadable input',
482
'# Send an email',
483
`composio execute GMAIL_SEND_EMAIL -d '{ recipient_email: "a@b.com", subject: "Hello", body: "World" }'`,
484
'',
469
- '# Create a GitHub issue',
470
- `composio execute GITHUB_CREATE_ISSUE -d '{ owner: "acme", repo: "app", title: "Bug report", body: "Steps to reproduce..." }'`,
485
+ '# Create a GitHub issue with a named account',
486
+ `composio execute GITHUB_CREATE_ISSUE --account work -d '{ owner: "acme", repo: "app", title: "Bug report", body: "Steps to reproduce..." }'`,
487
'',
488
'# Preview what a tool call would send without executing',
489
`composio execute SLACK_SEND_A_MESSAGE_TO_A_SLACK_CHANNEL --dry-run -d '{ channel: "general", text: "Hello team" }'`,
506
},
507
listen: experimental(CLI_EXPERIMENTAL_FEATURES.LISTEN, {
508
usage:
493
- 'composio listen <slug> [-p, --params text] [--max-events integer] [--timeout text] [--stream [text]]',
509
+ 'composio listen <slug> [-p, --params text] [--account selector] [--max-events integer] [--timeout text] [--stream [text]]',
510
description:
511
'Create a temporary subscription for consumer-project events so background agents can easily consume new emails, Slack messages, and other trigger payloads from artifacts.',
512
args: [{ name: '<slug>', description: 'Trigger slug to create and listen to' }],
516
description:
517
'Trigger create params as JSON/JS object, @file, or - for stdin. Pass optional trigger config fields only.',
518
},
519
+ {
520
+ name: '--account <selector>',
521
+ description: 'Select a connected account by alias, word_id, or connected account ID',
522
+ },
523
{
524
name: '--max-events <integer>',
525
description: 'Stop after N events for this temporary trigger and disable it',
537
examples: [
538
'composio listen GMAIL_NEW_GMAIL_MESSAGE',
539
'composio listen GMAIL_NEW_GMAIL_MESSAGE -p @trigger.json --max-events 5',
520
- 'composio listen GMAIL_NEW_GMAIL_MESSAGE --timeout 5m',
540
+ 'composio listen GMAIL_NEW_GMAIL_MESSAGE --account work --timeout 5m',
541
"composio listen GMAIL_NEW_GMAIL_MESSAGE --timeout 1hr --stream '.data.threadId'",
542
'composio listen SLACK_RECEIVE_MESSAGE -p \'{ trigger_config: { channel: "C123" } }\'',
543
'composio listen GMAIL_NEW_GMAIL_MESSAGE -p @trigger.json --stream',
558
{
559
name: '--alias <text>',
560
description:
541
- 'Alias for the connected account. Required when creating an additional account for the same toolkit (requires multi_account experimental feature)',
561
+ 'Alias for the connected account. Required when creating an additional account for the same toolkit',
562
},
563
],
564
flags: [
583
],
584
seeAlso: [
585
'composio search "<query>" Find tools to use after linking',
566
- "composio execute <slug> -d '{ ... }' Execute a tool with your connected account",
567
- 'composio config experimental Manage experimental features',
586
+ "composio execute <slug> --account <alias> -d '{ ... }' Use a named account",
587
+ 'composio connections list --toolkit <toolkit> List account selectors',
588
],
589
},
590
'connections list': {
820
],
821
},
822
proxy: {
803
- usage: 'composio proxy <url> --toolkit <text> [-X method] [-H header]... [-d data]',
823
+ usage:
824
+ 'composio proxy <url> --toolkit <text> [--account <selector>] [-X method] [-H header]... [-d data]',
825
description:
826
'curl-like access to any toolkit API through Composio using your connected account. Composio handles authentication — just provide the full URL and toolkit.',
827
args: [{ name: '<url>', description: 'Full API endpoint URL' }],
830
name: '-t, --toolkit <text>',
831
description: 'Toolkit slug whose connected account should be used',
832
},
833
+ {
834
+ name: '--account <selector>',
835
+ description: 'Select a connected account by alias, word_id, or connected account ID',
836
+ },
837
{ name: '-X, --method <text>', description: 'HTTP method (GET, POST, PUT, DELETE, PATCH)' },
838
{
839
name: '-H, --header <text>',
846
],
847
flags: [{ name: '--skip-connection-check', description: 'Skip the connected-account check' }],
848
examples: [
824
- 'composio proxy https://gmail.googleapis.com/gmail/v1/users/me/profile --toolkit gmail',
849
+ 'composio proxy https://gmail.googleapis.com/gmail/v1/users/me/profile --toolkit gmail --account work',
850
`composio proxy https://gmail.googleapis.com/gmail/v1/users/me/drafts --toolkit gmail \\`,
851
` -X POST -H 'content-type: application/json' -d '{"message":{"raw":"..."}}'`,
852
],
1284
usage: 'composio config experimental [<feature>] [on|off]',
1285
description: 'View or toggle experimental feature flags.',
1286
args: [
1262
- { name: '<feature>', description: 'Feature name (e.g., listen, local_tools, multi_account)' },
1287
+ { name: '<feature>', description: 'Feature name (e.g., listen, local_tools)' },
1288
{ name: 'on|off', description: 'Enable or disable the feature' },
1289
],
1290
examples: [
1291
'composio config experimental # List all features',
1292
'composio config experimental listen # Show current state',
1293
'composio config experimental local_tools on # Enable local toolkits',
1269
- 'composio config experimental multi_account on # Enable multi_account',
1294
],
1295
},
1296
'dev logs triggers': {