--open option to open directly in browser

https://gistpreview.github.io/?323133f9d9abb6a61930a70e637c9d5e

Author: simonw

README.md

@@ -27,6 +27,16 @@ When using [Claude Code for web](https://claude.ai/code) you can export your ses
 
 This tool converts that JSON into a browseable multi-page HTML transcript.
 
+The quickest way to view a recent session is to import it directly and open in your browser:
+
+```bash
+claude-code-publish import --open
+```
+
+This shows an interactive picker to select a session, generates HTML, and opens it in your default browser.
+
+For a local session file:
+
 ```bash
 claude-code-publish session.json -o output-directory/
 ```
@@ -39,6 +49,7 @@ This will generate:
 
 - `-o, --output DIRECTORY` - output directory (default: current directory)
 - `--repo OWNER/NAME` - GitHub repo for commit links (auto-detected from git push output if not specified)
+- `--open` - open the generated `index.html` in your default browser
 - `--gist` - upload the generated HTML files to a GitHub Gist and output a preview URL
 - `--json` - include the original JSON session file in the output directory
 

src/claude_code_publish/__init__.py

@@ -8,6 +8,7 @@
 import shutil
 import subprocess
 import tempfile
+import webbrowser
 from pathlib import Path
 
 import click
@@ -931,7 +932,7 @@ def cli():
     "-o",
     "--output",
     type=click.Path(),
-    help="Output directory (default: current directory, or temp dir with --gist)",
+    help="Output directory (default: current directory, or temp dir with --gist/--open)",
 )
 @click.option(
     "--repo",
@@ -948,10 +949,16 @@ def cli():
     is_flag=True,
     help="Include the original JSON session file in the output directory.",
 )
-def session(json_file, output, repo, gist, include_json):
+@click.option(
+    "--open",
+    "open_browser",
+    is_flag=True,
+    help="Open the generated index.html in your default browser.",
+)
+def session(json_file, output, repo, gist, include_json, open_browser):
     """Convert a Claude Code session JSON file to HTML."""
     # Determine output directory
-    if gist and output is None:
+    if (gist or open_browser) and output is None:
         # Extract session ID from JSON file for temp directory name
         with open(json_file, "r") as f:
             data = json.load(f)
@@ -982,6 +989,10 @@ def session(json_file, output, repo, gist, include_json):
         click.echo(f"Preview: {preview_url}")
         click.echo(f"Files: {output}")
 
+    if open_browser:
+        index_url = (output / "index.html").resolve().as_uri()
+        webbrowser.open(index_url)
+
 
 def resolve_credentials(token, org_uuid):
     """Resolve token and org_uuid from arguments or auto-detect.
@@ -1256,7 +1267,7 @@ def generate_html_from_session_data(session_data, output_dir, github_repo=None):
     "-o",
     "--output",
     type=click.Path(),
-    help="Output directory (default: creates folder with session ID, or temp dir with --gist)",
+    help="Output directory (default: creates folder with session ID, or temp dir with --gist/--open)",
 )
 @click.option("--token", help="API access token (auto-detected from keychain on macOS)")
 @click.option(
@@ -1277,7 +1288,15 @@ def generate_html_from_session_data(session_data, output_dir, github_repo=None):
     is_flag=True,
     help="Include the JSON session data in the output directory.",
 )
-def import_session(session_id, output, token, org_uuid, repo, gist, include_json):
+@click.option(
+    "--open",
+    "open_browser",
+    is_flag=True,
+    help="Open the generated index.html in your default browser.",
+)
+def import_session(
+    session_id, output, token, org_uuid, repo, gist, include_json, open_browser
+):
     """Import a session from the Claude API and convert to HTML.
 
     If SESSION_ID is not provided, displays an interactive picker to select a session.
@@ -1337,7 +1356,7 @@ def import_session(session_id, output, token, org_uuid, repo, gist, include_json
         raise click.ClickException(f"Network error: {e}")
 
     # Determine output directory
-    if gist and output is None:
+    if (gist or open_browser) and output is None:
         output = Path(tempfile.gettempdir()) / session_id
     elif output is None:
         output = session_id
@@ -1364,8 +1383,10 @@ def import_session(session_id, output, token, org_uuid, repo, gist, include_json
         click.echo(f"Gist: {gist_url}")
         click.echo(f"Preview: {preview_url}")
         click.echo(f"Files: {output}")
-    else:
-        click.echo(f"Done! Open {output}/index.html to view.")
+
+    if open_browser:
+        index_url = (output / "index.html").resolve().as_uri()
+        webbrowser.open(index_url)
 
 
 def main():

tests/test_generate_html.py

@@ -869,3 +869,79 @@ def mock_run(*args, **kwargs):
         assert "Creating GitHub gist" in result.output
         assert "gist.github.com" in result.output
         assert "gistpreview.github.io" in result.output
+
+
+class TestOpenOption:
+    """Tests for the --open option."""
+
+    def test_session_open_calls_webbrowser(self, output_dir, monkeypatch):
+        """Test that session --open opens the browser."""
+        from click.testing import CliRunner
+        from claude_code_publish import cli
+
+        fixture_path = Path(__file__).parent / "sample_session.json"
+
+        # Track webbrowser.open calls
+        opened_urls = []
+
+        def mock_open(url):
+            opened_urls.append(url)
+            return True
+
+        monkeypatch.setattr("claude_code_publish.webbrowser.open", mock_open)
+
+        runner = CliRunner()
+        result = runner.invoke(
+            cli,
+            ["session", str(fixture_path), "-o", str(output_dir), "--open"],
+        )
+
+        assert result.exit_code == 0
+        assert len(opened_urls) == 1
+        assert "index.html" in opened_urls[0]
+        assert opened_urls[0].startswith("file://")
+
+    def test_import_open_calls_webbrowser(self, httpx_mock, output_dir, monkeypatch):
+        """Test that import --open opens the browser."""
+        from click.testing import CliRunner
+        from claude_code_publish import cli
+
+        # Load sample session to mock API response
+        fixture_path = Path(__file__).parent / "sample_session.json"
+        with open(fixture_path) as f:
+            session_data = json.load(f)
+
+        httpx_mock.add_response(
+            url="https://api.anthropic.com/v1/session_ingress/session/test-session-id",
+            json=session_data,
+        )
+
+        # Track webbrowser.open calls
+        opened_urls = []
+
+        def mock_open(url):
+            opened_urls.append(url)
+            return True
+
+        monkeypatch.setattr("claude_code_publish.webbrowser.open", mock_open)
+
+        runner = CliRunner()
+        result = runner.invoke(
+            cli,
+            [
+                "import",
+                "test-session-id",
+                "--token",
+                "test-token",
+                "--org-uuid",
+                "test-org",
+                "-o",
+                str(output_dir),
+                "--open",
+            ],
+        )
+
+        assert result.exit_code == 0
+        assert len(opened_urls) == 1
+        assert "index.html" in opened_urls[0]
+        assert opened_urls[0].startswith("file://")