/notebooklm-skill-codex

Commands

Always run scripts through the wrapper:

python scripts/run.py <script> [args...]

Authentication

Check status:

python scripts/run.py auth_manager.py status

Set up login with a visible browser:

python scripts/run.py auth_manager.py setup

Re-authenticate:

python scripts/run.py auth_manager.py reauth

Validate saved auth:

python scripts/run.py auth_manager.py validate

Clear auth:

python scripts/run.py auth_manager.py clear

Notebook library

List:

python scripts/run.py notebook_manager.py list

Add:

python scripts/run.py notebook_manager.py add \
  --url "https://notebooklm.google.com/notebook/..." \
  --name "Notebook Name" \
  --description "What the notebook contains" \
  --topics "topic1,topic2,topic3"

Search:

python scripts/run.py notebook_manager.py search --query "keyword"

Activate:

python scripts/run.py notebook_manager.py activate --id notebook-id

Remove:

python scripts/run.py notebook_manager.py remove --id notebook-id

Stats:

python scripts/run.py notebook_manager.py stats

Notebook queries

Use active notebook:

python scripts/run.py ask_question.py --question "Your question here"

Use a specific saved notebook:

python scripts/run.py ask_question.py --question "..." --notebook-id notebook-id

Use a direct NotebookLM URL:

python scripts/run.py ask_question.py --question "..." --notebook-url "https://notebooklm.google.com/notebook/..."

Show browser during query debugging:

python scripts/run.py ask_question.py --question "..." --show-browser

Cleanup

Preview cleanup:

python scripts/run.py cleanup_manager.py

Execute cleanup:

python scripts/run.py cleanup_manager.py --confirm

Preserve saved notebook library:

python scripts/run.py cleanup_manager.py --confirm --preserve-library