Git AI Search Skill

Search and restore AI conversation context from git history using

git-ai search

and

git-ai continue

Overview

Git AI tracks AI-generated code and the conversations that produced it. This skill helps you:

Search - Find AI prompt sessions by commit, file, pattern, or author
Continue - Restore AI session context to continue work where someone left off
Show - View the full transcript of a specific prompt

When to Use Each Command

You want to...	Use...
See what AI context exists for a commit	`git-ai search --commit <sha>`
See AI context for specific lines	`git-ai search --file <path> --lines <range>`
Read the full AI conversation	`git-ai search --commit <sha> --verbose`
Get machine-readable output	`git-ai search --json`
Find prompts mentioning a topic	`git-ai search --pattern "keyword"`
Continue someone's AI session	`git-ai continue --commit <sha>`
Continue working on a code region	`git-ai continue --file <path> --lines <range>`
Launch Claude with restored context	`git-ai continue --commit <sha> --launch`
View a specific prompt transcript	`git-ai show-prompt <id>`

Workflow Patterns

1. Investigate a Commit

Understand what AI assistance was used in a specific commit:

bash

# See a summary of AI sessions in the commit
git-ai search --commit abc1234

# View the full conversations
git-ai search --commit abc1234 --verbose

# Get JSON for programmatic processing
git-ai search --commit abc1234 --json | jq '.prompts | keys[]'

2. Understand a Code Region

Find what AI sessions contributed to specific lines:

bash

# Search by file
git-ai search --file src/main.rs

# Search specific lines
git-ai search --file src/main.rs --lines 100-150

# Multiple line ranges
git-ai search --file src/main.rs --lines 50-75 --lines 200-250

3. Continue Someone's Work

Pick up where a teammate left off:

bash

# See what they were working on
git-ai search --commit abc1234 --verbose

# Restore context and continue in your shell
git-ai continue --commit abc1234

# Or launch directly into Claude Code
git-ai continue --commit abc1234 --launch

# Or copy context to clipboard to paste elsewhere
git-ai continue --commit abc1234 --clipboard

4. Review a Pull Request

Understand AI involvement in a PR:

bash

# Get all commits in the PR
COMMITS=$(gh pr view 123 --json commits -q '.commits[].oid')

# Search each commit
for sha in $COMMITS; do
  echo "=== $sha ==="
  git-ai search --commit $sha
done

# Or search the full range
BASE=$(gh pr view 123 --json baseRefOid -q '.baseRefOid')
HEAD=$(gh pr view 123 --json headRefOid -q '.headRefOid')
git-ai search --commit $BASE..$HEAD

5. Audit AI Involvement in a File

See all AI sessions that touched a file:

bash

# Full file history
git-ai search --file src/auth/login.rs

# Filter by author
git-ai search --file src/auth/login.rs --author "Alice"

# Filter by tool
git-ai search --file src/auth/login.rs --tool claude

6. Search by Topic

Find prompts discussing specific topics:

bash

# Search prompt content
git-ai search --pattern "authentication"
git-ai search --pattern "error handling"

# Combine with filters
git-ai search --pattern "refactor" --tool cursor

7. Pipe to Other Tools

Integrate with scripts and workflows:

bash

# Get prompt IDs only
git-ai search --commit abc1234 --porcelain

# Count matches
git-ai search --file src/main.rs --count

# JSON for processing
git-ai search --commit abc1234 --json | jq '.prompts[] | {tool, model, author: .human_author}'

# Find commits with AI-authored code
git log --oneline | while read sha msg; do
  count=$(git-ai search --commit $sha --count 2>/dev/null || echo "0")
  if [ "$count" != "0" ]; then
    echo "$sha ($count sessions): $msg"
  fi
done

Command Reference

git-ai search

Search for AI prompt sessions by various criteria.

git-ai search [OPTIONS]

Context Source (pick one):

```
--commit <rev>
```
- Search a specific commit (or range with
```
sha1..sha2
```
)
```
--file <path>
```
- Search by file path
```
--lines <range>
```
- Filter to line range (requires --file, repeatable)
```
--pattern <text>
```
- Full-text search in prompt content
```
--prompt-id <id>
```
- Look up specific prompt by ID

Filters (combinable):

```
--author <name>
```
- Filter by human author (substring match)
```
--tool <name>
```
- Filter by tool (claude, cursor, etc.)
```
--since <date>
```
- Only prompts after date
```
--until <date>
```
- Only prompts before date

Output Format (pick one):

(default) - Human-readable summary
```
--json
```
- Full JSON output
```
--verbose
```
- Detailed output with full transcripts
```
--porcelain
```
- Machine-readable prompt IDs only
```
--count
```
- Just the count of matching prompts

git-ai continue

Restore AI session context for continuation.

git-ai continue [OPTIONS]

Context Source (pick one, or none for TUI):

