local-version-control

Create daily local git snapshots with safety checks and human diff review.

88|108|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/grandamenium/cortextos --skill local-version-control-grandamenium
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: local-version-control
Source: https://github.com/grandamenium/cortextos/tree/main/templates/analyst/.claude/skills/local-version-control
Command: npx skills add https://github.com/grandamenium/cortextos --skill local-version-control-grandamenium

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Local Version Control prevents risky or accidental commits by creating daily, reviewable git snapshots of agent workspace changes with built-in safety checks and a diff review step.

Core Features & Use Cases

  • Automated daily snapshots: Creates staged commits of workspace changes on a schedule without pushing anything to remote.
  • Safety guardrails before committing: Blocks committing sensitive credential files and overly large/binary/temp artifacts, while respecting .gitignore.
  • PII and secrets diff review: Prompts a required manual inspection of the staged diff for PII and secrets before the commit is finalized.
  • Use Case: After an overnight agent run, you can generate a clear commit that captures what changed while ensuring nothing sensitive (like tokens or .env contents) gets recorded.

Quick Start

Run the skill’s auto-commit via cortextos bus auto-commit, then inspect git diff --cached and commit only after confirming no secrets or PII are included.

Frequently Asked Questions about local-version-control

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create local git snapshots of agent workspace changes without auto-pushing?

Local git snapshots of agent workspace changes are created by staging files and committing locally without pushing. The skill blocks sensitive files like .env and large binaries, then requires a manual diff review to detect PII or secrets before finalizing the commit.

How does PII detection and secrets safety work before committing staged changes?

PII detection and secrets safety work by prompting a required manual inspection of the staged git diff before committing. This review step ensures sensitive information like tokens or credential file contents are not recorded in the local snapshot.

Can I use scheduled cron snapshots to track overnight agent operations?

Scheduled cron snapshots can be used to track overnight agent operations. This skill applies to routine agent operation cycles by creating automated daily commits that capture workspace changes while respecting .gitignore and blocking credential files.

What is the best way to prepare for pre-destructive operations using version control?

The best way to prepare for pre-destructive operations using version control is to create a reviewable local commit of the current workspace state. This stages changes while blocking large temp artifacts and requires a diff review to ensure no secrets are committed.

Does this local version control approach respect .gitignore and block large binaries?

This local version control approach respects .gitignore and blocks large binaries or temp artifacts during the staging process. It specifically prevents risky commits by filtering out sensitive credential files and overly large binary data before the manual diff review.

Why does local version control forbid pushing commits automatically to remote?

Local version control forbids pushing commits automatically to remote to ensure human review of staged changes for sensitive information. This safety guardrail prevents accidental exposure of PII or secrets by requiring manual confirmation before any remote synchronization.