GhostCommit is an offline-first, browser-local dashboard designed to programmatically schedule and manage dynamic activity logs pushing to a target GitHub repository. It acts as a visual interface for generating and automatically deploying realistic, scattered commit workflows powered by GitHub Actions.
With zero server-side storage, GhostCommit ensures full data privacy: your Personal Access Token (PAT) and repository details are kept exclusively in your browser's local storage.
- Offline-First & Local-Only: Credentials are saved strictly within browser
localStorage. No keys are sent to third-party database servers. - Realistic Scattering (0–90m Delay): Commits do not fire exactly on the hour. The workflow automatically introduces an active, randomized delay of up to 90 minutes inside the runner, mimicking organic human activity.
- Custom Active Hours Window: Define precisely what hours of the day (e.g., 9:00 AM - 11:00 PM) you want commits to occur, matching your typical waking/work schedules.
- Automatic Multi-Slot Cron Calculation: Generates multiple optimized daily Cron trigger schedules dynamically distributed across your active window.
- Dynamic Heatmap Preview: Live visualization of your target repository's current contribution graph and recent commit logs using the official GitHub REST API.
- Seamless Automation: Generate and push the
.github/workflows/auto-commit.ymlfile directly into your repository with one click.
Follow these steps to set up GhostCommit and activate your auto-commit engine:
- Go to your GitHub Personal Access Tokens Settings.
- Click Generate new token (classic).
- Name it (e.g.,
GhostCommit Token) and check thereposcope (required to allow pushing workflow modifications and commits). - Copy the generated token immediately and save it somewhere secure.
For the GitHub Actions scheduler to push commits back to your repository, you must add your Personal Access Token as an encrypted secret:
- Open your target GitHub repository in a browser.
- Navigate to Settings > Secrets and variables > Actions.
- Click New repository secret.
- Set Name to:
AUTO_COMMIT_PAT - Paste your Personal Access Token (from Step 1) as the Value.
- Click Add secret.
If you want to run the GhostCommit dashboard interface on your local machine:
-
Clone the repository:
git clone https://github.com/your-username/ghostcommit.git cd ghostcommit -
Install the dependencies:
npm install
-
Start the development server:
npm run dev
-
Access the application: Open http://localhost:3000 in your web browser.
Once the dashboard is open:
- Enter your PAT: Paste the Personal Access Token you created.
- Enter your Repository: Input your target repo name (e.g.,
username/repository-name). - Choose Commits per Day: Select how many daily commits you would like the scheduler to create.
- Set Timezone & Active Window: Choose Local/UTC timezone and customize the start/end hours.
- Generate & Deploy: Click Generate & Deploy Workflow to push the automated workflow file directly to
.github/workflows/auto-commit.ymlin your target repository.
- Framework: Next.js 15+ (App Router, React 19)
- Styling: Tailwind CSS v4 (configured with professional GitHub Dark Mode styles)
- Animations: Motion (formerly Framer Motion)
- Icons: Lucide React
- Hosting Compatibility: Fully compatible with Cloud Run, Vercel, static exports, or standard Node containers.
├── app/
│ ├── globals.css # Custom Tailwind imports
│ ├── layout.tsx # Root layout configuration with Inter & JetBrains Mono
│ └── page.tsx # Dashboard engine containing configuration form, heatmap, and workflow generator
├── lib/
│ └── utils.ts # Tailwind merger utilities
├── package.json # Package manifest & run scripts
├── tsconfig.json # TypeScript configuration
└── tailwind.config.ts # Tailwind configuration
This project is open-source. Feel free to fork, customize, and extend its behavior to suit your developer habits!