trakt

name	trakt
description	Track and view your watched movies and TV shows via trakt.tv. Use when user asks about their watch history, what they've been watching, or wants to search for movies/shows.
homepage	https://trakt.tv
metadata	{"clawdbot":{"emoji":"🎬","requires":{"bins":["trakt-cli"]}}}

Trakt CLI

Query your trakt.tv watch history and search for movies/TV shows.

Installation

npm install -g trakt-cli

Setup

1. Create an app at https://trakt.tv/oauth/applications/new
2. Run: trakt-cli auth --client-id <id> --client-secret <secret>
3. Visit the URL shown and enter the device code
4. Credentials saved to ~/.trakt.yaml

Commands

Watch History

trakt-cli history                  # Recent history (default: 10 items)
trakt-cli history --limit 25       # Show more
trakt-cli history --page 2         # Paginate

Search

trakt-cli search "Breaking Bad"
trakt-cli search "The Matrix"

Usage Examples

User: "What have I been watching lately?"

trakt-cli history

User: "Show me my last 20 watched items"

trakt-cli history --limit 20

User: "Find info about Severance"

trakt-cli search "Severance"

Notes

• Search works without authentication
• History requires authentication
• Read-only access to watch history