Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Document `--file` support for CLI skill uploads (#3114)
## Summary - Documented how to upload a local file with `composio execute` when a tool exposes a single `file_uploadable` input. - Added an example for `SLACK_UPLOAD_OR_CREATE_A_FILE_IN_SLACK` using `--file` alongside `-d` JSON arguments. - Clarified that `--file` only applies when there is exactly one uploadable file field; otherwise `-d` JSON should be used. ## Testing - Not run (documentation-only change). - Verified the updated CLI skill guidance in `ts/packages/cli/skills/composio-cli/SKILL.md`.
Rahul Tarak committed
Apr 5, 2026 at 21:28 UTC
3998b62fd259785731732ab516d08d2d33471556
1 file changed
+11
-1
ts/packages/cli/skills/composio-cli/SKILL.md
+11
-1
@@ -38,6 +38,16 @@ composio execute GITHUB_CREATE_AN_ISSUE -d @issue.json
38
cat issue.json | composio execute GITHUB_CREATE_AN_ISSUE -d -
39
```
40
41
+Upload a local file when the tool has a single `file_uploadable` input:
42
+
43
+```bash
44
+composio execute SLACK_UPLOAD_OR_CREATE_A_FILE_IN_SLACK \
45
+ --file ./image.png \
46
+ -d '{ channels: "C123" }'
47
+```
48
+
49
+`--file` injects the local path into the tool's single uploadable file field. If a tool has no uploadable file input, or has more than one, use explicit `-d` JSON instead.
50
+
51
Run independent tool calls in parallel:
52
53
```bash
@@ -80,7 +90,7 @@ composio proxy https://api.github.com/user --toolkit github --method GET </dev/n
90
91
> **For programmatic calls, LLM workflows, or anything beyond a single tool call — use `composio run`.**
92
83
-`composio run` executes an inline JavaScript snippet with authenticated `execute()`, `search()`, `proxy()`, and the experimental `experimental_subAgent()` helper pre-injected. No SDK setup required.
93
+`composio run` executes an inline ESM JavaScript/Typescript (bun compatible) snippet with authenticated `execute()`, `search()`, `proxy()`, and the experimental `experimental_subAgent()` helper pre-injected. No SDK setup required.
94
95
Chain multiple tools:
96