Mine Claude Code sessions — timeline, gaps, repo attribution, session history.

MITAuto-check passed

Install Dig

skills CLI
$ npx skills add Soul-Brews-Studio/arra-oracle-skills-cli --skill dig -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Soul-Brews-Studio/arra-oracle-skills-cli dig --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Soul-Brews-Studio/arra-oracle-skills-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dig .claude/skills/dig && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dig
GitHub stars
123
Token cost
~1.8k tokens
SKILL.md length
480 words
Files
3 (incl. scripts)
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

Mine Claude Code sessions — timeline, gaps, repo attribution, session history.

  • Works in 3 steps: Timestamp → Extract Session Data → Display Timeline
  • What did I work on
  • SKILL.md covers Usage, Step 0: Timestamp, Step 2: Extract Session Data and Step 3: Display Timeline, plus 2 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Dig is an agent skill from Soul-Brews-Studio/arra-oracle-skills-cli. Mine Claude Code sessions — timeline, gaps, repo attribution, session history. Use when user says "dig", "sessions", "past sessions", "timeline", "what did I work on", or wants to see session history. Do NOT trigger for finding code/projects (use /trace), exploring repos (use /learn), or current session status (use /recap).

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `DEEP.md` and `scripts/dig.py`).

The repository describes itself as: Install Oracle skills to Claude Code, OpenCode, Cursor, and 12+ AI coding agents. The licence is MIT.

When your agent uses it

  • What did I work on
  • Wants to see session history
  • Finding code/projects (use /trace)
  • Exploring repos (use /learn)

Example prompts

  • “sessions”
  • “past sessions”
  • “timeline”
  • “/dig”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Timestamp
  2. Extract Session Data
  3. Display Timeline

What it can do on your machine

Read from SKILL.md and the folder at commit 9feea09. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dig loads about 1.8k tokens when it runs. Until then it costs about 82 tokens; SKILL.md has 480 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~82
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Soul-Brews-Studio/arra-oracle-skills-cli at commit 9feea09, republished under its MIT licence (© Soul-Brews-Studio). 480 words, ~1,822 tokens.

Download SKILL.mdSave it as .claude/skills/dig/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
dig
description
Mine Claude Code sessions — timeline, gaps, repo attribution, session history. Use when user says "dig", "sessions", "past sessions", "timeline", "what did I work on", or wants to see session history. Do NOT trigger for finding code/projects (use /trace), exploring repos (use /learn), or current session status (use /recap).
argument-hint
[N] | --all | --timeline | --deep

/dig - Session Goldminer v2

Mine Claude Code session data for timelines, gaps, and repo attribution. No query needed.

Usage

