GitChrono

Time-aware Git Exporter

Ship the right files. Anytime. Any branch.

Export changed files from any Git branch by precise date and time range — built for shipping, handover, audits, and code review.
Works in VS Code, Cursor, Windsurf, Codium, and Antigravity.

Why GitChrono?

Manual exports from Git history are slow, brittle, and error-prone. Whether you ship to a partner, archive a daily delta, or hand off only impacted files for review — you need a workflow that's fast, repeatable, and safe.

GitChrono turns this into a few clicks:

1. Pick a branch.
2. Pick a date/time window.
3. Preview changed files.
4. Export to any folder, with structure preserved.

The extension icon you see at the top of the Marketplace listing — emerald clock with a Git branch graph — is GitChrono's identity. It sits next to the extension name in the editor sidebar too.

Features

• Time-precise filtering — date + 24-hour time, down to the minute.
• Branch-aware — local and remote branches detected automatically; current HEAD preselected.
• Quick presets — Today, Yesterday, Last 7 days, This month.
• Live preview & filter — see every file before exporting; filter by extension or path.
• Folder structure preserved — destination mirrors your repo layout.
• Status bar action — one click to reopen the last export folder.
• Keyboard shortcuts
  • Ctrl/⌘ + Alt + G — open dashboard
  • Ctrl/⌘ + Alt + T — quick export today
• Repeat last export — re-run the same window with one command.
• Configurable — default branch, default folder, file limit, merge handling.

Security & Privacy

GitChrono is built with safety as a first-class concern:

• No shell execution. Every Git call uses execFile with argument arrays — immune to shell injection.
• Strict input validation. Branches, dates, and times are checked against strict regex before reaching Git.
• Path traversal protection. File paths from Git are normalized and verified to stay within the workspace.
• Webview hardening. Strict Content-Security-Policy with a per-load nonce, no remote scripts, no third-party iframes.
• No telemetry. GitChrono never phones home. The only outbound network call is when you click the Ko-fi sponsor button, which opens externally in your browser.
• Safety limit. A configurable maximum file count prevents runaway exports.

How to Use

Open the dashboard

• Command Palette → GitChrono: Open Dashboard
• Shortcut → Ctrl + Alt + G (Windows / Linux) · ⌘ + Alt + G (macOS)
• Source Control title bar → click the GitChrono icon

Workflow

1. Choose a branch from the dropdown (current HEAD is preselected).
2. Pick a time window with the date pickers, or tap a preset chip.
3. Choose an export destination with Browse….
4. Click Preview Changes — review the file list, filter if needed.
5. Click Export Files Now — track progress, then jump to the folder from the status bar.

Quick exports (no dashboard needed)

• GitChrono: Quick Export — Today (Ctrl + Alt + T)
• GitChrono: Quick Export — Yesterday
• GitChrono: Repeat Last Export

Configuration

Open Settings → search gitchrono to customise:

Compatibility

GitChrono targets the standard VS Code Extension API and works across editors that implement it:

Requirements

• A folder open in your editor that is a Git repository.
• git available on your system PATH.

Support the project

If GitChrono saves you time, consider buying me a coffee on Ko-fi. Your support keeps this extension actively maintained and free for everyone.

Release notes

See CHANGELOG.md for the full history.

License

MIT © DalinXS