@devries-cameron20 / composio-1 / commits / 1c4b428a3
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Fix `install-skill` flag spelling in CLI help and parser (#3223)

## Summary - Corrects the root CLI flag spelling from `--instal-skill` to `--install-skill` in help text, README examples, parser messages, and tests. - Preserves `--instal-skill` as a backward-compatible alias so existing usage still works. - Bumps `@composio/cli` to `0.2.24` to realign the published package with the GitHub release tag. ## Testing - Updated and expanded CLI parser tests for canonical flag parsing, legacy alias handling, missing target errors, and invalid target errors. - Not run: full package test suite. - Not run: build / publish verification. --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Rahul Tarak committed Apr 16, 2026 at 03:47 UTC 1c4b428a386dd71027ef5163df13713d8b417f61
4 files changed +35 -22
ts/packages/cli/README.md
+2 -2
@@ -22,7 +22,7 @@ composio [--log-level all|trace|debug|info|warning|error|fatal|none]
22 ### Optional Flags
23
24 - `--log-level`: Set the log verbosity level. Accepted values: all, trace, debug, info, warning, error, fatal, none
25 -- `--instal-skill [skill-name] <claude|codex|openclaw>`: Manually install the composio skill for a supported agent when automatic installation fails. `--install-skill` is accepted as an alias.
25 +- `--install-skill [skill-name] <claude|codex|openclaw>`: Manually install the composio skill for a supported agent when automatic installation fails. `--instal-skill` is still accepted as a backward-compatible alias.
26
27 ## 🧭 Commands
28
@@ -45,7 +45,7 @@ composio [--log-level all|trace|debug|info|warning|error|fatal|none]
45 - `composio generate py [-o, --output-dir <directory>] [--toolkits <toolkit>]`: Generate Python type stubs for toolkits, tools, and triggers from the Composio API.
46 - `composio generate ts [-o, --output-dir <directory>] [--compact] [--transpiled] [--type-tools] [--toolkits <toolkit>]`: Generate TypeScript types for toolkits, tools, and triggers from the Composio API.
47 - `composio upgrade [--beta]`: Self-update the Composio CLI from the stable channel, or from the beta channel with `--beta`.
48 -- `composio --instal-skill [skill-name] <claude|codex|openclaw>`: Manually install the composio skill for Claude, Codex, or OpenClaw.
48 +- `composio --install-skill [skill-name] <claude|codex|openclaw>`: Manually install the composio skill for Claude, Codex, or OpenClaw.
49
50 ## Configuration
51
ts/packages/cli/src/commands/index.ts
+7 -5
@@ -171,7 +171,7 @@ const findNestedSubcommandMismatch = (
171 return undefined;
172 };
173
174 -const ROOT_INSTALL_SKILL_FLAGS = ['--instal-skill', '--install-skill'] as const;
174 +const ROOT_INSTALL_SKILL_FLAGS = ['--install-skill', '--instal-skill'] as const;
175 const SKILL_INSTALL_TARGETS = [
176 'claude',
177 'codex',
@@ -210,7 +210,7 @@ export const parseRootInstallSkillRequest = (
210 return {
211 _tag: 'error',
212 message:
213 - 'Missing target for --instal-skill. Usage: composio --instal-skill [skill-name] <claude|codex|openclaw>',
213 + 'Missing target for --install-skill. Usage: composio --install-skill [skill-name] <claude|codex|openclaw>',
214 };
215 }
216
@@ -219,7 +219,8 @@ export const parseRootInstallSkillRequest = (
219 if (!isSkillInstallTarget(target)) {
220 return {
221 _tag: 'error',
222 - message: 'Invalid target for --instal-skill. Expected one of: claude, codex, openclaw.',
222 + message:
223 + 'Invalid target for --install-skill. Expected one of: claude, codex, openclaw.',
224 };
225 }
226 return { _tag: 'parsed', target };
@@ -230,7 +231,8 @@ export const parseRootInstallSkillRequest = (
231 if (!isSkillInstallTarget(target)) {
232 return {
233 _tag: 'error',
233 - message: 'Invalid target for --instal-skill. Expected one of: claude, codex, openclaw.',
234 + message:
235 + 'Invalid target for --install-skill. Expected one of: claude, codex, openclaw.',
236 };
237 }
238 return { _tag: 'parsed', skillName, target };
@@ -239,7 +241,7 @@ export const parseRootInstallSkillRequest = (
241 return {
242 _tag: 'error',
243 message:
242 - 'Too many arguments for --instal-skill. Usage: composio --instal-skill [skill-name] <claude|codex|openclaw>',
244 + 'Too many arguments for --install-skill. Usage: composio --install-skill [skill-name] <claude|codex|openclaw>',
245 };
246 }
247
ts/packages/cli/src/commands/root-help.ts
+3 -3
@@ -1335,8 +1335,8 @@ export function printRootHelp(
1335 ` ${name} run 'const me = await execute("GITHUB_GET_THE_AUTHENTICATED_USER"); console.log(me)'`,
1336 '',
1337 ` ${dim('# Manually install the composio skill when auto-install fails')}`,
1338 - ` ${name} --instal-skill claude`,
1339 - ` ${name} --instal-skill composio-cli codex`,
1338 + ` ${name} --install-skill claude`,
1339 + ` ${name} --install-skill composio-cli codex`,
1340 '',
1341 ` ${dim('# Run a multi-step script with Promise.all')}`,
1342 ` ${name} run '`,
@@ -1408,7 +1408,7 @@ export function printRootHelp(
1408 bold('FLAGS'),
1409 ' -h, --help [mode] Show help for command (simple, default, full)',
1410 ` --version Show ${name} version`,
1411 - ' --instal-skill [skill-name] <claude|codex|openclaw>',
1411 + ' --install-skill [skill-name] <claude|codex|openclaw>',
1412 ' Manually install the composio skill for a supported agent',
1413 '',
1414 bold('LEARN MORE'),
ts/packages/cli/test/src/commands/install-skill-root-flag.test.ts
+23 -12
@@ -1,9 +1,11 @@
1 import { describe, expect, it } from '@effect/vitest';
2 import { parseRootInstallSkillRequest } from 'src/commands';
3
4 -describe('CLI: --instal-skill', () => {
4 +describe('CLI: --install-skill', () => {
5 it('parses the default skill name when only a target is provided', () => {
6 - expect(parseRootInstallSkillRequest(['node', 'composio', '--instal-skill', 'claude'])).toEqual({
6 + expect(
7 + parseRootInstallSkillRequest(['node', 'composio', '--install-skill', 'claude'])
8 + ).toEqual({
9 _tag: 'parsed',
10 target: 'claude',
11 });
@@ -11,7 +13,13 @@ describe('CLI: --instal-skill', () => {
13
14 it('parses an explicit skill name and target', () => {
15 expect(
14 - parseRootInstallSkillRequest(['node', 'composio', '--instal-skill', 'composio-cli', 'codex'])
16 + parseRootInstallSkillRequest([
17 + 'node',
18 + 'composio',
19 + '--install-skill',
20 + 'composio-cli',
21 + 'codex',
22 + ])
23 ).toEqual({
24 _tag: 'parsed',
25 skillName: 'composio-cli',
@@ -19,9 +27,9 @@ describe('CLI: --instal-skill', () => {
27 });
28 });
29
22 - it('accepts the --install-skill alias', () => {
30 + it('accepts the legacy --instal-skill alias', () => {
31 expect(
24 - parseRootInstallSkillRequest(['node', 'composio', '--install-skill', 'openclaw'])
32 + parseRootInstallSkillRequest(['node', 'composio', '--instal-skill', 'openclaw'])
33 ).toEqual({
34 _tag: 'parsed',
35 target: 'openclaw',
@@ -35,7 +43,7 @@ describe('CLI: --instal-skill', () => {
43 'composio',
44 '--log-level',
45 'debug',
38 - '--instal-skill',
46 + '--install-skill',
47 'claude',
48 ])
49 ).toEqual({
@@ -51,17 +59,20 @@ describe('CLI: --instal-skill', () => {
59 });
60
61 it('returns a helpful error when the target is missing', () => {
54 - expect(parseRootInstallSkillRequest(['node', 'composio', '--instal-skill'])).toEqual({
62 + expect(parseRootInstallSkillRequest(['node', 'composio', '--install-skill'])).toEqual({
63 _tag: 'error',
64 message:
57 - 'Missing target for --instal-skill. Usage: composio --instal-skill [skill-name] <claude|codex|openclaw>',
65 + 'Missing target for --install-skill. Usage: composio --install-skill [skill-name] <claude|codex|openclaw>',
66 });
67 });
68
69 it('returns a helpful error for invalid targets', () => {
62 - expect(parseRootInstallSkillRequest(['node', 'composio', '--instal-skill', 'cursor'])).toEqual({
63 - _tag: 'error',
64 - message: 'Invalid target for --instal-skill. Expected one of: claude, codex, openclaw.',
65 - });
70 + expect(parseRootInstallSkillRequest(['node', 'composio', '--install-skill', 'cursor'])).toEqual(
71 + {
72 + _tag: 'error',
73 + message:
74 + 'Invalid target for --install-skill. Expected one of: claude, codex, openclaw.',
75 + }
76 + );
77 });
78 });