file-history

Included with Lifetime

$97 forever

Use when looking for past work on specific FILES, understanding why code was written, or when user references "what we did before" on a file/feature. Uses file-history tracking for accurate results. PREFER THIS over episodic-memory for file-specific queries.

Data & Analytics

What this skill does


# File History Context

**Use this for FILE-SPECIFIC history queries. For general semantic search across all conversations, use episodic-memory instead.**

## When to Use This Skill

**USE file-history when:**
- Looking for sessions that edited a specific file
- Understanding why code was written a certain way
- User says "what did we do with [filename]"
- User asks about past changes to a component/module
- Refactoring and need to understand original intent
- Code seems unusual and you want the backstory

**DON'T use this when:**
- General conceptual questions across all projects → use episodic-memory
- No specific file/feature in mind → use episodic-memory
- Looking for patterns across unrelated conversations → use episodic-memory

## How to Use

Dispatch the `history-context` agent:

```
Task tool:
  description: "Find history for [file/feature]"
  prompt: "Find context for [specific file or feature]. Focus on [decisions/implementation/rationale]."
  subagent_type: "history-context"
```

**Example prompts:**
- "Find context for src/components/AuthForm.tsx"
- "What sessions worked on the caching implementation?"
- "Get history for the payment processing feature"

## What You Get Back

The agent will return:
- Summary of what was done and why
- Key decisions and rationale
- Implementation notes
- **Full session IDs** (UUIDs) for reference
- Session file paths for direct access

## Why This Works Better Than episodic-memory for Files

| Aspect | file-history | episodic-memory |
|--------|--------------|-----------------|
| Accuracy | Uses Claude's file-history tracking | Semantic search (fuzzy) |
| Speed | Indexed, instant | Searches full conversations |
| File mapping | Knows exactly which sessions edited which files | Guesses from content |
| Git dependency | None | None |
| Project scope | Per-project | Cross-project |

## Technical Details

Uses `~/.claude/commands/claude-history.py` which:
1. Scans `~/.claude/file-history/` to build file→session index
2. Cross-references with `~/.claude/projects/` for session metadata
3. Reads and synthesizes conversation content
4. Returns structured context with full session IDs

Files: 1

Size: 2.4 KB

Complexity: 7/100

Category: Data & Analytics

Source: https://github.com/gentritbiba/history-context/tree/main/skills/file-history

Related in Data & Analytics

clawarr-suite

Included

Comprehensive management for self-hosted media stacks (Sonarr, Radarr, Lidarr, Readarr, Prowlarr, Bazarr, Overseerr, Plex, Tautulli, SABnzbd, Recyclarr, Unpackerr, Notifiarr, Maintainerr, Kometa, FlareSolverr). Deep library exploration, analytics, dashboard generation, content management, request handling, subtitle management, indexer control, download monitoring, quality profile sync, library cleanup automation, notification routing, collection/overlay management, and media tracker integration (Trakt, Letterboxd, Simkl).

Data & Analyticsscripts

querying-soql

Included

SOQL query generation, optimization, and analysis with 100-point scoring. Use this skill when the user needs SOQL/SOSL authoring or optimization: natural-language-to-query generation, relationship queries, aggregates, query-plan analysis, and performance or safety improvements for Salesforce queries. TRIGGER when: user writes, optimizes, or debugs SOQL/SOSL queries, touches .soql files, or asks about relationship queries, aggregates, or query performance. DO NOT TRIGGER when: bulk data operations (use handling-sf-data), Apex DML logic (use generating-apex), or report/dashboard queries.

Data & Analyticsscripts

app-store-optimization

Included

App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store. Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android. Supports keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklists, and tracking ranking changes.

Data & Analyticsscripts

habit-flow

Included

AI-powered atomic habit tracker with natural language logging, streak tracking, smart reminders, and coaching. Use for creating habits, logging completions naturally ("I meditated today"), viewing progress, and getting personalized coaching.

Data & Analyticsscripts

app-store-optimization

Included

Data & Analyticsscripts

visualizing-data

Included

Builds dashboards, reports, and data-driven interfaces requiring charts, graphs, or visual analytics. Provides systematic framework for selecting appropriate visualizations based on data characteristics and analytical purpose. Includes 24+ visualization types organized by purpose (trends, comparisons, distributions, relationships, flows, hierarchies, geospatial), accessibility patterns (WCAG 2.1 AA compliance), colorblind-safe palettes, and performance optimization strategies. Use when creating visualizations, choosing chart types, displaying data graphically, or designing data interfaces.

Data & Analyticsscripts