/dig                    # Current repo, 10 most recent
/dig [N]                # Current repo, N most recent
/dig --all              # All repos, ALL sessions (auto-detect count)
/dig --all [N]          # All repos, N most recent
/dig --deep             # Deep scan — ALL .jsonl files (not just most-recent per project)
/dig --deep [N]         # Deep scan, N most recent
/dig --all --deep       # All repos, deep scan — full coverage
/dig --timeline         # Day-by-day grouped (current repo)
/dig --all --timeline   # Day-by-day grouped (all repos, ALL sessions)
Deep Mode (#216)

Standard /dig deduplicates by session basename — only showing the most recent file per session. This misses historical sessions, subagent sessions, and worktree sessions.

--deep scans ALL .jsonl files across all project directories. Output includes extra fields:

  • toolCalls — number of tool invocations in the session
  • fileSizeKB — session file size in KB
  • Coverage metadata: "X of Y sessions" showing how many were returned vs found
Timezone (#214)

dig.py v2 auto-detects timezone instead of hardcoding GMT+7:

  1. MAW_DISPLAY_TZ env var (e.g., Asia/Bangkok, 7, America/New_York)
  2. TZ env var
  3. System timezone
  4. Fallback: UTC

Output metadata includes detected timezone name and offset.

Step 0: Timestamp

bash
date "+🕐 %H:%M %Z (%A %d %B %Y)"
ENCODED_PWD=$(pwd | sed 's|^/|-|; s|[/.]|-|g')
PROJECT_BASE=$(ls -d "$HOME/.claude/projects/${ENCODED_PWD}" 2>/dev/null | head -1)
export PROJECT_DIRS="$PROJECT_BASE"

# Strip -wt* suffix to find parent project dir
PARENT_ENCODED=$(echo "$ENCODED_PWD" | sed 's/-wt-[^/]*$//')
if [ "$PARENT_ENCODED" != "$ENCODED_PWD" ]; then
  PARENT_BASE=$(ls -d "$HOME/.claude/projects/${PARENT_ENCODED}" 2>/dev/null | head -1)
  [ -n "$PARENT_BASE" ] && export PROJECT_DIRS="$PROJECT_DIRS:$PARENT_BASE"
fi

# nullglob-safe worktree scan (both parent and self)
for base in "$PROJECT_BASE" "$PARENT_BASE"; do
  [ -z "$base" ] && continue
  for wt in "$base"-wt-*(N); do  # (N) = zsh nullglob qualifier
    [ -d "$wt" ] && export PROJECT_DIRS="$PROJECT_DIRS:$wt"
  done
done

Encodes pwd the same way Claude does (replace / and . with -, prepend -) to match the .claude/projects/ directory naming (e.g. github.com → github-com). Detects parent project from worktree dirs (strips -wt-* suffix) and includes both parent and self worktrees. The (N) qualifier prevents zsh crashes when no worktrees exist.

With --all (all repos):

bash
export PROJECT_DIRS=$(ls -d "$HOME/.claude/projects/"*/ | tr '\n' ':')

Step 2: Extract Session Data

Run the dig script. Pass 0 for --all (no limit), or N if user specified a count, default 10:

bash
python3 ~/.claude/skills/dig/scripts/dig.py [N] [--deep]
# N=10 (default), N=0 (scan all sessions), N=50 (50 most recent)
# --deep: scan ALL .jsonl files (not just most-recent per basename)
Deep Mode Display

When --deep is used, add extra columns to the table:

markdown
| # | Date | Session | Min | Repo | Msgs | Tools | Size | Focus |

And show coverage in the footer:

markdown
**Coverage**: [returned]/[found] sessions | **Timezone**: [tz_name] (GMT+[offset])

Step 3: Display Timeline

Read the JSON output and display as a table. Sessions are chronological (oldest first). Gap rows (type: "gap") span the session column with · · · prefix:

markdown
## Session Timeline

| # | Date | Session | Min | Repo | Msgs | Focus |
|---|------|---------|-----|------|------|-------|
|   |      | · · · sleeping / offline | | | | |
| 1 | 02-21 | 08:40–09:08 | 28m | oracle-skills-cli | 5 | Wire /rrr to read pulse data |
|   |      | · · · 45m gap | | | | |
| 2 | 02-21 | 09:55–10:23 | 28m | homelab | 3 | oracle-pulse birth + CLI flag |
|   |      | · · · no session yet | | | | |

**Dirs scanned**: [list PROJECT_DIRS]
**Total sessions found**: [count]

Column rendering rules:

  • Gap rows: | | | · · · [label] | | | | | — number + date empty, label in Session col
  • Date: MM-DD short format (strip year)
  • Session: HH:MM–HH:MM using startGMT7 and endGMT7 (strip date, keep time only)
  • Min: [durationMin]m
  • Repo: use repoName field from dig.py output (resolved via ghq)
  • Msgs: realHumanMessages count

"Msgs" = real typed human messages (not tool approvals).


Show full SKILL.md (182 more words)Show less

With --timeline: Group by Date

When --timeline flag is present, group sessions by date instead of a flat table. Use --all to see all repos (recommended for timeline).

Step 1: Run dig.py with 0 for --all (scans all sessions), or user-specified count

Step 2: Group sessions by date from startGMT7. Render each day as:

markdown
## Feb 22 (Sun) — [vibe label]

                  · · ·   sleeping / offline
08:48–09:11    23m   homelab        Update Fleet Runbook + Explore black.local
09:11–11:30   139m   homelab        Set Up KVM OpenClaw Node on black.local
09:37–12:51   194m   Nat-s-Agents   /recap → supergateway → CF ZT → arra-oracle-v3 dig
                  · · ·   45m gap
12:51–13:03    12m   Nat-s-Agents   Dig All + Design arra-oracle-v3 ← current
                  · · ·   no session yet

## Feb 21 (Sat) — Long day: Fleet + Brewing + Skills

06:19–08:38   139m   homelab        Moltworker Gateway + MBP Node
08:40           (bg)  openclaw       ClawHub Build Script (idle long)
09:23–16:08   405m   homelab        Debug MBP Node 401 — Gateway Token Auth

Rendering rules:

  • Day header: ## MMM DD (Day) — [vibe label] — infer vibe from session summaries (e.g. "Infrastructure Day", "Brewing + Skills")
  • Session rows: HH:MM–HH:MM [N]m REPO Summary — use repoName for repo, summary for focus
  • Gap rows: · · · [label] between sessions when gap > 30 min
  • Sidechain: prefix (bg) for sessions with isSidechain: true
  • Current: append ← current marker on the last session of the current day (today only)
  • Sort: days newest-first, sessions within each day oldest-first (chronological)
  • Date format: startGMT7 time portion only (HH:MM), endGMT7 time portion (HH:MM)
  • Repo width: pad repo names to align columns

Step 3: Show summary footer:

markdown
**Days**: [count] | **Sessions**: [count] | **Total time**: [sum of durationMin]m

Trace Connection

After displaying the timeline, log the discovery to Oracle so it's searchable later:

arra_trace({
  query: "dig session [N]",
  project: "[repo-name]",
  foundFiles: [],
  foundCommits: [list of commit hashes from timeline],
  foundIssues: []
})

This connects /dig discoveries to /trace — "When did we first work on X?" becomes answerable.


ARGUMENTS: $ARGUMENTS

© Soul-Brews-Studio, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in skills/dig of Soul-Brews-Studio/arra-oracle-skills-cli.

  • SKILL.md
  • DEEP.md
  • scripts/dig.py

Open the folder on GitHubat commit 9feea09

Compare with similar skills

Dig next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dig compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dig this skillSoul-Brews-Studio/arra-oracle-skills-cli123—~1.8kAutomated safety check: PassMIT
Session History Timelinerohitg00/agentmemory29k—~465Automated safety check: PassApache-2.0
Session Timelinehoangsonww/Claude-Code-Agent-Monitor1.1k—~658Automated safety check: PassMIT
Session Handoffsickn33/agentic-awesome-skills47k—~1.8kAutomated safety check: NotesMIT
Sessionanthropics/claude-for-legal9.6k3 repos~478Automated safety check: PassApache-2.0
Session History Searchslopus/happy24k—~3.1kAutomated safety check: PassMIT

Similar skills

  • Session History Timeline

    rohitg00/agentmemory

    Shows a clean, reverse-chronological timeline of recent sessions on a project, using only the data a memory tool actually returned, never a remembered summary.

    29k GitHub stars~465 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Session Timeline

    hoangsonww/Claude-Code-Agent-Monitor

    Render an ordered timeline of one Claude Code session's events (every event type) with per-event durations and tool names, reconstructed from Agent Monitor data.

    1.1k GitHub stars~658 tokensUpdated today
    Auto-check passed
  • Session Handoff

    sickn33/agentic-awesome-skills

    A skill your agent uses when context approaches capacity, before /clear or /compact, when switching tasks, or when ending a coding session: produces a structured handoff artifact for the next session.

    47k GitHub stars~1.8k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Session

    anthropics/claude-for-legal

    Official

    Run a focused N-question study session on a subject — MBE, essay, or flashcards.

    9.6k GitHub starsUsed in 3 repos~478 tokens
    EducationAuto-check passed
  • Searches past Claude Code, Codex and Cursor sessions and summarizes what was worked on, tried or decided, using extraction scripts instead of reading raw logs.

    24k GitHub stars~3.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Session Handoff

    davila7/claude-code-templates

    Creates comprehensive handoff documents for seamless AI agent session transfers.

    32k GitHub starsUsed in 2 repos~1.6k tokens
    Agent WorkflowsAuto-check passed

More from Soul-Brews-Studio/arra-oracle-skills-cli

All 31 skills in this repo
  • Forward

    Soul-Brews-Studio/arra-oracle-skills-cli

    Hand off the current session to the next one. An agent skill from Soul-Brews-Studio/arra-oracle-skills-cli.

    123 GitHub stars~2.9k tokensUpdated 6 days ago
    Auto-check passed
  • Project

    Soul-Brews-Studio/arra-oracle-skills-cli

    Clone and track external repos. An agent skill from Soul-Brews-Studio/arra-oracle-skills-cli.

    123 GitHub stars~1.4k tokensUpdated 6 days ago
    Auto-check passed
  • Round Table

    Soul-Brews-Studio/arra-oracle-skills-cli

    Convene a Round Table (โต๊ะกลม): 3–8 souls — persona files, Oracles, or real people's DNA — debate ONE stakes-bearing decision over exactly 4 rounds (OPEN, DEEPEN, CONVERGE, VOTE), one subagent per…

    123 GitHub stars~2.1k tokensUpdated 6 days ago
    Auto-check passed
  • Soul

    Soul-Brews-Studio/arra-oracle-skills-cli

    Bring an Oracle into the current repo — its soul, ALL its skills and its expertise — by link, never by copy.

    123 GitHub stars~1.3k tokensUpdated 6 days ago
    Auto-check passed
  • Trace

    Soul-Brews-Studio/arra-oracle-skills-cli

    Find projects, code, and knowledge across git history, repos, docs, and Oracle.

    123 GitHub stars~2.9k tokensUpdated 6 days ago
    Auto-check passed
  • Recap

    Soul-Brews-Studio/arra-oracle-skills-cli

    Session orientation and awareness — retro summaries, handoffs, git state, focus.

    123 GitHub stars~2.7k tokensUpdated 6 days ago
    Auto-check passed

Questions about Dig

What does Dig do?

Mine Claude Code sessions — timeline, gaps, repo attribution, session history. Dig is an agent skill from Soul-Brews-Studio/arra-oracle-skills-cli. Mine Claude Code sessions — timeline, gaps, repo attribution, session history.

When should I use Dig?

Dig fits situations like: what did I work on; wants to see session history; finding code/projects (use /trace); exploring repos (use /learn).

How do I install Dig in Claude Code?

Run `npx skills add Soul-Brews-Studio/arra-oracle-skills-cli --skill dig -a claude-code`. Or copy the skill folder (skills/dig in Soul-Brews-Studio/arra-oracle-skills-cli) into .claude/skills/dig in your project. Claude Code loads it when a task matches its description.

How do I install Dig in Codex?

Run `npx skills add Soul-Brews-Studio/arra-oracle-skills-cli --skill dig -a codex`. Or copy the skill folder (skills/dig in Soul-Brews-Studio/arra-oracle-skills-cli) into .agents/skills/dig in your project. Codex loads it when a task matches its description.

Can I use Dig in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Soul-Brews-Studio/arra-oracle-skills-cli --skill dig -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dig, .gemini/skills/dig, .github/skills/dig and .opencode/skills/dig in your project.

What does Dig need to run?

Going by SKILL.md and its folder, Dig needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Dig access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Dig safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Dig use?

Dig is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dig use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dig?

Skills that share tags, products or a category with Dig: Session History Timeline (rohitg00/agentmemory, 29k stars), Session Timeline (hoangsonww/Claude-Code-Agent-Monitor, 1.1k stars), Session Handoff (sickn33/agentic-awesome-skills, 47k stars) and Session (anthropics/claude-for-legal, 9.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dig?

Soul-Brews-Studio (a GitHub organization) maintains it in Soul-Brews-Studio/arra-oracle-skills-cli, which has 123 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on October 3, 2026.

Source: Soul-Brews-Studio/arra-oracle-skills-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.