• Claude Code — JSONL logs auto-saved to

  ~/.claude/projects/

• GitHub Copilot CLI — JSONL logs auto-saved to

  ~/.copilot/session-state/*/events.jsonl

1. Current session — View the active session's transcript
2. Specific session — View a session by its ID
3. Agent output — View background task output files produced by subagents
4. All sessions — Browse all project sessions, with optional date-range filtering

Check if there are any sessions present

Note: GITHUB_TOKEN is intentionally excluded — it's too generic and

appears in non-Copilot CI contexts, causing false positives.

Default to claude-code — safe fallback (most users)

When both `~/.copilot/session-state/` and `~/.claude/projects/` exist with sessions,
offer the user a choice: "Found sessions for both Claude Code and GitHub Copilot CLI.
Which would you like to browse? [1] Claude Code  [2] GitHub Copilot CLI"

The user can always override with an explicit path.

TOOL_CONTEXT="claude-code"

1. Find the most recently modified JSONL file under

   ~/.claude/projects/

   :
   bash

   ls -t ~/.claude/projects/*/*.jsonl 2>/dev/null | head -1

2. Run:
   bash

   $CCL <path-to-jsonl> --format markdown

3. Display the Markdown output inline.

TOOL_CONTEXT="copilot"

1. Find the most recently modified session directory under

   ~/.copilot/session-state/

   :
   bash

   ls -dt ~/.copilot/session-state/*/ 2>/dev/null | head -1

2. Read its

   events.jsonl

   :
   bash

   LATEST_SESSION=$(ls -dt ~/.copilot/session-state/*/ 2>/dev/null | head -1)
   $CCL "${LATEST_SESSION}events.jsonl" --format markdown

3. Display the Markdown output inline.

undefined

TOOL_CONTEXT="claude-code"

1. Search for the JSONL file matching the session ID:
   bash

   find ~/.claude/projects -name "*.jsonl" | xargs grep -l "<SESSION_ID>" 2>/dev/null | head -1

   Or, if the ID looks like a filename fragment, use:
   bash

   ls ~/.claude/projects/*/ | grep "<SESSION_ID>"

2. Run:
   bash

   $CCL <path-to-jsonl> --format markdown

3. Display the output. If no file matches, report:

   No session found with ID: <SESSION_ID>
   Available sessions: run "view all sessions" to list them.

TOOL_CONTEXT="copilot"

1. The session ID is the directory name under

   ~/.copilot/session-state/

   . Check directly:
   bash

   SESSION_DIR="$HOME/.copilot/session-state/<SESSION_ID>"
   if [[ -d "$SESSION_DIR" ]]; then
     EVENTS_FILE="$SESSION_DIR/events.jsonl"
   fi

   If the full ID is not known, search for a partial match:
   bash

   ls -d ~/.copilot/session-state/*/ 2>/dev/null | grep "<SESSION_ID>"

2. Run:
   bash

   $CCL "$EVENTS_FILE" --format markdown

3. Display the output. If no directory matches, report:

   No Copilot session found with ID: <SESSION_ID>
   Available sessions: run "browse all sessions" to list them.

1. Find

   .log

   or

   .jsonl

   files created by background agent tasks. These are typically written to the current working directory or a temp path with a name matching

   .agent-step-*.log

   or similar:
   bash

   ls -t .agent-step-*.log 2>/dev/null
   ls -t /tmp/*.agent*.log 2>/dev/null

2. For each file found, run

   detect_log_format <file>

   to classify it:

   • jsonl

     → run

     $CCL <file> --format markdown

   • plain-log

     → display directly with

     cat

3. This ensures JSONL-formatted

   .log

   files (rare but possible) are rendered properly.
4. If no agent output files are found:

   No agent background task output files found in the current directory.
   Background agents write their output to files named .agent-step-<ID>.log.

TOOL_CONTEXT="claude-code"

1. List all JSONL files under

   ~/.claude/projects/

   :
   bash

   find ~/.claude/projects -name "*.jsonl" -printf "%T@ %p\n" 2>/dev/null \
     | sort -rn | awk '{print $2}'

2. For each file, extract the session date and first user message:
   bash

   $CCL <file> --format markdown --summary
   # If --summary flag is not supported, just show filename and date
   head -1 <file> | python3 -c "import sys,json; d=json.loads(sys.stdin.read()); print(d.get('timestamp',''))"

3. Print a summary table:

   Available Sessions (Claude Code)
   =================================
   #   Date                  Session ID / File
   1   2025-11-23 19:32:36   ~/.claude/projects/foo/abc123.jsonl
   2   2025-11-22 14:10:05   ~/.claude/projects/foo/def456.jsonl
   ...

4. Offer to open a specific session: "Enter a number to view that session."

TOOL_CONTEXT="copilot"

1. List all session directories under

   ~/.copilot/session-state/

   sorted by modification time:
   bash

   ls -dt ~/.copilot/session-state/*/ 2>/dev/null

