oh-my-lilys

CLI tool for lilys.ai.

Installation

npm install -g oh-my-lilys
# or
bun add -g oh-my-lilys

Authentication

# Auto-extract token from browser (Chrome, Arc, Dia, Brave, Edge)
lilys auth

# Manual with token
lilys auth <token>

Commands

Command	Description
auth	Authenticate (auto browser extraction or manual token)
summarize <url>	Summarize a URL (YouTube, PDF, website, audio)
sessions	List all sessions
search <keyword>	Search sessions by keyword
delete <id>	Delete a session (--yes to skip confirm)
report <id>	Fetch or generate a report
chat <id> [query]	Ask AI questions about a session
thumbnail <id>	Extract video frame thumbnails
translate <id>	Translate session report
usage	Show plan usage and quota
share <id>	Create public share link
unshare <id>	Remove public sharing
export-pdf <id>	Export report as PDF (--output file.pdf)
collections / col	Manage collections
lang [code]	Get/set AI result language
whoami	Check authentication status (email, plan, etc.)
doctor	Diagnose issues
upgrade	Check for updates

All commands support --json for structured JSON output.

Report Generation

lilys report <id>                              # Fetch latest report
lilys report <id> --note-type detailed --watch # Generate & wait
lilys report <id> --note-type key_points       # Key report
lilys report <id> --generate textbook          # SSE streaming
lilys report <id> --export markdown            # Export as .md
lilys report <id> --json                       # JSON output

Note types: detailed, key_points, easy, script, animation, infographic, background, deep_dive

AI Chat

lilys chat <id> "what are the key takeaways?"  # Ask a question
lilys chat <id>                                # List chat threads
lilys chat <id> "question" --thread 123        # Continue thread
lilys chat <id> "question" --model paid        # Premium model
lilys chat <id> "question" --thinking          # Show AI thinking

Thumbnail Extraction

lilys thumbnail <id>                           # Default timestamps
lilys thumbnail <id> --times 10,30,60          # Specific timestamps
lilys thumbnail <id> --output ./frames         # Download locally

Translation

lilys translate <id> --to en                   # Translate to English
lilys translate <id> --to ja --note-id X       # Specific note

Collections

lilys col                                    # List collections
lilys col create "My Collection"             # Create
lilys col rename <col-id> "New Name"         # Rename
lilys col move <col-id> <session-id...>      # Move sessions in
lilys col delete <col-id>                    # Delete

Examples

lilys auth
lilys summarize https://youtube.com/watch?v=abc123
lilys sessions --json
lilys search "machine learning" --limit 5
lilys report 8260019 --note-type detailed --watch
lilys report 8260019 --export markdown
lilys chat 8260019 "summarize the main points"
lilys thumbnail 8260019 --times 10,60,120 --output ./frames
lilys translate 8260019 --to en
lilys usage --json
lilys share 8260019
lilys export-pdf 8260019 --output report.pdf
lilys lang ko

Error Handling

• Auth errors: Auto-detected (401/403), prompts re-authentication
• Watch mode: Polls every 3s until ready or timeout (default 120s)
• Note generation timeout: 504 errors don't fail — generation continues in background

Disclaimer

This tool reverse-engineers the lilys.ai API. Use at your own risk.