> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shadowgit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Give your AI perfect memory of your code changes

## What is ShadowGit?

ShadowGit saves every keystroke you type and feeds your complete code history to AI assistants like Claude and Cursor via MCP (Model Context Protocol).

Your AI stops guessing. It knows exactly what worked before.

<Card title="Quick Installation" icon="rocket" href="/installation" horizontal>
  Get up and running in 2 minutes with our MCP server.
</Card>

## How it works

ShadowGit runs quietly in the background, creating a parallel git repository (`.shadowgit.git`) that captures every save as a commit. The MCP server then gives your AI read-only access to this detailed history.

**New: AI Session Management** - ShadowGit automatically detects when you're working with AI tools and tracks your coding sessions, giving your AI assistant better context about your development patterns and recent changes.

```
your-project/
├── .git/              # Your normal git repo
├── .shadowgit.git/    # Automatic snapshot history (AI reads this)
├── src/
└── ...
```

## Why ShadowGit exists

<Columns cols={3}>
  <Card title="Fewer debug attempts" icon="clock">
    AI finds issues using history, not guessing. Fewer attempts to fix bugs.
  </Card>

  <Card title="Git commands not context dumps" icon="crosshairs">
    AI runs git diff instead of reading entire files. Saves thousands of tokens.
  </Card>

  <Card title="Zero lost code" icon="brain">
    Every change saved automatically. One-click restore from any moment.
  </Card>
</Columns>

## Real-world impact

* **Before**: Spend 15 minutes re-explaining your codebase to Claude
* **After**: Claude fixes the bug in 5 minutes using your code history

That's not marketing. That's math.

## Get started

<Columns cols={2}>
  <Card title="Install MCP Server" icon="download" href="/installation">
    Set up the MCP server for Claude and Cursor in 2 minutes.
  </Card>

  <Card title="Claude Code Setup" icon="asterisk" href="/ai-tools/claude-code">
    Configure Claude Code to use ShadowGit.
  </Card>

  <Card title="Cursor Setup" icon="code-simple" href="/ai-tools/cursor">
    Add ShadowGit to Cursor for perfect AI memory.
  </Card>

  <Card title="GitHub Repository" icon="github" href="https://github.com/blade47/shadowgit-mcp">
    View source, report issues, or contribute to the MCP server.
  </Card>

  <Card title="Download ShadowGit" icon="desktop" href="https://shadowgit.com">
    Get the desktop app that captures your code changes.
  </Card>
</Columns>

## Security & Privacy

* **100% local**: Your code never leaves your machine
* **Read-only access**: AI can only read, never modify
* **No cloud uploads**: Everything stays on your computer

## Requirements

* Node.js 18 or higher
* ShadowGit desktop app (Mac, Windows, or Linux)
* An AI tool (Claude Code, Cursor, etc.)