2. For each session directory, read its

   events.jsonl

   to extract the timestamp:
   bash

   for session_dir in $(ls -dt ~/.copilot/session-state/*/); do
     session_id=$(basename "$session_dir")
     events_file="$session_dir/events.jsonl"
     if [[ -f "$events_file" ]]; then
       timestamp=$(head -1 "$events_file" | python3 -c \
         "import sys,json; d=json.loads(sys.stdin.read()); print(d.get('timestamp',''))" 2>/dev/null)
       echo "$timestamp  $session_id"
     fi
   done

3. Print a summary table:

   Available Sessions (GitHub Copilot CLI)
   ========================================
   #   Date                  Session ID
   1   2025-11-23 19:32:36   abc1234567890abcdef1234567890abcd
   2   2025-11-22 14:10:05   def4567890abcdef1234567890abcdef
   ...

4. Offer to open a specific session: "Enter a number to view that session."

~/.copilot/session-state/{session-id}/

• events.jsonl

  — JSONL session history (similar format to Claude Code logs)

• workspace.yaml

  — session metadata (working directory, session ID, etc.)

• plan.md

  — implementation plan for the session

• checkpoints/

  — compaction history (older event snapshots)

~/.copilot/history-session-state/

1. Locate the

   events.jsonl

   for the session:
   bash

   # Current session (most recent)
   LATEST_SESSION=$(ls -dt ~/.copilot/session-state/*/ 2>/dev/null | head -1)
   EVENTS_FILE="${LATEST_SESSION}events.jsonl"
   
   # Specific session by ID
   EVENTS_FILE="$HOME/.copilot/session-state/<SESSION_ID>/events.jsonl"

2. Run:
   bash

   $CCL "$EVENTS_FILE" --format markdown

3. Display the output inline.

events.jsonl

~/.copilot/session-state/{session-id}/events.jsonl

{"type":"user","message":{"role":"user","content":[{"type":"text","text":"..."}]},"timestamp":"...","sessionId":"..."}
{"type":"assistant","message":{"role":"assistant","content":[{"type":"text","text":"..."}]},"timestamp":"...","sessionId":"..."}

claude-code-log

• workspace.yaml

  — session metadata

• plan.md

  — implementation plan

• checkpoints/

  — compaction history (older snapshots)

~/.copilot/history-session-state/

• Thin wrapper: Delegates to

  claude-code-log

  for all JSONL (both Claude Code and Copilot)
• Graceful degradation: Clear error messages when tool is missing or no sessions found
• Single responsibility: Only views/converts transcripts, never modifies them
• No hidden state: All file paths are shown to the user

• Requires

  claude-code-log

  (npm) or

  npx

  to convert JSONL (both Claude Code and Copilot) to HTML/Markdown
• Cannot view transcripts from remote machines
• Date filtering relies on filesystem modification times, not session timestamps

• --summary

  flag availability depends on

  claude-code-log

  version
• Legacy Copilot sessions in

  ~/.copilot/history-session-state/

  are not auto-discovered (must use explicit path)
• When both Claude Code and Copilot sessions exist, the skill prompts the user to choose rather than merging them