leetcode-cli

A modern, feature-rich LeetCode CLI built with TypeScript.

Features

• 🔐 Cookie-based authentication - Secure login using browser cookies
• 📋 List problems - Filter by difficulty, status, tags, and search
• 📖 Beautiful problem display - Formatted output with examples and constraints
• 📝 Generate solution files - Auto-organized by difficulty and category
• ♻️ Reset solution files - Restore an existing local solution to the original stub
• 🧪 Test solutions - Run against sample test cases
• 📤 Submit solutions - Submit directly to LeetCode
• 📊 View statistics - Track your progress
• 🎯 Daily challenge - Get today's problem
• ⏱️ Interview timer - Timed practice with solve time tracking
• 📸 Solution snapshots - Save, restore, and compare solution versions
• 👥 Collaborative coding - Solve problems with a partner
• 📁 Workspaces - Isolate contexts (interview prep, study, contests)
• ⚙️ Configurable - Set language, editor, working directory, and LeetCode site
• 🖥️ Interactive TUI - Launch full-screen terminal workflow with leetcode
• 📂 Smart file discovery - Use problem ID, filename, or full path
• 🔄 Git Sync - Auto-sync solutions to GitHub/GitLab
• 🚀 Auto-update notifications - Get notified when updates are available

📚 Documentation

View Full Documentation →

TUI Guide →

Read the Blog Post →

Installation

npm install -g @night-slayer18/leetcode-cli

Quick Start

# Launch interactive TUI mode
leetcode

# Login with your LeetCode cookies
leetcode login

# Optional: switch to LeetCode China
leetcode config --site leetcode.cn

# Get today's daily challenge
leetcode daily

# Pick a problem and generate solution file
leetcode pick 1

# Reset an existing solution back to the original stub
leetcode reset 1

# Test your solution (any format works!)
leetcode test 1                              # Problem ID
leetcode test 1.two-sum.java                 # Filename
leetcode test ./Easy/Array/1.two-sum.java   # Full path

# Submit your solution
leetcode submit 1

Interactive TUI

Run leetcode with no arguments to open the full-screen TUI.

• Works in interactive terminals (TTY).
• Keeps existing command shortcuts for problem actions (p/t/s/h/H/V/b/n/e).
• Uses a unified bottom drawer in Problem view for hints, submissions, snapshots, notes, and status output.

See docs/tui.md for full keybindings and behavior.

Site Support

• Default site: leetcode.com
• Optional site: leetcode.cn
• Set site with:

leetcode config --site leetcode.com
leetcode config --site leetcode.cn

The CLI keeps command semantics the same and applies site-specific GraphQL queries/adapters internally.

Commands

Command	Description
login	Login with LeetCode browser cookies
logout	Clear stored credentials
whoami	Check login status
today	Show daily progress & challenge
list	List problems with filters
show <id>	Display problem description
hint <id>	Show hints for a problem
pick <id>	Generate solution file
pick-batch <ids>	Pick multiple problems
reset <id>	Reset solution file to original stub
bookmark <action>	Manage problem bookmarks
note <id>	Manage problem notes
daily	Show today's challenge
random	Get a random problem
test <id|file>	Test solution against sample cases
submit <id|file>	Submit solution to LeetCode
submissions <id>	View past submissions
stat [username]	Show user statistics
timer <id>	Interview mode with timer
snapshot <cmd>	Save and restore solution versions
diff <id>	Compare solution with past submissions
collab <cmd>	Collaborative coding with a partner
contest [slug]	Browse and pick from contest problems
workspace <cmd>	Manage workspaces for different contexts
config	View or set configuration
sync	Sync solutions to Git repository
update	Check for CLI updates
changelog	View release notes and breaking changes

Usage Examples

List Problems

# List all problems
leetcode list

# Filter by difficulty
leetcode list -d easy
leetcode list -d medium
leetcode list -d hard

# Pagination
leetcode list --page 2 -n 10

# Search by keyword
leetcode list -s "binary tree"

Show Problem

leetcode show 1
leetcode show two-sum

Get Hints

# Show hints one at a time (press Enter for next)
leetcode hint 1
leetcode hint two-sum

# Show all hints at once
leetcode hint 1 --all

