Introduction
# Trakt CLI
Query your trakt.tv watch history and search for movies/TV shows.
## Installation
```bash 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
```bash trakt-cli history # Recent history (default: 10 items) trakt-cli history --limit 25 # Show more trakt-cli history --page 2 # Paginate ```
### Search
```bash trakt-cli search "Breaking Bad" trakt-cli search "The Matrix" ```
## Usage Examples
**User: "What have I been watching lately?"** ```bash trakt-cli history ```
**User: "Show me my last 20 watched items"** ```bash trakt-cli history --limit 20 ```
**User: "Find info about Severance"** ```bash trakt-cli search "Severance" ```
## Notes
- Search works without authentication - History requires authentication - Read-only access to watch history