# tm command line

> tm — tasks, projects, views, webhooks and tokens from your terminal. Ships with the Python SDK.

**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.

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

```bash
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.

---
Source: https://developers.tasksmate.indrasol.com/sdks/cli/