Pick Problem

# Generate solution file (uses default language)
leetcode pick 1

# Specify language
leetcode pick 1 --lang python3
leetcode pick 175 --lang sql

# Skip opening in editor
leetcode pick 1 --no-open

Reset Problem

Reset an existing local solution file back to the original LeetCode stub. This overwrites the file immediately.

leetcode reset 1
leetcode reset two-sum

Test & Submit

All formats work for both test and submit:

# Using problem ID (auto-finds the file)
leetcode test 20
leetcode submit 20

# Using filename
leetcode test 20.valid-parentheses.java
leetcode submit 20.valid-parentheses.java

# Using full path
leetcode test ./Easy/String/20.valid-parentheses.java

# With custom test case
leetcode test 20 -c "[1,2,3]\n4"

# Visual debugging (ASCII visualization for arrays, trees, etc.)
leetcode test 1 --visualize

Random Problem

Fetch and solve a random problem.

# Get random problem
leetcode random

# Filter by difficulty
leetcode random -d hard

# Filter by topic tag
leetcode random -t dp

# Pick immediately
leetcode random -d medium --pick

View & Download Submissions

View past submissions and download code.

# List last 20 submissions
leetcode submissions 1

# View details of last accepted submission
leetcode submissions 1 --last

# Download last accepted solution
leetcode submissions 1 --download

Productivity Features

# Show today's progress & challenge
leetcode today

# Pick multiple problems at once
leetcode pick-batch 1 2 3 -l python3

# Bookmark problems
leetcode bookmark add 1
leetcode bookmark list

# Keep personal notes
leetcode note 1 edit

User Statistics

# Basic stats (solved count, rank, streak)
leetcode stat

# Weekly activity table (last 12 weeks)
leetcode stat -c

# Skill breakdown by topic tags
leetcode stat -s

# 7-day trend chart
leetcode stat -t

Git Integration

# Sync all solutions to your configured git repo
leetcode sync

Interview Timer

# Start timer for a problem (default: Easy=20m, Medium=40m, Hard=60m)
leetcode timer 1

# Custom time limit
leetcode timer 1 -m 30

# View your solve time stats
leetcode timer --stats

# Stop active timer
leetcode timer --stop

Collaborative Coding

# Host a collaboration session
leetcode collab host 1

# Share the room code with your partner
# Partner joins with:
leetcode collab join ABC123

# Both solve the problem, then sync
leetcode collab sync

# Compare solutions
leetcode collab compare

# Check session status
leetcode collab status

# Leave session
leetcode collab leave

Contest Problems

# Browse contests and select a problem interactively
leetcode contest

# Jump directly to a contest by slug
leetcode contest weekly-contest-401

# Override language for solution generation
leetcode contest weekly-contest-401 -l python3

# Skip opening in editor
leetcode contest --no-open

Reset Solution

# Reset a solution file back to the original LeetCode stub (by problem ID)
leetcode reset 1

# Reset by problem slug
leetcode reset two-sum

Solution Snapshots

# Save current approach
leetcode snapshot save 1 "brute-force"

# Try a new approach, then save
leetcode snapshot save 1 "hash-map"

# List all saved versions
leetcode snapshot list 1

# Compare approaches
leetcode snapshot diff 1 1 2

# Restore if needed
leetcode snapshot restore 1 brute-force

Compare Solutions

# Compare with last accepted submission
leetcode diff 1

# Show unified diff (line-by-line changes)
leetcode diff 1 --unified

# Compare with specific submission
leetcode diff 1 --submission 12345

# Compare with local file
leetcode diff 1 --file other-solution.py

Workspaces

Isolate your problem-solving contexts (e.g., interview prep vs daily practice).

# Show current workspace
leetcode workspace current

# List all workspaces
leetcode workspace list

# Create new workspace
leetcode workspace create interview -w ~/leetcode-interview

# Switch workspace
leetcode workspace use interview

# Delete workspace (files not deleted)
leetcode workspace delete old-workspace

Each workspace has its own config, timer history, and solution snapshots.

Configuration

# View current config
leetcode config

# Interactive setup
leetcode config -i

