87
const DEVELOPER_COMMANDS: ReadonlyArray<CompactCommand> = [
88
{
89
name: 'dev',
90
- description: 'Developer workflows: init, playground execution, triggers, and logs.',
90
+ description:
91
+ 'Developer workflows and management: init, execute, logs, orgs, projects, toolkits, accounts, and triggers.',
92
},
93
{
94
name: 'generate',
95
description: 'Generate type stubs for toolkits, tools, and triggers (TypeScript | Python).',
96
},
96
- {
97
- name: 'manage',
98
- description: 'Manage orgs, toolkits, connected accounts, triggers, auth configs, and projects.',
99
- },
97
];
98
99
// ── Account commands ───────────────────────────────────────────────────
511
{ name: '-y, --yes', description: 'Auto-select the default org project' },
512
],
513
},
517
- 'dev execute': {
514
+ 'dev playground-execute': {
515
usage:
519
- 'composio dev execute <slug> [-d, --data text] [--user-id text] [--project-name text] [--dry-run] [--get-schema]',
516
+ 'composio dev playground-execute <slug> [-d, --data text] [--user-id text] [--project-name text] [--dry-run] [--get-schema]',
517
description:
521
- 'Execute a tool with your playground test user against your developer project auth configs.',
518
+ 'Test tool executions against playground users using your developer project auth configs.',
519
args: [{ name: '<slug>', description: 'Tool slug (e.g. "GITHUB_CREATE_ISSUE")' }],
520
options: [
521
{ name: '-d, --data <text>', description: 'JSON arguments, @file, or - for stdin' },
556
{ name: '--table', description: 'Show compact table rows' },
557
],
558
},
562
- // ── Manage commands ───────────────────────────────────────────────────
559
+ // ── Dev admin commands ─────────────────────────────────────────────────
560
564
- 'manage toolkits list': {
561
+ 'dev toolkits list': {
562
usage:
566
- 'composio manage toolkits list [--query text] [--limit integer] [--connected] [--user-id text]',
563
+ 'composio dev toolkits list [--query text] [--limit integer] [--connected] [--user-id text]',
564
description: 'List available toolkits with connection status.',
565
options: [
566
{ name: '--query <text>', description: 'Text search by name, slug, or description' },
569
],
570
flags: [{ name: '--connected', description: 'Show only connected toolkits' }],
571
},
575
- 'manage toolkits info': {
576
- usage: 'composio manage toolkits info [--user-id text] [-a, --all] [<slug>]',
572
+ 'dev toolkits info': {
573
+ usage: 'composio dev toolkits info [--user-id text] [-a, --all] [<slug>]',
574
description: 'View details of a specific toolkit.',
575
args: [{ name: '<slug>', description: 'Toolkit slug (e.g. "github")' }],
576
flags: [{ name: '-a, --all', description: 'Show all details' }],
577
},
581
- 'manage toolkits search': {
582
- usage: 'composio manage toolkits search <query> [--limit integer]',
578
+ 'dev toolkits search': {
579
+ usage: 'composio dev toolkits search <query> [--limit integer]',
580
description: 'Search toolkits by use case.',
581
args: [{ name: '<query>', description: 'Search query' }],
582
options: [{ name: '--limit <integer>', description: 'Number of results' }],
583
},
587
- 'manage toolkits version': {
588
- usage: 'composio manage toolkits version <slug>',
584
+ 'dev toolkits version': {
585
+ usage: 'composio dev toolkits version <slug>',
586
description: 'Show latest and recent versions for a toolkit.',
587
args: [{ name: '<slug>', description: 'Toolkit slug' }],
588
},
592
- 'manage auth-configs list': {
593
- usage: 'composio manage auth-configs list [--toolkits text] [--query text] [--limit integer]',
589
+ 'dev auth-configs list': {
590
+ usage: 'composio dev auth-configs list [--toolkits text] [--query text] [--limit integer]',
591
description: 'List auth configs.',
592
options: [
593
{ name: '--toolkits <text>', description: 'Filter by toolkit slugs' },
595
{ name: '--limit <integer>', description: 'Number of results' },
596
],
597
},
601
- 'manage auth-configs info': {
602
- usage: 'composio manage auth-configs info [<id>]',
598
+ 'dev auth-configs info': {
599
+ usage: 'composio dev auth-configs info [<id>]',
600
description: 'View details of a specific auth config.',
601
args: [{ name: '<id>', description: 'Auth config ID' }],
602
},
606
- 'manage auth-configs create': {
603
+ 'dev auth-configs create': {
604
usage:
608
- 'composio manage auth-configs create --toolkit text [--auth-scheme text] [--scopes text] [--custom-credentials text] [<name>]',
605
+ 'composio dev auth-configs create --toolkit text [--auth-scheme text] [--scopes text] [--custom-credentials text] [<name>]',
606
description: 'Create a new auth config.',
607
args: [{ name: '<name>', description: 'Auth config name' }],
608
options: [
612
{ name: '--custom-credentials <text>', description: 'Custom credentials JSON' },
613
],
614
},
618
- 'manage auth-configs delete': {
619
- usage: 'composio manage auth-configs delete [-y, --yes] [<id>]',
615
+ 'dev auth-configs delete': {
616
+ usage: 'composio dev auth-configs delete [-y, --yes] [<id>]',
617
description: 'Delete an auth config.',
618
args: [{ name: '<id>', description: 'Auth config ID' }],
619
flags: [{ name: '-y, --yes', description: 'Skip confirmation prompt' }],
620
},
624
- 'manage connected-accounts list': {
621
+ 'dev connected-accounts list': {
622
usage:
626
- 'composio manage connected-accounts list [--toolkits text] [--user-id text] [--status text] [--limit integer]',
623
+ 'composio dev connected-accounts list [--toolkits text] [--user-id text] [--status text] [--limit integer]',
624
description: 'List connected accounts.',
625
options: [
626
{ name: '--toolkits <text>', description: 'Filter by toolkit slugs' },
629
{ name: '--limit <integer>', description: 'Number of results' },
630
],
631
},
635
- 'manage connected-accounts info': {
636
- usage: 'composio manage connected-accounts info [<id>]',
632
+ 'dev connected-accounts info': {
633
+ usage: 'composio dev connected-accounts info [<id>]',
634
description: 'View details of a specific connected account.',
635
args: [{ name: '<id>', description: 'Connected account ID' }],
636
},
640
- 'manage connected-accounts whoami': {
641
- usage: 'composio manage connected-accounts whoami [<id>]',
637
+ 'dev connected-accounts whoami': {
638
+ usage: 'composio dev connected-accounts whoami [<id>]',
639
description: 'Show the external account profile for a connected account.',
640
args: [{ name: '<id>', description: 'Connected account ID' }],
641
},
645
- 'manage connected-accounts delete': {
646
- usage: 'composio manage connected-accounts delete [-y, --yes] [<id>]',
642
+ 'dev connected-accounts delete': {
643
+ usage: 'composio dev connected-accounts delete [-y, --yes] [<id>]',
644
description: 'Delete a connected account.',
645
args: [{ name: '<id>', description: 'Connected account ID' }],
646
flags: [{ name: '-y, --yes', description: 'Skip confirmation prompt' }],
647
},
651
- 'manage connected-accounts link': {
648
+ 'dev connected-accounts link': {
649
usage:
653
- 'composio manage connected-accounts link [--auth-config text] [--user-id text] [--project-name text] [--no-browser] [--no-wait] [<toolkit>]',
650
+ 'composio dev connected-accounts link [--auth-config text] [--user-id text] [--project-name text] [--no-browser] [--no-wait] [<toolkit>]',
651
description: 'Connect an external account so tools can act on your behalf.',
652
args: [{ name: '<toolkit>', description: 'Toolkit slug to link (e.g. "github", "gmail")' }],
653
options: [
660
{ name: '--no-wait', description: 'Print link info and exit without waiting' },
661
],
662
},
666
- 'manage triggers list': {
667
- usage: 'composio manage triggers list [--toolkits text] [--limit integer]',
663
+ 'dev triggers list': {
664
+ usage: 'composio dev triggers list [--toolkits text] [--limit integer]',
665
description: 'List available trigger types.',
666
options: [
667
{ name: '--toolkits <text>', description: 'Filter by toolkit slugs' },
668
{ name: '--limit <integer>', description: 'Number of results' },
669
],
670
},
674
- 'manage triggers info': {
675
- usage: 'composio manage triggers info [<slug>]',
671
+ 'dev triggers info': {
672
+ usage: 'composio dev triggers info [<slug>]',
673
description: 'View details of a specific trigger type.',
674
args: [{ name: '<slug>', description: 'Trigger slug' }],
675
},
679
- 'manage triggers listen': {
676
+ 'dev triggers listen': {
677
usage:
681
- 'composio manage triggers listen [--toolkits text] [--trigger-slug text] [--json] [--table] [--max-events int] [--forward url] [--out file]',
678
+ 'composio dev triggers listen [--toolkits text] [--trigger-slug text] [--json] [--table] [--max-events int] [--forward url] [--out file]',
679
description: 'Listen to realtime trigger events and optionally forward them.',
680
options: [
681
{ name: '--toolkits <text>', description: 'Filter by toolkit slugs, comma-separated' },
692
{ name: '--table', description: 'Show compact table rows' },
693
],
694
},
698
- 'manage triggers status': {
695
+ 'dev triggers status': {
696
usage:
700
- 'composio manage triggers status [--user-ids text] [--toolkits text] [--trigger-ids text] [--show-disabled] [--limit integer]',
697
+ 'composio dev triggers status [--user-ids text] [--toolkits text] [--trigger-ids text] [--show-disabled] [--limit integer]',
698
description: 'Show active triggers with optional filters.',
699
options: [
700
{ name: '--user-ids <text>', description: 'Filter by user IDs' },
706
],
707
flags: [{ name: '--show-disabled', description: 'Include disabled triggers' }],
708
},
712
- 'manage triggers create': {
709
+ 'dev triggers create': {
710
usage:
714
- 'composio manage triggers create [--connected-account-id text] [--trigger-config text] [<trigger-name>]',
711
+ 'composio dev triggers create [--connected-account-id text] [--trigger-config text] [<trigger-name>]',
712
description: 'Create a new trigger instance.',
713
args: [{ name: '<trigger-name>', description: 'Trigger type slug' }],
714
options: [
716
{ name: '--trigger-config <text>', description: 'Trigger configuration JSON' },
717
],
718
},
722
- 'manage triggers enable': {
723
- usage: 'composio manage triggers enable [<id>]',
719
+ 'dev triggers enable': {
720
+ usage: 'composio dev triggers enable [<id>]',
721
description: 'Enable a trigger instance.',
722
args: [{ name: '<id>', description: 'Trigger instance ID' }],
723
},
727
- 'manage triggers disable': {
728
- usage: 'composio manage triggers disable [<id>]',
724
+ 'dev triggers disable': {
725
+ usage: 'composio dev triggers disable [<id>]',
726
description: 'Disable a trigger instance.',
727
args: [{ name: '<id>', description: 'Trigger instance ID' }],
728
},
732
- 'manage triggers delete': {
733
- usage: 'composio manage triggers delete [-y, --yes] [<id>]',
729
+ 'dev triggers delete': {
730
+ usage: 'composio dev triggers delete [-y, --yes] [<id>]',
731
description: 'Delete a trigger instance.',
732
args: [{ name: '<id>', description: 'Trigger instance ID' }],
733
flags: [{ name: '-y, --yes', description: 'Skip confirmation prompt' }],
734
},
738
- 'manage orgs list': {
739
- usage: 'composio manage orgs list [--limit integer]',
735
+ 'dev orgs list': {
736
+ usage: 'composio dev orgs list [--limit integer]',
737
description: 'List organizations and show current global selection.',
738
options: [{ name: '--limit <integer>', description: 'Number of results' }],
739
},
743
- 'manage orgs switch': {
744
- usage: 'composio manage orgs switch [--org-id text] [--limit integer]',
740
+ 'dev orgs switch': {
741
+ usage: 'composio dev orgs switch [--org-id text] [--limit integer]',
742
description: 'Switch default organization context.',
743
options: [
744
{ name: '--org-id <text>', description: 'Organization ID to switch to' },
745
{ name: '--limit <integer>', description: 'Number of orgs to show in picker' },
746
],
747
},
751
- 'manage projects list': {
752
- usage: 'composio manage projects list [--org-id text] [--limit integer]',
748
+ 'dev projects list': {
749
+ usage: 'composio dev projects list [--org-id text] [--limit integer]',
750
description: 'List developer projects for the current organization.',
751
options: [
752
{ name: '--org-id <text>', description: 'Organization ID override' },
864
if (last !== '--help' && last !== '-h') return undefined;
865
866
const cmdParts = args.slice(0, -1);
870
- // Try longest match first: "manage toolkits list" → "manage toolkits" → "manage"
867
+ // Try longest match first: "dev toolkits list" → "dev toolkits" → "dev"
868
for (let len = cmdParts.length; len > 0; len--) {
869
const key = cmdParts.slice(0, len).join(' ');
870
if (key in SUBCOMMAND_HELP) return key;
896
'you what to fix.',
897
'',
898
`Use ${bold('dev')} when you are building an agent with Composio's SDK and want scaffolding,`,
902
- 'playground execution, triggers, and logs.',
899
+ 'playground execution, logs, and developer-scoped management commands.',
900
'',
901
bold('USAGE'),
902
` ${name} <command> [options]`,