From d12b0980692dfa37274e48c482b67ea4ca51062a Mon Sep 17 00:00:00 2001
From: Darren 'Tadgy' Austin <darren@afterdark.org.uk>
Date: Wed, 22 Apr 2026 19:07:52 +0100
Subject: [PATCH] Add tlog-session-list script.

---
 tlog-session-list | 52 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100755 tlog-session-list

diff --git a/tlog-session-list b/tlog-session-list
new file mode 100755
index 0000000..60bdf98
--- /dev/null
+++ b/tlog-session-list
@@ -0,0 +1,52 @@
+#!/usr/bin/env python3
+
+import sys
+import json
+import datetime
+import argparse
+
+def format_timestamp(ts):
+    return datetime.datetime.fromtimestamp(ts).strftime('%Y-%m-%d %H:%M:%S')
+
+def main():
+    parser = argparse.ArgumentParser(description="List Tlog session metadata")
+    parser.add_argument("file", help="Path to the tlog session JSON file")
+    parser.add_argument("--user", help="Filter by username")
+    args = parser.parse_args()
+
+    sessions = {}
+
+    with open(args.file, 'r') as f:
+        for line in f:
+            try:
+                record = json.loads(line)
+                rec_id = record.get('rec')
+                user = record.get('user', 'unknown')
+
+                if not rec_id:
+                    continue
+
+                if args.user and user != args.user:
+                    continue
+
+                if rec_id not in sessions:
+                    timestamp = record.get('time', 0)
+                    sessions[rec_id] = {
+                        'time': timestamp,
+                        'formatted_time': format_timestamp(timestamp),
+                        'rec': rec_id,
+                        'host': record.get('host', 'unknown'),
+                        'user': user
+                    }
+            except json.JSONDecodeError:
+                continue  # skip bad lines
+
+    sorted_sessions = sorted(sessions.values(), key=lambda s: s['time'], reverse=True)
+
+    print(f"{'Time':<20} | {'Session ID':<50} | {'Hostname':<25} | {'User'}")
+    print('-' * 120)
+    for sess in sorted_sessions:
+        print(f"{sess['formatted_time']:<20} | {sess['rec']:<50} | {sess['host']:<25} | {sess['user']}")
+
+if __name__ == "__main__":
+    main()