# Set specific options
leetcode config --lang python3
leetcode config --lang sql
leetcode config --editor code
leetcode config --workdir ~/leetcode
leetcode config --repo https://github.com/username/leetcode-solutions.git

# Pick a color theme for the TUI (dark, light, or auto)
leetcode config --theme light
leetcode config --theme dark
leetcode config --theme auto

The --theme setting is workspace-scoped. auto (the default) probes the terminal for its background color via OSC 11 and falls back to COLORFGBG, then to dark, if the terminal doesn't reply.

Folder Structure

Solution files are automatically organized by difficulty and category:

leetcode/
├── Easy/
│   ├── Array/
│   │   └── 1.two-sum.java
│   └── String/
│       └── 20.valid-parentheses.java
├── Medium/
│   └── Array/
│       └── 15.3sum.java
└── Hard/
    └── Array/
        └── 4.median-of-two-sorted-arrays.java

Supported Languages

Language	Extension
TypeScript	.ts
JavaScript	.js
Python3	.py
Java	.java
C++	.cpp
C	.c
C#	.cs
Go	.go
Rust	.rs
Kotlin	.kt
Swift	.swift
SQL	.sql

Authentication

This CLI uses cookie-based authentication from your LeetCode browser session.

1. Open leetcode.com in your browser
2. Login to your account
3. Open DevTools (F12) → Application → Cookies → leetcode.com
4. Run leetcode login and paste your LEETCODE_SESSION and csrftoken values

Credential Backend

• Default backend: system keychain (keytar)
• Explicit encrypted-file backend: set LEETCODECLI_CREDENTIAL_BACKEND=file
• File backend requires LEETCODECLI_MASTER_KEY
• Env read-only mode: set both LEETCODE_SESSION and LEETCODE_CSRF_TOKEN

If both env vars are present, the CLI uses them directly and login/logout run in read-only env mode.

Windows (PowerShell) quick setup:

$env:LEETCODECLI_CREDENTIAL_BACKEND = "keychain"
# or encrypted file backend:
# $env:LEETCODECLI_CREDENTIAL_BACKEND = "file"
# $env:LEETCODECLI_MASTER_KEY = "<your_master_key>"

Config File

Workspace config is stored at:

• ~/.leetcode/workspaces/<name>/config.json

Requirements

• Node.js >= 20.0.0

Development

# Clone and install
git clone https://github.com/night-slayer18/leetcode-cli.git
cd leetcode-cli
npm install

# Build
npm run build

# Run tests
npm test

# Run with coverage
npm test -- --coverage

See docs/testing.md for detailed testing documentation.

Docker Usage

You can run the CLI using Docker without installing Node.js.

Method 1: Pre-built Image (Recommended)

1. Pull the image:

   docker pull nightslayer/leetcode-cli:latest

2. Setup Shell Function (Add to your shell config):

   Bash/Zsh (~/.bashrc or ~/.zshrc):

   leetcode() {
     docker run -it --rm \
       -v "$(pwd)/leetcode:/root/leetcode" \
       -v "$HOME/.leetcode:/root/.leetcode" \
       nightslayer/leetcode-cli:latest "$@"
   }

   Fish (~/.config/fish/config.fish):

   function leetcode
       docker run -it --rm \
           -v (pwd)/leetcode:/root/leetcode \
           -v $HOME/.leetcode:/root/.leetcode \
           nightslayer/leetcode-cli:latest $argv
   end

   PowerShell ($PROFILE):

   function leetcode {
     docker run -it --rm `
       -v "${PWD}/leetcode:/root/leetcode" `
       -v "$env:USERPROFILE/.leetcode:/root/.leetcode" `
       nightslayer/leetcode-cli:latest $args
   }

3. Usage:

   leetcode list
   leetcode pick 1

Method 2: Build Locally

1. Build the image:

   docker build -t leetcode-cli .

2. Run commands:

   docker run -it --rm \
     -v "$(pwd)/leetcode:/root/leetcode" \
     -v "$HOME/.leetcode:/root/.leetcode" \
     leetcode-cli list

   Note: We mount ~/.leetcode to persist CLI data (workspace config, snapshots, optional file-backend credentials) and leetcode folder to save solution files.

License

Apache-2.0 © night-slayer18