@devries-cameron20 / composio Mirror · read-only / commits / 3998b62fd
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.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 22, 00:45 UTC

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