feat(cli): add agent show commands for Codex and Claude

Author: mike-golant

README.md

@@ -159,6 +159,8 @@ Other useful CLI commands:
 
 ```bash
 notebooklm auth check --test         # Diagnose auth/cookie issues
+notebooklm agent show codex          # Print bundled Codex instructions
+notebooklm agent show claude         # Print bundled Claude Code skill template
 notebooklm language list             # List supported output languages
 notebooklm metadata --json           # Export notebook metadata and sources
 notebooklm share status              # Inspect sharing state
@@ -206,6 +208,7 @@ asyncio.run(main())
 ```bash
 # Install via CLI or ask Claude Code to do it
 notebooklm skill install
+notebooklm agent show claude
 
 # Then use natural language:
 # "Create a podcast about quantum computing"
@@ -219,6 +222,7 @@ Codex reads repo-level instructions from [`AGENTS.md`](AGENTS.md), so there is n
 
 ```bash
 uv sync --extra dev --extra browser
+notebooklm agent show codex
 notebooklm login
 notebooklm list --json
 ```

docs/cli-reference.md

@@ -27,7 +27,7 @@ See [Configuration](configuration.md) for details on environment variables and C
 - **Session commands** - Authentication and context management
 - **Notebook commands** - CRUD operations on notebooks
 - **Chat commands** - Querying and conversation management
-- **Grouped commands** - `source`, `artifact`, `generate`, `download`, `note`, `share`, `research`, `language`, `skill`, `auth`
+- **Grouped commands** - `source`, `artifact`, `agent`, `generate`, `download`, `note`, `share`, `research`, `language`, `skill`, `auth`
 - **Utility commands** - `metadata`
 
 ---
@@ -208,6 +208,17 @@ After installation, Claude Code recognizes NotebookLM commands via `/notebooklm`
 
 Codex does not use the `skill` subcommand. In this repository it reads the root [`AGENTS.md`](../AGENTS.md) file and invokes the `notebooklm` CLI or Python API directly.
 
+### Agent Commands (`notebooklm agent <cmd>`)
+
+Show bundled instructions for supported agent environments.
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `show codex` | Print the Codex repository guidance | `agent show codex` |
+| `show claude` | Print the bundled Claude Code skill template | `agent show claude` |
+
+`agent show codex` prefers the root [`AGENTS.md`](../AGENTS.md) file when running from a source checkout, so the CLI mirrors the same instructions Codex sees in the repository.
+
 ### Features Beyond the Web UI
 
 These CLI capabilities are not available in NotebookLM's web interface:

src/notebooklm/cli/__init__.py

@@ -5,6 +5,7 @@
 Command groups are organized into separate modules:
 - source.py: Source management commands (includes add-research)
 - artifact.py: Artifact management commands
+- agent.py: Agent integration helpers
 - generate.py: Content generation commands
 - download.py: Download commands
 - note.py: Note management commands
