AIRGAP StudioAIRGAP Studio

Git Checkpoints

Troubleshooting Git installation and checkpoint features

What Are Checkpoints?

AIRGAP Assistant automatically creates Git checkpoints whenever AI modifies files. This feature lets you revert to a previous state at any time, making AI-powered code modifications safe and worry-free.

The checkpoint feature requires Git to be installed on your system.

Installing Git

Installation in Air-Gapped Environments (Portable Git)

In network-restricted environments, use Portable Git.

  1. Prepare a pre-downloaded PortableGit-x.xx.x-64-bit.7z.exe file.
  2. Extract it to your preferred location (e.g., C:\PortableGit).
  3. Add the Git path to your system PATH.
# Add Git to system PATH (requires administrator privileges)
[Environment]::SetEnvironmentVariable(
  "PATH",
  "$env:PATH;C:\PortableGit\bin",
  "User"
)
  1. Restart AIRGAP Studio.

Verifying Installation

git --version

If a version number is displayed, Git is installed correctly.

Checkpoint Configuration

Initial Git Setup

When using Git for the first time, you need to configure your user information.

git config --global user.name "Your Name"
git config --global user.email "user@example.com"

Initializing Git in a Project

The checkpoint feature only works in Git repositories. Initialize Git in your project folder.

cd C:\your-project
git init
git add .
git commit -m "initial commit"

Common Issues

"Git is not installed"

CheckAction
Git installationRun git --version
PATH configurationVerify that the Git executable path is included in PATH
Restart IDERestart AIRGAP Studio after modifying PATH

Checkpoints Are Not Being Created

  1. Verify that the current folder is a Git repository.
git status

If you see the message fatal: not a git repository, initialize with git init.

  1. Check whether your .gitignore file is excluding the files being modified.

Restoring from a Checkpoint

In the AIRGAP Assistant conversation history, find the checkpoint marker and click the Restore button to revert to that point in time.

To restore manually, use Git commands in the terminal.

# Undo recent changes (uncommitted changes)
git checkout -- .

# Revert to a specific commit
git log --oneline
git checkout <commit-hash>

Git Authentication Errors

Checkpoints are local Git operations, so remote repository authentication is not required. If you encounter authentication errors, check whether you are attempting remote operations such as git push.