clicodelog 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

clicodelog/__init__.py

@@ -2,5 +2,5 @@
 CLI Code Log - Browse, inspect, and export logs from CLI-based AI coding agents.
 """
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 __author__ = "monk1337"

clicodelog/app.py

@@ -1,20 +1,21 @@
+#!/usr/bin/env python3
 """
-cli code log
-A web app to browse, inspect, and export logs from CLI-based AI coding agents.
-Data is copied from source directories to ~/.clicodelog/data/ for backup and local use.
+AI Conversation History Viewer
+A web app to browse and view Claude Code, OpenAI Codex, and Google Gemini conversation history.
+Data is copied from source directories to ./data/ for backup and local use.
 Background sync runs every hour to keep data updated.
 """
 
-import base64
 import json
 import os
 import shutil
+import signal
+import subprocess
 import threading
 import time
 from datetime import datetime
 from pathlib import Path
-
-from flask import Flask, Response, jsonify, render_template, request
+from flask import Flask, render_template, jsonify, request
 from flask_cors import CORS
 
 # Package directory for templates
@@ -51,13 +52,9 @@ sync_lock = threading.Lock()
 last_sync_time = {}  # Track per-source sync times
 current_source = "claude-code"  # Default source
 
-# Create Flask app with template folder from package
-app = Flask(__name__, template_folder=str(PACKAGE_DIR / "templates"))
-CORS(app)
-
 
 def sync_data(source_id=None, silent=False):
-    """Copy data from source directory to data dir for backup."""
+    """Copy data from source directory to ./data/{source}/ for backup."""
     global last_sync_time
 
     if source_id is None:
@@ -79,7 +76,7 @@ def sync_data(source_id=None, silent=False):
             return False
 
         # Create data directory if it doesn't exist
-        DATA_DIR.mkdir(parents=True, exist_ok=True)
+        DATA_DIR.mkdir(exist_ok=True)
 
         # Copy source directory
         if not silent:
@@ -156,11 +153,13 @@ def background_sync():
 
 def encode_path_id(path):
     """Encode a path as a safe ID using base64."""
+    import base64
     return base64.urlsafe_b64encode(path.encode()).decode().rstrip('=')
 
 
 def decode_path_id(encoded_id):
     """Decode a base64-encoded path ID."""
+    import base64
     # Add back padding if needed
     padding = 4 - len(encoded_id) % 4
     if padding != 4:
@@ -577,11 +576,18 @@ def parse_codex_conversation(session_file, session_id):
 
                     elif payload_type == "reasoning":
                         # Reasoning/thinking block
-                        summary_parts = payload.get("summary", [])
                         thinking_text = ""
-                        for part in summary_parts:
-                            if isinstance(part, dict) and part.get("type") == "summary_text":
-                                thinking_text += part.get("text", "") + "\n"
+                        
+                        # Check if content is encrypted
+                        if payload.get("encrypted_content"):
+                            thinking_text = "[Reasoning content is encrypted and cannot be displayed]\n\nOpenAI Codex encrypts extended thinking for privacy. The model used reasoning here, but the content is not accessible in the logs."
+                        else:
+                            # Try to extract from summary (unencrypted format)
+                            summary_parts = payload.get("summary", [])
+                            for part in summary_parts:
+                                if isinstance(part, dict) and part.get("type") == "summary_text":
+                                    thinking_text += part.get("text", "") + "\n"
+                        
                         if thinking_text:
                             messages.append({
                                 "role": "assistant",
@@ -711,6 +717,11 @@ def parse_gemini_conversation(session_file, session_id):
     }
 
 
+# Create Flask app
+app = Flask(__name__, template_folder=str(PACKAGE_DIR / "templates"))
+CORS(app)
+
+
 @app.route('/')
 def index():
     return render_template('index.html')
@@ -851,7 +862,7 @@ def api_export(project_id, session_id):
     if conversation.get("summaries"):
         lines.append("SUMMARIES:")
         for s in conversation["summaries"]:
-            lines.append(f"  * {s}")
+            lines.append(f"  • {s}")
         lines.append("")
         lines.append("-" * 60)
         lines.append("")
@@ -901,6 +912,7 @@ def api_export(project_id, session_id):
 
     text_content = "\n".join(lines)
 
+    from flask import Response
     return Response(
         text_content,
         mimetype="text/plain",
@@ -938,27 +950,42 @@ def api_status():
     })
 
 
-def find_available_port(host, start_port, max_attempts=100):
-    """Find an available port starting from start_port."""
-    import socket
-
-    for port in range(start_port, start_port + max_attempts):
-        try:
-            with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
-                s.bind((host, port))
-                return port
-        except OSError:
-            continue
-    raise RuntimeError(f"Could not find an available port in range {start_port}-{start_port + max_attempts}")
-
+def kill_process_on_port(port):
+    """Kill any process running on the specified port."""
+    try:
+        # Find process ID on the port
+        result = subprocess.run(
+            ["lsof", "-ti", f":{port}"],
+            capture_output=True,
+            text=True
+        )
+        if result.returncode == 0 and result.stdout.strip():
+            pid = result.stdout.strip()
+            print(f"⚠️  Port {port} is in use by process {pid}")
+            print(f"🔄 Killing process {pid}...")
+            try:
+                os.kill(int(pid), signal.SIGTERM)
+                time.sleep(0.5)  # Give it a moment to terminate
+                print(f"✓ Process killed successfully")
+            except ProcessLookupError:
+                pass  # Process already gone
+            except Exception as e:
+                print(f"Warning: Could not kill process: {e}")
+    except FileNotFoundError:
+        # lsof not available (not on Unix-like system)
+        pass
+    except Exception as e:
+        print(f"Warning: Could not check port: {e}")
 
-def run_server(host="127.0.0.1", port=5050, skip_sync=False, debug=False):
-    """Run the Flask server."""
-    from clicodelog import __version__
 
+def run_server(host="127.0.0.1", port=6126, skip_sync=False, debug=False):
+    """Run the Flask development server."""
     print("=" * 60)
-    print(f"cli code log v{__version__}")
+    print("CLI Code Log - AI Conversation History Viewer")
     print("=" * 60)
+    
+    # Kill any process on the port
+    kill_process_on_port(port)
 
     if not skip_sync:
         # Sync data from all sources
@@ -969,28 +996,24 @@ def run_server(host="127.0.0.1", port=5050, skip_sync=False, debug=False):
             print(f"  Backup: {DATA_DIR / config['data_subdir']}")
 
             if sync_data(source_id=source_id):
-                print("  Sync completed!")
+                print(f"  ✓ Sync completed!")
             else:
-                print("  Warning: Could not sync. Using existing local data if available.")
-
-        # Start background sync thread
-        print(f"\nBackground sync: Every {SYNC_INTERVAL // 3600} hour(s)")
-        sync_thread = threading.Thread(target=background_sync, daemon=True)
-        sync_thread.start()
-        print("Background sync thread started.")
+                print(f"  ⚠ Warning: Could not sync. Using existing local data if available.")
     else:
         print("\nSkipping initial sync (--no-sync flag)")
 
-    # Find available port
-    actual_port = find_available_port(host, port)
-    if actual_port != port:
-        print(f"\nPort {port} is busy, using port {actual_port} instead")
+    # Start background sync thread
+    print(f"\nBackground sync: Every {SYNC_INTERVAL // 3600} hour(s)")
+    sync_thread = threading.Thread(target=background_sync, daemon=True)
+    sync_thread.start()
+    print("Background sync thread started.")
 
     print(f"\nStarting server...")
-    print(f"Open http://{host}:{actual_port} in your browser")
+    print(f"Open http://{host}:{port} in your browser")
     print("=" * 60)
-    app.run(host=host, port=actual_port, debug=debug, use_reloader=False)
+    app.run(host=host, port=port, debug=debug, use_reloader=False)
 
 
 if __name__ == '__main__':
-    run_server()
+    # For direct execution
+    run_server(debug=True)

clicodelog/cli.py

@@ -19,8 +19,8 @@ def main():
     parser.add_argument(
         "--port", "-p",
         type=int,
-        default=5050,
-        help="Port to run the server on (default: 5050)",
+        default=6126,
+        help="Port to run the server on (default: 6126)",
     )
     parser.add_argument(
         "--host", "-H",

{clicodelog-0.1.0.dist-info → clicodelog-0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clicodelog
-Version: 0.1.0
+Version: 0.2.0
 Summary: A lightweight, local-first web app to browse, inspect, and export logs from CLI-based AI coding agents
 Author: monk1337
 License-Expression: MIT
@@ -34,7 +34,10 @@ Requires-Dist: twine; extra == "dev"
 Dynamic: license-file
 
 <div align="center">
-<h1>cli code log</h1>
+  <div align="center">
+<img width="220px" src="https://raw.githubusercontent.com/monk1337/clicodelog/refs/heads/main/screenshots/logo.png">
+</div>
+
 <p>
 A lightweight, local-first web app to browse, inspect, and export logs from
 CLI-based AI coding agents — Claude Code, OpenAI Codex, and Gemini CLI.
@@ -58,10 +61,92 @@ CLI-based AI coding agents — Claude Code, OpenAI Codex, and Gemini CLI.
 </p>
 </div>
 
-![Gemini CLI Screenshot](screenshots/dark.png)
+<!-- <div align="center">
+<table>
+<tr>
+<td align="center">
+<img src="screenshots/claude.png" width="80" alt="Claude Code"><br>
+<sub><b>Claude Code</b></sub>
+</td>
+<td align="center">
+<img src="screenshots/codex.png" width="80" alt="OpenAI Codex"><br>
+<sub><b>OpenAI Codex</b></sub>
+</td>
+<td align="center">
+<img src="screenshots/gemini.png" width="80" alt="Gemini CLI"><br>
+<sub><b>Gemini CLI</b></sub>
+</td>
+</tr>
+</table>
+</div> -->
 
 ---
 
+## Installation
+
+### Via uv (Recommended)
+
+[uv](https://github.com/astral-sh/uv) is a fast Python package installer. Install it first if you haven't:
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+Then install clicodelog:
+
+```bash
+uv pip install clicodelog
+```
+
+### Via pip
+
+```bash
+pip install clicodelog
+```
+
+### From source
+
+```bash
+git clone https://github.com/monk1337/clicodelog.git
+cd clicodelog
+uv pip install -e .
+# or with pip:
+pip install -e .
+```
+
+---
+
+## Usage
+
+After installation, simply run:
+
+```bash
+clicodelog
+```
+
+The app will:
+- Auto-kill any process on port **6126** (if occupied)
+- Sync data from all AI coding agent sources
+- Start a web server at **http://localhost:6126**
+
+### Command Options
+
+```bash
+clicodelog --help               # Show all options
+clicodelog --port 8080          # Use custom port
+clicodelog --host 0.0.0.0       # Bind to all interfaces
+clicodelog --no-sync            # Skip initial data sync
+clicodelog --debug              # Run in debug mode
+```
+
+### Alternative: Run from source
+
+```bash
+git clone https://github.com/monk1337/clicodelog.git
+cd clicodelog
+python -m clicodelog.cli
+```
+
 ## Features
 
 - **Multi-source support** — View logs from Claude Code, OpenAI Codex, and Gemini CLI
@@ -104,56 +189,18 @@ CLI-based AI coding agents — Claude Code, OpenAI Codex, and Gemini CLI.
 
 ---
 
-## Installation
-
-### Via pip (Recommended)
-
-```bash
-pip install clicodelog
-```
-
-### From source
-
-```bash
-git clone https://github.com/monk1337/clicodelog.git
-cd clicodelog
-pip install -e .
-```
-
----
-
-## Usage
-
-If installed via pip:
-
-```bash
-clicodelog
-```
-
-Or run directly from source:
-
-```bash
-./run.sh
-```
-
-Or manually:
+### CLI Options
 
 ```bash
-pip install -r requirements.txt
-python app.py
+clicodelog --help               # Show help message
+clicodelog --version            # Show version
+clicodelog --port 8080          # Run on custom port (default: 6126)
+clicodelog --host 0.0.0.0       # Bind to all interfaces (default: 127.0.0.1)
+clicodelog --no-sync            # Skip initial data sync
+clicodelog --debug              # Run in debug mode
 ```
 
-Open http://localhost:5050 in your browser.
-
-### CLI Options
-
-```
-clicodelog --help
-clicodelog --port 8080        # Run on custom port
-clicodelog --host 0.0.0.0     # Bind to all interfaces
-clicodelog --no-sync          # Skip initial data sync
-clicodelog --debug            # Run in debug mode
-```
+**Note:** The app automatically kills any process running on the specified port before starting.
 
 ---
 
@@ -289,17 +336,3 @@ MIT
 </div>
 
 ```
-
-@misc{clicodelog2026,
-  title = {clicodelog: Browse, inspect CLI-based AI coding agents},
-  author = {Pal, Ankit},
-  year = {2026},
-  howpublished = {\url{https://github.com/monk1337/clicodelog}},
-  note = {A lightweight, local-first web app to browse, inspect, and export logs from CLI-based AI coding agents — Claude Code, OpenAI Codex, and Gemini CLI.}
-}
-
-```
-
-## 💁 Contributing
-
-Welcome any contributions to open source project, including new features, improvements to infrastructure, and more comprehensive documentation. 

clicodelog-0.2.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+clicodelog/__init__.py,sha256=qs3bijM7cWYmV4ckBeuZd5dLhViUzuaUal4AoJUT_io,136
+clicodelog/__main__.py,sha256=JDb49rUInCUlT5Ya0aGfusfJm8e7wGqA447mrnVqDkA,119
+clicodelog/app.py,sha256=iHoeIK3IVQtTpm-CjqJO_Tn5L8krUeoOUfSdeqGAJK4,38870
+clicodelog/cli.py,sha256=c34P5fOpE5Hy_DJog52BGO4ab4cUBRZZTsW5nxaFUL4,1297
+clicodelog/templates/index.html,sha256=kUYQJivjWOLonREjinUsIHvgiGUHbhuJvlLWyjIst9Y,34392
+clicodelog-0.2.0.dist-info/licenses/LICENSE,sha256=enO5ZtMm5_HoQnB9jA_d3CCajd9I6Kzg-m1FmNCsAvk,1065
+clicodelog-0.2.0.dist-info/METADATA,sha256=6vj1ryFe10ijvIWqaLtLSQfPB1qk8EqTIQGWWA9caaM,8993
+clicodelog-0.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+clicodelog-0.2.0.dist-info/entry_points.txt,sha256=6Zodty_o0mVbDoIcNPQ31aI-P-KLZ0Xr_qsfrQkDYck,51
+clicodelog-0.2.0.dist-info/top_level.txt,sha256=YvkoZJtBm4QSRL2YlLr5TeVILsiptIF7D43i29RG5oc,11
+clicodelog-0.2.0.dist-info/RECORD,,

{clicodelog-0.1.0.dist-info → clicodelog-0.2.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.10.1)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

clicodelog-0.1.0.dist-info/RECORD

@@ -1,11 +0,0 @@
-clicodelog/__init__.py,sha256=HYMXrxX39PPodu0qTmWqbgTr09RLzUtl3QNFDQCz_r4,136
-clicodelog/__main__.py,sha256=JDb49rUInCUlT5Ya0aGfusfJm8e7wGqA447mrnVqDkA,119
-clicodelog/app.py,sha256=W-7mQSwcB5N69ZEYhdOkg-fs93wxR4XccPAQ2H1GKO8,37823
-clicodelog/cli.py,sha256=mH_fjEVg2RovP2sPpZPOyIzejnLcvaqi0hf41Xnxnao,1297
-clicodelog/templates/index.html,sha256=kUYQJivjWOLonREjinUsIHvgiGUHbhuJvlLWyjIst9Y,34392
-clicodelog-0.1.0.dist-info/licenses/LICENSE,sha256=enO5ZtMm5_HoQnB9jA_d3CCajd9I6Kzg-m1FmNCsAvk,1065
-clicodelog-0.1.0.dist-info/METADATA,sha256=fVvrn6ehZcS2z3CD_5E64vNVZwR6O6cSaYi1jNWkxNM,8058
-clicodelog-0.1.0.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-clicodelog-0.1.0.dist-info/entry_points.txt,sha256=6Zodty_o0mVbDoIcNPQ31aI-P-KLZ0Xr_qsfrQkDYck,51
-clicodelog-0.1.0.dist-info/top_level.txt,sha256=YvkoZJtBm4QSRL2YlLr5TeVILsiptIF7D43i29RG5oc,11
-clicodelog-0.1.0.dist-info/RECORD,,