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.