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