```
--commit <rev>
```
- Continue from a commit
```
--file <path>
```
- Continue from a file
```
--lines <range>
```
- Limit to line range (with --file)
```
--prompt-id <id>
```
- Continue specific prompt

Agent Selection:

```
--agent <name>
```
- Target agent (claude, cursor; default: claude)
```
--tool <name>
```
- Alias for --agent

Output Mode (pick one):

(default) - Print formatted context to stdout
```
--launch
```
- Spawn agent CLI with context
```
--clipboard
```
- Copy context to clipboard
```
--json
```
- Output as structured JSON

Options:

```
--max-messages <n>
```
- Limit messages per prompt (default: 50)

git-ai show-prompt

Display the full transcript of a specific prompt.

git-ai show-prompt <prompt_id> [OPTIONS]

```
--json
```
- Output as JSON
```
--raw
```
- Show raw internal format

Output Formats

Default Output

Human-readable summary:

Found 2 AI prompt session(s) for commit abc1234

[1] Prompt a1b2c3d4 (claude / claude-sonnet-4)
    Author: Alice
    Files: src/main.rs:10-50

[2] Prompt e5f6g7h8 (cursor / gpt-4)
    Author: Bob
    Files: src/lib.rs:100-150, src/utils.rs:20-30

--json Output

Full structured data for programmatic use:

json

{
  "source": {
    "sha": "abc1234",
    "author": "Alice",
    "date": "2025-01-15",
    "message": "Add authentication"
  },
  "prompts": [
    {
      "id": "a1b2c3d4",
      "tool": "claude",
      "model": "claude-sonnet-4",
      "author": "Alice",
      "messages": [...]
    }
  ]
}

--verbose Output

Full conversations inline:

=== Session 1: Prompt a1b2c3d4 ===
Tool: claude (claude-sonnet-4)
Author: Alice

**User**:
Help me implement user authentication...

**Assistant**:
I'll help you implement authentication. Here's my approach...

--porcelain Output

One prompt ID per line (for scripting):

a1b2c3d4
e5f6g7h8

--count Output

Just the number:

Tips

Combining Filters

Filters use AND semantics - prompts must match ALL specified filters:

bash

# Claude prompts by Alice in the last 7 days
git-ai search --commit HEAD~10..HEAD --tool claude --author "Alice" --since 7d

Using with Git Commands

Combine with git log to explore history:

bash

# Find commits with high AI involvement
git log --oneline --since="1 week ago" | while read sha msg; do
  git-ai search --commit $sha --count 2>/dev/null
done

# Search AI context for files changed in a commit
git diff-tree --no-commit-id --name-only -r abc1234 | while read file; do
  git-ai search --file "$file"
done

Restoring Context for Different Agents

The

--agent

flag controls context formatting:

bash

# For Claude Code
git-ai continue --commit abc1234 --agent claude --launch

# For other tools, copy to clipboard
git-ai continue --commit abc1234 --clipboard

Inspecting Specific Prompts

If search returns many results, drill down:

bash

# Get the IDs
git-ai search --commit abc1234 --porcelain

# View a specific one
git-ai show-prompt a1b2c3d4

Performance Tips

Use
```
--commit
```
for fastest results (direct note lookup)
```
--file
```
requires blame computation (slower for large files)
```
--pattern
```
searches the database (fast substring match)
Add
```
--count
```
first to check result size before verbose output

Examples

Quick checks

bash

# Any AI in this commit?
git-ai search --commit HEAD --count

# What tools were used?
git-ai search --commit abc1234 --json | jq '.prompts[].tool' | sort -u

# Who used AI in this file?
git-ai search --file src/main.rs --json | jq '.prompts[].author' | sort -u

Detailed exploration

bash

# Full context of the most recent AI session
git-ai search --commit HEAD --verbose | head -100

# Continue the exact session that wrote these lines
git-ai continue --file src/main.rs --lines 50-100 --launch

Integration with CI/CD

bash

# In a PR check, report AI involvement
PROMPT_COUNT=$(git-ai search --commit $PR_HEAD --count 2>/dev/null || echo "0")
if [ "$PROMPT_COUNT" -gt 0 ]; then
  echo "This PR includes $PROMPT_COUNT AI-assisted session(s)"
  git-ai search --commit $PR_HEAD
fi

git-ai-search

NPX Install

Tags

SKILL.md Content

Git AI Search Skill

Overview

When to Use Each Command

Workflow Patterns

1. Investigate a Commit

2. Understand a Code Region

3. Continue Someone's Work

4. Review a Pull Request

5. Audit AI Involvement in a File

6. Search by Topic

7. Pipe to Other Tools

Command Reference

git-ai search

git-ai continue

git-ai show-prompt

Output Formats

Default Output

--json Output

--verbose Output

--porcelain Output

--count Output

Tips

Combining Filters

Using with Git Commands

Restoring Context for Different Agents

Inspecting Specific Prompts

Performance Tips

Examples

Quick checks

Detailed exploration

Integration with CI/CD