@@ -16,6 +17,7 @@
 """
 
 # Command groups (subcommand style)
+from .agent import agent
 from .artifact import artifact
 from .chat import register_chat_commands
 from .download import download
@@ -80,6 +82,7 @@
     # Command groups (subcommand style)
     "source",
     "artifact",
+    "agent",
     "generate",
     "download",
     "note",

src/notebooklm/cli/agent.py

@@ -0,0 +1,24 @@
+"""Agent integration commands."""
+
+import click
+
+from .agent_templates import get_agent_source_content
+from .helpers import console
+
+
+@click.group()
+def agent():
+    """Show bundled instructions for supported agent environments."""
+    pass
+
+
+@agent.command("show")
+@click.argument("target", type=click.Choice(["codex", "claude"], case_sensitive=False))
+def show_agent(target: str):
+    """Display instructions for Codex or Claude Code."""
+    content = get_agent_source_content(target)
+    if content is None:
+        console.print(f"[red]Error:[/red] {target} instructions not found in package data.")
+        raise SystemExit(1)
+
+    console.print(content)

src/notebooklm/cli/agent_templates.py

@@ -0,0 +1,35 @@
+"""Shared agent instruction loading helpers."""
+
+from importlib import resources
+from pathlib import Path
+
+AGENT_TEMPLATE_FILES = {
+    "claude": "SKILL.md",
+    "codex": "CODEX.md",
+}
+
+REPO_ROOT_AGENTS = Path(__file__).resolve().parents[3] / "AGENTS.md"
+
+
+def _read_package_data(filename: str) -> str | None:
+    """Read a packaged agent template file."""
+    try:
+        return (resources.files("notebooklm") / "data" / filename).read_text(encoding="utf-8")
+    except (FileNotFoundError, TypeError):
+        return None
+
+
+def get_agent_source_content(target: str) -> str | None:
+    """Return bundled instructions for a supported agent target."""
+    normalized = target.lower()
+
+    # Prefer the repo-level Codex guide when running from a source checkout so
+    # the CLI mirrors the instructions Codex actually sees in this repository.
+    if normalized == "codex" and REPO_ROOT_AGENTS.exists():
+        return REPO_ROOT_AGENTS.read_text(encoding="utf-8")
+
+    filename = AGENT_TEMPLATE_FILES.get(normalized)
+    if filename is None:
+        return None
+
+    return _read_package_data(filename)

src/notebooklm/cli/skill.py

@@ -5,11 +5,11 @@
 
 import contextlib
 import re
-from importlib import resources
 from pathlib import Path
 
 import click
 
+from .agent_templates import get_agent_source_content
 from .helpers import console
 
 # Skill paths
@@ -19,11 +19,7 @@
 
 def get_skill_source_content() -> str | None:
     """Read the skill source file from package data."""
-    try:
-        # Python 3.9+ way to read package data (use / operator for path traversal)
-        return (resources.files("notebooklm") / "data" / "SKILL.md").read_text(encoding="utf-8")
-    except (FileNotFoundError, TypeError):
-        return None
+    return get_agent_source_content("claude")
 
 
 def get_package_version() -> str:

src/notebooklm/data/CODEX.md

@@ -0,0 +1,35 @@
+# Repository Guidelines
+
+**Status:** Active
+**Last Updated:** 2026-03-13
+
+## Project Structure & Module Organization
+
+`src/notebooklm/` contains the async client and typed APIs. Internal feature modules use `_` prefixes such as `_sources.py` and `_artifacts.py`; `src/notebooklm/cli/` holds Click commands, and `src/notebooklm/rpc/` handles protocol encoding and decoding. Tests are split by scope: `tests/unit/`, `tests/integration/`, and `tests/e2e/`. Recorded HTTP fixtures live in `tests/cassettes/`. Examples are in `docs/examples/`, and diagnostics live in `scripts/`.
+
+## Build, Test, and Development Commands
+
+Use `uv` for local work:
+
+```bash
+uv sync --extra dev --extra browser
+uv run pytest
+uv run ruff check src/ tests/
+uv run ruff format src/ tests/
+uv run mypy src/notebooklm
+uv run pre-commit run --all-files
+```
+
+Run `uv run pytest tests/e2e -m readonly` only after `notebooklm login` and setting test notebook env vars.
+
+## Coding Style & Naming Conventions
+
+Target Python 3.10+, 4-space indentation, and double quotes. Ruff enforces formatting and import order with a 100-character line length. Keep module and test file names in `snake_case`; prefer descriptive Click command names that match existing groups such as `source`, `artifact`, and `research`. Preserve the internal/public split: `_*.py` for implementation, exported types in `src/notebooklm/__init__.py`.
+
+## Testing Guidelines
+
+Put pure logic in `tests/unit/`, VCR-backed flows in `tests/integration/`, and authenticated NotebookLM coverage in `tests/e2e/`. Name tests `test_<behavior>.py` and record cassettes with `NOTEBOOKLM_VCR_RECORD=1 uv run pytest tests/integration/test_vcr_*.py -v`. Coverage is expected to stay at or above the configured 90% threshold.
+
+## Commit, PR, and Agent Notes
+
+Follow the existing commit style: `feat(cli): ...`, `fix(cli): ...`, `refactor(test): ...`, `style: ...`. PRs should include a short summary, linked issue when relevant, and the commands run locally. For Codex or other parallel agents, prefer `--json`, pass explicit notebook IDs instead of relying on `notebooklm use`, and isolate runs with `NOTEBOOKLM_HOME=/tmp/<agent-id>` when multiple agents share one machine.

src/notebooklm/notebooklm_cli.py

@@ -61,6 +61,7 @@
 
 # Import command groups from cli package
 from .cli import (
+    agent,
     artifact,
     download,
     generate,
@@ -135,6 +136,7 @@ def cli(ctx, storage, verbose):
 # Register command groups (subcommand style)
 cli.add_command(source)
 cli.add_command(artifact)
+cli.add_command(agent)
 cli.add_command(generate)
 cli.add_command(download)
 cli.add_command(note)

tests/unit/cli/test_agent.py

@@ -0,0 +1,67 @@
+"""Tests for agent CLI commands."""
+
+from unittest.mock import patch
+
+import pytest
+from click.testing import CliRunner
+
+from notebooklm.notebooklm_cli import cli
+
+from .conftest import get_cli_module
+
+agent_module = get_cli_module("agent")
+agent_templates_module = get_cli_module("agent_templates")
+
+
+@pytest.fixture
+def runner():
+    return CliRunner()
+
+
+class TestAgentShow:
+    """Tests for agent show command."""
+
+    def test_agent_show_codex_displays_content(self, runner):
+        """Test that agent show codex displays the bundled instructions."""
+        with patch.object(
+            agent_module, "get_agent_source_content", return_value="# Repository Guidelines"
+        ):
+            result = runner.invoke(cli, ["agent", "show", "codex"])
+
+        assert result.exit_code == 0
+        assert "Repository Guidelines" in result.output
+
+    def test_agent_show_claude_displays_content(self, runner):
+        """Test that agent show claude displays the bundled instructions."""
+        with patch.object(agent_module, "get_agent_source_content", return_value="# Claude Skill"):
+            result = runner.invoke(cli, ["agent", "show", "claude"])
+
+        assert result.exit_code == 0
+        assert "Claude Skill" in result.output
+
+    def test_agent_show_missing_content_returns_error(self, runner):
+        """Test error when bundled agent instructions are missing."""
+        with patch.object(agent_module, "get_agent_source_content", return_value=None):
+            result = runner.invoke(cli, ["agent", "show", "codex"])
+
+        assert result.exit_code == 1
+        assert "not found" in result.output.lower()
+
+
+class TestAgentTemplates:
+    """Tests for bundled agent template loading."""
+
+    def test_codex_template_falls_back_to_package_data(self, tmp_path):
+        """Test that codex content falls back to packaged data outside repo root."""
+        with patch.object(agent_templates_module, "REPO_ROOT_AGENTS", tmp_path / "AGENTS.md"):
+            content = agent_templates_module.get_agent_source_content("codex")
+
+        assert content is not None
+        assert "Repository Guidelines" in content
+
+    def test_claude_template_reads_package_data(self):
+        """Test that claude content reads from packaged skill data."""
+        content = agent_templates_module.get_agent_source_content("claude")
+
+        assert content is not None
+        assert "NotebookLM Automation" in content