Skip to content

teng-lin/notebooklm-py

notebooklm

Verified

Install, authenticate, troubleshoot, and operate Gemini Notebook through the notebooklm-py CLI or typed async Python API. Use for notebook and source management, grounded chat and research, and artifact generation or download when the user mentions Gemini Notebook, notebooklm-py, the notebooklm CLI, or its Python API. Do not use for the generic Gemini API or unrelated content creation.

FileKindSize
SKILL.mdskill md16.0 KB
examples/bulk-import.pyscript3.4 KB
examples/chat.pyscript6.9 KB
examples/notes.pyscript9.8 KB
examples/quickstart.pyscript2.3 KB
examples/refresh_browser_cookies.pyscript2.9 KB
examples/research-to-podcast.pyscript3.2 KB
examples/video.pyscript5.9 KB
scripts/__init__.pyscript73 B
scripts/_ci_e2e_notebooks.pyscript19.0 KB
scripts/_ci_progress.pyscript2.5 KB
scripts/_ci_rpc_progress.pyscript7.5 KB
scripts/_live_auth_scenarios/__init__.pyscript2.6 KB
scripts/_live_auth_scenarios/_contract.pyscript1.9 KB
scripts/_live_auth_scenarios/browser_refresh.pyscript3.1 KB
scripts/_live_auth_scenarios/crash_safe_writer.pyscript1.9 KB
scripts/_live_auth_scenarios/master_token_recovery.pyscript3.3 KB
scripts/_live_auth_scenarios/mcp_recovery.pyscript3.0 KB
scripts/_live_auth_scenarios/rest_recovery.pyscript5.9 KB
scripts/_live_auth_scenarios/sibling_concurrent_reload.pyscript3.9 KB
scripts/_live_auth_scenarios/storage_reload.pyscript2.9 KB
scripts/_onetime_rescrub_cookies.pyscript6.6 KB
scripts/_onetime_retarget_cassette_hosts.pyscript8.5 KB
scripts/_strip_audit_refs.pyscript15.9 KB
scripts/_tracked_files.pyscript872 B
scripts/aggregate_ci_e2e_outcomes.pyscript10.8 KB
scripts/android_grpc_canary.pyscript26.6 KB
scripts/api-compat-allowlist.jsonconfig163 B
scripts/audit_auth_import_graph.pyscript7.5 KB
scripts/audit_auth_patch_sites.pyscript83.6 KB
scripts/audit_auth_shared_mutations.pyscript41.7 KB
scripts/audit_backend_coupling.pyscript32.8 KB
scripts/audit_public_api_compat.pyscript47.4 KB
scripts/audit_test_suite.pyscript10.7 KB
scripts/capture_mobile_grpc.jsscript5.1 KB
scripts/capture_rpc_registry.pyscript44.5 KB
scripts/check_action_pinning.pyscript6.7 KB
scripts/check_auth_behavior_scenario_policy.pyscript37.1 KB
scripts/check_auth_coverage_delta.pyscript23.2 KB
scripts/check_auth_lifecycle_cleanup_policy.pyscript11.7 KB
scripts/check_base_wheel.pyscript6.3 KB
scripts/check_ci_install_parity.pyscript8.8 KB
scripts/check_claude_md_freshness.pyscript8.0 KB
scripts/check_coverage_thresholds.pyscript8.4 KB
scripts/check_deprecation_targets.pyscript33.1 KB
scripts/check_docs_module_refs.pyscript14.4 KB
scripts/check_rpc_health.pyscript112.0 KB
scripts/check_workflow_permissions.pyscript5.3 KB
scripts/check_workflow_secret_gates.pyscript40.4 KB
scripts/decode_mobile_grpc.pyscript7.2 KB
scripts/diagnose_get_notebook.pyscript9.1 KB
scripts/extract_blutter_grpc_signatures.pyscript7.6 KB
scripts/live_auth_matrix.pyscript40.2 KB
scripts/manage_ci_e2e_notebooks.pyscript67.4 KB
scripts/materialize_ci_auth.pyscript8.0 KB
scripts/mcp_live_smoke.pyexecutablescript224 B
scripts/parse_pbenums.pyscript8.6 KB
scripts/parse_pbschema.pyscript11.8 KB
scripts/regen_baselines.pyscript2.7 KB
scripts/regenerate_android_protos.pyscript16.3 KB
scripts/rescrub-cassettes.pyscript13.3 KB
scripts/scrub_rpc_har.pyscript9.4 KB
scripts/select_ci_account.pyscript4.8 KB
scripts/stress_fault_server.pyscript20.6 KB
scripts/test_taxonomy_inventory.pyscript16.1 KB
scripts/verify_ci_artifacts.pyscript35.3 KB

scripts/check_workflow_permissions.py

