Claude Code

Prerequisites

Claude Code installed (Get Claude Code)
Node.js 18+ installed
ShadowGit desktop app running with tracked repositories

Quick Setup

Install and configure ShadowGit in one command:

# Install MCP server globally
npm install -g shadowgit-mcp-server

# Add to Claude Code
claude mcp add shadowgit -- shadowgit-mcp-server

# Restart Claude Code

That’s it. Claude now has perfect memory of your code changes.

Verify Installation

Ask Claude:

Can you list my ShadowGit repositories?

Claude should respond with your tracked repositories. If not, see troubleshooting below.

What Claude can now do

AI Session Awareness

ShadowGit now tracks your active coding sessions with Claude, automatically detecting when you’re working together and preserving context across your development flow. This means Claude understands not just your code history, but also your current coding patterns and recent focus areas.

Debug recent changes

Claude, what changed in my auth.ts file in the last hour?

Find when bugs appeared

Claude, when did the login function last work correctly?

Understand code evolution

Claude, show me how the payment processing evolved this week

Compare implementations

Claude, what approach worked better - yesterday's or today's refactor?

Example Commands

Ask Claude in natural language and it will use the right git commands: See recent commits:

"Show me the last 20 commits in my-app"
"What did I commit today?"

Check what broke:

"What changed between now and 10 commits ago?"
"Show me the diff for the last hour"

Find who changed a line:

"Who last modified src/api.ts?"
"Show me the blame for the authentication file"

See file history:

"Show me the history of Header.tsx"
"What changes were made to the login component?"

Session Management

Control how ShadowGit tracks your work with Claude: Start a session:

"Start a ShadowGit session for this debugging task"

Create checkpoints:

"Create a ShadowGit checkpoint: Fixed authentication bug"

End a session:

"End the current ShadowGit session"

Advanced Usage

Working with multiple repositories

Claude can analyze across all your projects:

Claude, check if I've solved similar authentication issues in my other projects

Time-based debugging

Claude, what was I working on yesterday between 2-4 PM?

Pattern detection

Claude, do you see any patterns in when my tests fail?

Troubleshooting

Claude doesn’t see ShadowGit

Restart Claude Code after adding the MCP server

Check installation:

# Verify MCP server is installed
npm list -g shadowgit-mcp-server

# Test it works
shadowgit-mcp-server --version

“No repositories found”

Open ShadowGit desktop app
Add at least one repository
Wait for first snapshot (usually within 3 minutes)
Ask Claude again

Permission errors

On macOS, you might need to grant Terminal permissions:

System Preferences → Security & Privacy
Privacy tab → Full Disk Access
Add Terminal or your terminal app

Claude can’t execute git commands

Make sure git is installed:

git --version

If not installed, download Git.

Best Practices

1. Let ShadowGit run for a while

The more history ShadowGit captures, the smarter Claude becomes. Let it run for at least a day before expecting deep insights.

2. Be specific with time ranges

Instead of “recent changes”, say “changes in the last 2 hours” or “changes from yesterday”.

3. Use repository names

Always specify which repository when you have multiple:

Claude, in my 'frontend' repo, what changed in the last hour?

4. Combine with file context

Claude Code already reads your files. ShadowGit adds the history dimension:

Claude, looking at this error and my recent changes, what broke?

Security

Read-only: Claude can only read history, never modify code
Local only: No code leaves your machine
Safe commands: Only non-destructive git commands allowed

Next Steps

Installation Guide

General installation instructions

Cursor Setup

Configure Cursor with ShadowGit

Getting started

AI tools

Prerequisites

Quick Setup

Verify Installation

What Claude can now do

AI Session Awareness

Debug recent changes

Find when bugs appeared

Understand code evolution

Compare implementations

Example Commands

Session Management

Advanced Usage

Working with multiple repositories

Time-based debugging

Pattern detection

Troubleshooting

Claude doesn’t see ShadowGit

“No repositories found”

Permission errors

Claude can’t execute git commands

Best Practices

1. Let ShadowGit run for a while

2. Be specific with time ranges

3. Use repository names

4. Combine with file context

Security

Next Steps

Installation Guide

Cursor Setup

​Prerequisites

​Quick Setup

​Verify Installation

​What Claude can now do

​AI Session Awareness

​Debug recent changes

​Find when bugs appeared

​Understand code evolution

​Compare implementations

​Example Commands

​Session Management

​Advanced Usage

​Working with multiple repositories

​Time-based debugging

​Pattern detection

​Troubleshooting

​Claude doesn’t see ShadowGit

​“No repositories found”

​Permission errors

​Claude can’t execute git commands

​Best Practices

​1. Let ShadowGit run for a while

​2. Be specific with time ranges

​3. Use repository names

​4. Combine with file context

​Security

​Next Steps

Installation Guide

Cursor Setup

Prerequisites

Quick Setup

Verify Installation

What Claude can now do

AI Session Awareness

Debug recent changes

Find when bugs appeared

Understand code evolution

Compare implementations

Example Commands

Session Management

Advanced Usage

Working with multiple repositories

Time-based debugging

Pattern detection

Troubleshooting

Claude doesn’t see ShadowGit

“No repositories found”

Permission errors

Claude can’t execute git commands

Best Practices

1. Let ShadowGit run for a while

2. Be specific with time ranges

3. Use repository names

4. Combine with file context

Security

Next Steps