INSTALL

30 seconds to install.
Every agent. Every shell.

The CLI is a plain binary that ships as tl-cli on PyPI. Install it however you'd install any other Python tool. Auth it with Google SSO or password. You're done.

Pick your path.

RECOMMENDED · FOR NON-DEVELOPERS

pipx

The one-liner. Auto-updates. Tokens stored in your OS keychain. Works on macOS, Linux, and Windows without touching your system Python.

$ brew install pipx   # or: apt install pipx
$ pipx install tl-cli
$ tl auth login
# browser opens, Google SSO or password
$ tl describe
✓ you're ready

FOR CLAUDE CODE USERS

Plugin install

Installs the CLI plus the tl-data-analyst skill, the tl-analyst agent, and six slash commands into ~/.claude/plugins/tl-cli/. Zero further config — just open Claude Code and start talking.

$ pipx install tl-cli
$ tl auth login
$ tl setup claude
✓ /tl, /tl-deals, /tl-channels, /tl-brands,
  /tl-reports, /tl-balance installed

FOR DEVELOPERS

pip or uv

Install into a virtualenv, a CI runner, a Dockerfile, or an Airflow image. TL_API_KEY env var works as a fallback for unattended runs.

$ pip install tl-cli
# or, faster:
$ uv tool install tl-cli

ON YOUR TEAM'S SLACK

TL Slack app

OpenClaw, TL's own AI operator, runs this CLI inside our internal Slack today. A public Slack app you can install in your own workspace is next — join the waitlist.

Join the Slack app waitlist →

Works with every agent harness.

Claude Code

Official plugin · zero config

Cursor

Add to PATH · works in Composer & sidebar

Codex

OpenAI Agents SDK compatible

OpenClaw

Ships with the CLI, runs in TL's Slack

Aider

Any shell-spawning agent

Continue

VS Code / JetBrains

Zed

Zed agent mode

Windsurf

Codeium native

ChatGPT agents

Shell-native

Bare shell

No agent needed — tl works standalone

Auth, without the pain.

The CLI uses PKCE OAuth via Auth0 + CloudFlare. No client secrets stored on your machine. Tokens live in your OS keychain via the keyring Python package — same place your browser stores its auto-fill credentials.

Two login methods: Google SSO (the default) or password. We added password login specifically for academic researchers at HBS who don't use Google accounts — if it works for a Harvard professor, it'll work for you.

TL_API_KEY env var works as a fallback for CI, scripts, or Docker images where interactive login isn't practical.

$ tl auth login
# browser opens, you click, you're done
✓ Logged in as alex@acme.com

$ tl doctor
✓ version:      0.1.0
✓ auth:         valid
✓ api:          reachable (34ms)
✓ credit:       500 available

$ tl describe
# complete schema, credit table, filters

Three commands to sanity-check your install.

Install takes 30 seconds. First 500 credits are on us.

See the cheatsheet →

30 seconds to install. Every agent. Every shell.