View on GitHub
"""Assert non-publish workflows have a top-level `permissions:` block.

Prevents supply-chain blast radius from default-permissive ``GITHUB_TOKEN``
scopes on workflows that don't need them.

Usage:
    python scripts/check_workflow_permissions.py
    python scripts/check_workflow_permissions.py --workflow-dir custom/path

Exit codes:
    0  All non-allowlisted workflows have a top-level permissions block.
    1  One or more workflows are missing the block.
    2  Argument error.
"""

from __future__ import annotations

import argparse
import sys
from pathlib import Path

# Workflows that intentionally rely on job-level permissions or default scopes.
# codeql.yml: needs `security-events: write` (job-scoped is the standard).
# publish.yml / testpypi-publish.yml: write to PyPI; permissions live at job level.
ALLOWLIST = {
    "codeql.yml",
    "publish.yml",
    "testpypi-publish.yml",
}


def main() -> int:
    ap = argparse.ArgumentParser(description=__doc__)
    ap.add_argument(
        "--workflow-dir",
        default=".github/workflows",
        help="Directory containing workflow YAML files",
    )
    args = ap.parse_args()

    workflow_dir = Path(args.workflow_dir)
    if not workflow_dir.is_dir():
        print(f"Not a directory: {workflow_dir}", file=sys.stderr)
        return 2

    # Assert each non-allowlisted workflow has a top-level `permissions:`
    # block whose body declares only read scopes. Reject inline strings
    # like `permissions: write-all`, `permissions: read-all`, or
    # `permissions: {}` — anything that isn't an explicit, scoped block
    # of read-only keys.
    #
    # We avoid a yaml dependency by parsing the small structural shape we
    # care about: header line `permissions:` (top-level, nothing else
    # on the line after the colon except optional comment) followed by
    # indented `<scope>: read` or `<scope>: none` lines.
    bad: list[str] = []
    issues: dict[str, str] = {}
    workflow_files = sorted(list(workflow_dir.glob("*.yml")) + list(workflow_dir.glob("*.yaml")))
    for path in workflow_files:
        if path.name in ALLOWLIST:
            continue
        lines = path.read_text().splitlines()
        header_idx = _find_top_level_permissions_header(lines)
        if header_idx is None:
            bad.append(str(path))
            issues[str(path)] = "no top-level `permissions:` block"
            continue
        ok, reason = _validate_block_body(lines, header_idx)
        if not ok:
            bad.append(str(path))
            issues[str(path)] = reason

    if bad:
        for p in bad:
            print(f"{p}: {issues[p]}", file=sys.stderr)
        return 1

    print("OK: all non-allowlisted workflows have a scoped permissions block")
    return 0


# Scopes that may appear with `read` or `none` (or `write` only on allowlisted
# workflows — but allowlisted ones never reach this validator). Sourced from
# GitHub Actions workflow-syntax + GITHUB_TOKEN reference docs.
_ALLOWED_READ_SCOPES = frozenset(
    {
        "actions",
        "artifact-metadata",
        "attestations",
        "checks",
        "code-scanning",
        "contents",
        "deployments",
        "discussions",
        "environments",
        "id-token",
        "issues",
        "labels",
        "merge-queues",
        "metadata",
        "migrations",
        "models",
        "packages",
        "pages",
        "pull-requests",
        "repository-projects",
        "security-contacts",
        "security-events",
        "statuses",
        "vulnerability-alerts",
    }
)


def _find_top_level_permissions_header(lines: list[str]) -> int | None:
    """Return the index of a top-level `permissions:` header line, or None.

    "Top-level" = column 0 (no indent). The value after the colon must be
    empty (or whitespace + comment): an inline value like `write-all` is
    not a scoped block.
    """
    import re

    header_re = re.compile(r"^permissions:\s*(#.*)?$")
    for i, line in enumerate(lines):
        if header_re.match(line):
            return i
    return None


def _validate_block_body(lines: list[str], header_idx: int) -> tuple[bool, str]:
    """Validate the indented body under `permissions:` allows only read scopes.

    Returns (ok, reason). The body terminates at the next non-indented,
    non-blank line.
    """
    import re

    # Accept optional single/double quotes around the value (valid YAML).
    item_re = re.compile(r"^( +)([a-z][a-z0-9-]*):\s*['\"]?([a-z-]+)['\"]?\s*(#.*)?$")

    body_started = False
    for line in lines[header_idx + 1 :]:
        stripped = line.rstrip()
        if not stripped or stripped.lstrip().startswith("#"):
            continue
        if not line.startswith((" ", "\t")):
            break  # end of block
        body_started = True
        m = item_re.match(line)
        if not m:
            return False, f"unparseable body line under permissions: {stripped!r}"
        scope = m.group(2)
        value = m.group(3)
        if scope not in _ALLOWED_READ_SCOPES:
            return False, f"unknown scope under permissions: {scope!r}"
        if value not in ("read", "none"):
            return False, f"scope {scope!r} has non-read value {value!r}"

    if not body_started:
        return False, "permissions: header has no indented body (likely inline value)"
    return True, ""


if __name__ == "__main__":
    sys.exit(main())
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall