Transmission
Use flowbot transmission for capability transmission.
CLI root is transmission — do not invent flowbot transmission unless cli.md lists it as an alias.
Prefer the workflows below; load references/cli.md only when you need a flag or subcommand not covered here.
JSON fields: Torrent ids are integers; use list JSON id.
Setup
- Ensure CLI auth:
flowbot login - Set server via
FLOWBOT_SERVER_URLor--server-url; optional--profile,--debug/-d - Prefer
-o jsonwhen parsing results programmatically - Destructive commands often need
-y/--yesin non-interactive sessions — check cli.md - Token scopes:
service:transmission:read/service:transmission:write
Workflows
Add a torrent
When a user wants to download a magnet link or torrent URL:
flowbot transmission add -u "<magnet-or-http-url>"- Report back with the torrent ID and name.
Inspect and control downloads
When a user asks about current downloads or wants to stop/remove one:
flowbot transmission listflowbot transmission stop --ids <id>- Remove only after explicit confirmation: flowbot transmission remove --ids (no -y flag; confirm with the user first).
Troubleshooting
| Error | Fix |
|---|---|
| not logged in | flowbot login |
| server URL is required | set FLOWBOT_SERVER_URL or pass --server-url |
| permission denied / 403 | token missing service scopes (service:transmission:read / service:transmission:write) |
| hung waiting for confirm | pass -y when the command supports it (see cli.md) |
| empty results | provider not configured, wrong id/name, or empty dataset |
| unknown command | use flowbot transmission, not the capability id as the CLI verb |