Skip to main content

Respect your time boundaries in git workflows

Project description

gitlater

Respect your time boundaries in git workflows.

What is this?

gitlater is a small CLI tool that helps you commit at the right time.

It doesn’t optimize productivity. It protects your boundaries.

Why?

Sometimes the problem is not:

  • writing code
  • committing code

But when you do it.

gitlater helps you say:

“This is the time I work on this project. Not now.”

Features

  • simple time-based commit guard
  • two modes:
    • personal → allow outside working hours
    • work → allow during working hours
  • weekend & holiday awareness
  • project-level configuration
  • zero external dependencies

Installation

Using pipx (recommended)

pipx install gitlater

Using uv

uv tool install gitlater

Local development

uv sync
uv run gitlater status

Setup

Initialize in your project:

gitlater init

This creates:

.gitlater/
  config.toml
  holidays.txt

Configuration

.gitlater/config.toml

mode = "personal"

[work_hours]
start = 9
end = 18

.gitlater/holidays.txt

2026-01-01 # New Year
2026-08-17 # Independence Day

Pre-commit integration

Add to your local pre-commit config:

- repo: local
  hooks:
    - id: gitlater
      name: git later
      entry: gitlater check
      language: system
      stages: [pre-commit]
      pass_filenames: false

pass_filenames: false ensures the check runs once (not per file).

Usage

gitlater status

Example:

🌙 Not now — this time is yours.

🗓 Friday • 10:08
⏳ Next window: 18:00

Philosophy

gitlater is intentionally simple.

  • no remote API
  • no auto-detection
  • no global config

It doesn’t decide your schedule.

Roadmap

Keep it boring.

Future improvements (if needed):

  • better status output
  • small UX refinements
  • optional helpers (init, holidays)

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gitlater-0.1.3.tar.gz (33.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gitlater-0.1.3-py3-none-any.whl (6.6 kB view details)

Uploaded Python 3

File details

Details for the file gitlater-0.1.3.tar.gz.

File metadata

  • Download URL: gitlater-0.1.3.tar.gz
  • Upload date:
  • Size: 33.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.4.30

File hashes

Hashes for gitlater-0.1.3.tar.gz
Algorithm Hash digest
SHA256 77cb015f73d0e1c60c535e31669b6e5797789675d119fc9ae98e98abe401bc6c
MD5 3f38c57a6c41ee247e4a7fe4a0f08ca6
BLAKE2b-256 6a9fd16528e7880a5a9250f6e1b623c54852bb6d0c0e82682ea666d43b33fa7a

See more details on using hashes here.

File details

Details for the file gitlater-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: gitlater-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 6.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.4.30

File hashes

Hashes for gitlater-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 c455e47747f3026fb9fe1b927312bb9ffdb812c79a94325e12684f3f0b167089
MD5 02cc0bbaf013cd19938360e8856e28f3
BLAKE2b-256 e414ef957770d0c6f5ca367f8d379a2cd01b5816b29b768e3efa61470e31bb31

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page