secretside 0.3.0

Shift git commit timestamps out of work hours so your side project stays secret

secretside

Shift git commit timestamps out of work hours so your side project stays secret.

If you committed at 10:47 on a Wednesday, secretside moves it to 17:47 (or later). It also catches identity leaks — commits made with your real name or work email when you meant to use a pseudonym.

Install

pip install secretside

Or with uv:

uv tool install secretside

Note: libgit2 1.9 headers are required.

Quick start

secretside init
secretside clean --dry-run
secretside check # quick validate for use in a git hook

Commands

secretside init [repo] [--country XX] [--force] — Generate secretside.toml with jittered defaults so every project's config looks slightly different.

secretside clean [repo] [--dry-run] — Preview and apply timestamp shifts. Only touches your most recent contiguous commits. With local_only = true in your config (the default), only unpushed commits are considered/modified.

secretside inspect [repo] — Show commit time distribution and list all work-hour commits.

secretside check [repo] — Validate that no commits fall in work hours and no banned identities appear. Designed for CI or pre-push hooks.

Config

secretside init creates a secretside.toml in your repo:

holidays = "CA"
work_days = "mon-fri"
work_hours = "08:47..17:52"
night_hours = "23:12..05:44"
local_only = true
banned = [
    # ["Your Real Name", "[e-mail]"],
    # ["Your Real Name", "[e-mail]"],
]
pto = [
    # "2025-02-07",
    # "2025-12-24..2025-12-31",
]

Key	Description
holidays	Country code for public holidays ("CA", "US", "GB", etc.)
work_days	Which days are work days ("mon-fri", "mon-thu", "mon-wed,fri")
work_hours	Commits in this range on work days get shifted past work_end
night_hours	Shifted commits avoid landing here (organic night commits are left alone)
local_only	Only shift commits that haven't been pushed to any remote
banned	Name/email pairs to flag in check — keep your real identity out of the repo
pto	Dates (or start..end ranges) to treat as days off

How it works

• Only the contiguous tail of your commits is touched — other people's commits are never modified
• Weekend, holiday, and PTO commits are left alone — already safe - unless they need shifting due to overflow from a work day
• Organic night commits (you actually coded at 1am) stay put
• Chronological order is always preserved, with original time gaps maintained where possible
• History rewriting uses git-filter-repo under the hood

Development

Requires Python 3.11+ and uv.

uv sync
bin/test
uv run secretside <command>