tm command line

What this is: tm, the command line that ships with the Python SDK. When you need it: a quick look, a shell script, a CSV of a saved view.

pip install "tasksmate[cli]"   # see the Python SDK page for pre-release installs
tm auth login

tm auth login                                   # asks for the token (hidden), checks it, stores it
tm me
tm tasks list --org O0020 --status in_progress --status blocked
tm tasks get T123456 --json
tm tasks create --org O0020 --title "Ship the SDK" --project P96441 --due 2026-10-01
tm tasks update T123456 --status completed      # reads the ETag first: a concurrent change is a 412, not an overwrite
tm projects list --org O0020
tm views rows V123456 --csv > rows.csv
tm webhooks list --org O0020 · tm webhooks test WH123456 · tm webhooks deliveries WH123456
tm tokens list --org O0020
tm --version

• Output: a table by default, --json for raw objects.
• Organization: --org falls back to TASKSMATE_ORG, or to your organization when you have exactly one.
• Token: from TASKSMATE_TOKEN, else the OS keyring, else ~/.config/tasksmate/config.toml (mode 600, written only when no keyring is available or with --no-keyring); tm only ever prints its 12-character prefix.
• Exit codes: 0 success, 1 an API or connection error (the problem is printed with its request_id), 2 a usage error.