← Back

Letterboxd CLI

The terminal for cinephiles.

bash — letterboxd-cli
$letterboxd log "dune part two"
Logging film to diary...
Role Developer
Year 2026
Stack TypeScript
Source GitHub →
Impact Full CLI with 7 commands: auth, search, log, rate, watchlist, diary, and stats

I kept forgetting to log movies after watching them. Opening the app, finding the film, writing a review — too many steps. So I built a CLI where I can brain dump my thoughts from the terminal and have them post to Letterboxd automatically.

Skills

  • CLI Development
  • Browser Automation
  • Terminal UX

Built With

  • TypeScript
  • Playwright
  • Commander
  • Chalk

The Challenge

I'd watch a movie and think "I should log that" — then forget entirely. Or I'd have thoughts I wanted to capture but the friction of opening the app, searching for the title, picking a rating, and writing a review meant I was losing takes I'd never get back.

The Solution

Built a terminal tool where I can just type my thoughts about a film and have them go straight to Letterboxd. No app switching, no searching through menus — just brain dump from the command line. The CLI handles auth, finds the right film, and posts the entry. TypeScript and Playwright handle the browser automation behind the scenes.

Features

Recent Activity

View latest diary entries, ratings, and reviews in the prompt.

Global Search

Search titles across history or the global database without a browser.

Data Export

Export movie data into JSON or Markdown for personal archiving.

Smart Caching

Intelligent offline access that caches results for speed.